switch_heading

Documentación Seedance 1.5 API

Guía completa para integrar la API de generación de video Seedance 1.5 en tus aplicaciones.

API v1 · 1.5 Base URL: https://seedanceapi.org/v1

Inicio Rápido

bash

1	curl -X POST 'https://seedanceapi.org/v1/generate' \
2	-H 'Authorization: Bearer YOUR_API_KEY' \
3	-H 'Content-Type: application/json' \
4	-d '{
5	"prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "8"
9	}'

Autenticación

Todas las solicitudes de la API requieren autenticación usando un token Bearer en el encabezado Authorization.

Importante: Puedes obtener tu clave API desde la página API Keys en tu panel. → Obtener clave API

http

1	Authorization: Bearer YOUR_API_KEY

Precios

480p

480p Resolución

Generación rápida, adecuada para previsualizaciones y borradores

Duración	Sin audio	Con audio
4s	8 credits	14 credits
8s	14 credits	28 credits
12s	19 credits	38 credits

720p

720p Resolución

Salida de alta calidad, recomendada para producción

Duración	Sin audio	Con audio
4s	14 credits	28 credits
8s	28 credits	56 credits
12s	42 credits	84 credits

Endpoints de la API

POST/v1/generateGenerar nuevo video

Crear nueva tarea de generación de video con el modelo Seedance 1.5. Soporta texto-a-video e imagen-a-video.

Cuerpo de la Solicitud

Body ParametersJSON

prompt:string

Descripción textual del video a generar (máx. 2000 caracteres)

aspect_ratio:optional string

Relación de aspecto de salida. Soportadas: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.

resolution:optional string

Resolución del video: 480p o 720p Defaults to 720p.

duration:optional string

Duración del video en segundos: 4, 8 o 12 Defaults to 8.

generate_audio:optional boolean

Habilitar generación de audio IA para el video Defaults to false.

fixed_lens:optional boolean

Fijar la cámara para reducir el desenfoque de movimiento Defaults to false.

image_urls:optional string[]

Array de URLs de imágenes de referencia para imagen-a-video (máx. 1)

callback_url:optional string

URL webhook para notificaciones de estado asíncronas. Debe ser accesible públicamente.

Texto a video

json

1	{
2	"prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8"
6	}

Imagen a video

json

1	{
2	"prompt": "The character slowly turns and smiles at the camera",
3	"image_urls": [
4	"https://example.com/my-image.jpg"
5	],
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "4"
9	}

Con generación de audio

json

1	{
2	"prompt": "A peaceful river flowing through a forest with birds singing",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8",
6	"generate_audio": true,
7	"fixed_lens": true
8	}

Respuestas

Task created successfully

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "IN_PROGRESS"
7	}
8	}

GET/v1/statusObtener estado de la tarea

Verificar el estado de una tarea de generación de video y obtener el resultado cuando esté completada.

Parámetros de Consulta

Body ParametersJSON

task_id:string

El ID único de tarea devuelto del endpoint generate

Ejemplo de Solicitud

bash

1	curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
2	-H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: El campo response en la API de estado es un array de URLs de video. Accede directamente a data.response[0] para obtener la URL del video.

javascript

1	// Extract video URL from response
2	const videoUrl = data.response[0];

Respuestas

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "SUCCESS",
7	"consumed_credits": 28,
8	"created_at": "2026-02-07T10:30:00Z",
9	"request": {
10	"prompt": "A majestic eagle soaring through golden sunset clouds",
11	"aspect_ratio": "16:9",
12	"resolution": "720p",
13	"duration": "8"
14	},
15	"response": [
16	"https://cdn.example.com/videos/seed15abc123def456pro.mp4"
17	],
18	"error_message": null
19	}
20	}

Playground de la API

Prueba la API directamente desde tu navegador. Reemplaza YOUR_API_KEY con tu clave API real.

Consola de APIPOST

URL Base

Endpoint

Encabezados

Cuerpo de la Petición

Códigos de Error

Status	Code	Description
400 Petición Incorrecta	`INVALID_PROMPT`	El prompt es inválido o está vacío
400 Petición Incorrecta	`INVALID_ASPECT_RATIO`	Relación de aspecto no soportada
400 Petición Incorrecta	`INVALID_RESOLUTION`	La resolución debe ser 480p o 720p
400 Petición Incorrecta	`INVALID_DURATION`	La duración debe ser 4, 8 o 12 segundos
400 Petición Incorrecta	`TOO_MANY_IMAGES`	Máximo 1 URL de imagen permitida en el array image_urls
401 No autorizado	`INVALID_API_KEY`	Clave API faltante o inválida
402	`INSUFFICIENT_CREDITS`	Créditos insuficientes para esta operación
404 No encontrado	`TASK_NOT_FOUND`	ID de tarea no encontrado o no pertenece a tu cuenta
500 Error interno del servidor	`INTERNAL_ERROR`	Error del servidor, por favor intenta más tarde

switch_heading