switch_heading
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.
Inicio Rápido
| 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
| 1 | Authorization: Bearer YOUR_API_KEY |
Precios
480p Resolución
14,25 créditos por segundo de salida, redondeado al alza
| Duración | Créditos |
|---|---|
| 4s | 57 credits |
| 5s | 72 credits |
| 8s | 114 credits |
| 10s | 143 credits |
| 12s | 171 credits |
| 15s | 214 credits |
720p Resolución
30,75 créditos por segundo de salida, redondeado al alza
| Duración | Créditos |
|---|---|
| 4s | 123 credits |
| 5s | 154 credits |
| 8s | 246 credits |
| 10s | 308 credits |
| 12s | 369 credits |
| 15s | 462 credits |
Endpoints de la API
/v1/generateCrear 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
Descripción textual del video a generar (máx. 2000 caracteres)
Relación de aspecto de salida. Compatibles: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.
Resolución del video: 480p o 720p Defaults to 720p.
Duración del video en segundos: entero 4–15 Defaults to 8.
Activar la generación de audio con IA (no afecta al precio) Defaults to false.
Obsoleto — se acepta por compatibilidad; Seedance 2.0 Mini lo ignora Defaults to false.
Array de URLs de imágenes de referencia para imagen-a-video (máx. 1)
URL webhook para notificaciones de estado asíncronas. Debe ser accesible públicamente.
Texto a video
| 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
| 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
| 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 | } |
/v1/statusVerificar el estado de una tarea de generación de video y obtener el resultado cuando esté completada.
Parámetros de Consulta
El ID único de tarea devuelto del endpoint generate
Ejemplo de Solicitud
| 1 | curl -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.
| 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": "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.
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 |