label llms.txt open_chatgpt

Documentación Seedance 2.0 Mini API

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

API v1 · 2.0 Mini Base URL: https://seedanceapi.org/v1

Inicio Rápido

bash
1curl -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
1Authorization: Bearer YOUR_API_KEY

Precios

480p

480p Resolución

14,25 créditos por segundo de salida, redondeado al alza

DuraciónCréditos
4s57 credits
5s72 credits
8s114 credits
10s143 credits
12s171 credits
15s214 credits
720p

720p Resolución

30,75 créditos por segundo de salida, redondeado al alza

DuraciónCréditos
4s123 credits
5s154 credits
8s246 credits
10s308 credits
12s369 credits
15s462 credits

Endpoints de la API

POST/v1/generate

Crear nueva tarea de generación de video con el modelo Seedance 2.0 Mini. 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. Compatibles: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive 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: entero 4–15 Defaults to 8.

generate_audio:optional boolean

Activar la generación de audio con IA (no afecta al precio) Defaults to false.

fixed_lens:optional boolean

Obsoleto — se acepta por compatibilidad; Seedance 2.0 Mini lo ignora 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}

Respuestas

Task created successfully

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

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
1curl -X GET 'https://seedanceapi.org/v1/status?task_id=n90abc123def456_seedance' \
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
2const videoUrl = data.response[0];

Respuestas

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90abc123def456_seedance",
6 "status": "SUCCESS",
7 "consumed_credits": 246,
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/n90abc123def456_seedance.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

Códigos de Error

StatusCodeDescription
400 Petición IncorrectaINVALID_PROMPTEl prompt es inválido o está vacío
400 Petición IncorrectaINVALID_ASPECT_RATIORelación de aspecto no soportada
400 Petición IncorrectaINVALID_RESOLUTIONLa resolución debe ser 480p o 720p
400 Petición IncorrectaINVALID_DURATIONLa duración debe ser 4, 8 o 12 segundos
400 Petición IncorrectaTOO_MANY_IMAGESMáximo 1 URL de imagen permitida en el array image_urls
401 No autorizadoINVALID_API_KEYClave API faltante o inválida
402 INSUFFICIENT_CREDITSCréditos insuficientes para esta operación
404 No encontradoTASK_NOT_FOUNDID de tarea no encontrado o no pertenece a tu cuenta
500 Error interno del servidorINTERNAL_ERRORError del servidor, por favor intenta más tarde