Documentación Seedance 2.0 API
Guía completa para integrar la API de generación de video Seedance 2.0 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
Generación rápida, adecuada para previsualizaciones y borradores
| Duración | Sin audio | Con audio |
|---|---|---|
| 4s | 8 credits ($0.04) | 14 credits ($0.07) |
| 8s | 14 credits ($0.07) | 28 credits ($0.14) |
| 12s | 19 credits ($0.095) | 38 credits ($0.19) |
720p Resolución
Salida de alta calidad, recomendada para producción
| Duración | Sin audio | Con audio |
|---|---|---|
| 4s | 14 credits ($0.07) | 28 credits ($0.14) |
| 8s | 28 credits ($0.14) | 56 credits ($0.28) |
| 12s | 42 credits ($0.21) | 84 credits ($0.42) |
Endpoints de la API
/v1/generateCrear nueva tarea de generación de video con el modelo Seedance 2.0. 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. Soportadas: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.
Resolución del video: 480p o 720p Defaults to 720p.
Duración del video en segundos: 4, 8 o 12 Defaults to 8.
Habilitar generación de audio IA para el video Defaults to false.
Fijar la cámara para reducir el desenfoque de movimiento 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 | "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 | } |
/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=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.
| 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.
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 |