switch_heading
Documentación de la API de Seedance 2.5
Genera vídeos Seedance 2.5 y Seedance 2.5 Flash con la API v3: texto a vídeo, imágenes, vídeos y audio de referencia, primer/último fotograma, edición de vídeo y salida 4K.
La API v3 es un endpoint independiente solo para Seedance 2.5. Las integraciones existentes con /v1 y /v2 siguen funcionando exactamente igual; cambia a /v3 solo cuando quieras Seedance 2.5.
Inicio rápido
| 1 | curl -X POST 'https://seedanceapi.org/v3/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedance-2.5", |
| 6 | "prompt": "A cinematic aerial shot over a coastline at golden hour", |
| 7 | "aspect_ratio": "16:9", |
| 8 | "resolution": "720p", |
| 9 | "duration": 10 |
| 10 | }' |
Autenticación
Todas las peticiones a la API requieren un token Bearer en la cabecera Authorization.
Importante: Obtén tu clave de API en la página API Keys de tu panel. Guárdala en tu servidor y nunca la incluyas en código de navegador. → Obtener tu clave de API
| 1 | Authorization: Bearer YOUR_API_KEY |
Modos de generación
| Modo | Campos a enviar |
|---|---|
| Texto a vídeo | prompt + aspect_ratio |
| Generación por referencia (imágenes, vídeo, audio) | prompt + image_urls / reference_video_urls / reference_audio_urls |
| Primer / último fotograma | prompt + first_frame_url (+ last_frame_url) |
| Edición de vídeo | prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive" |
Precios (créditos)
Los créditos se cobran por segundo de vídeo y dependen del modelo, la resolución y de si envías vídeos de referencia. El importe se descuenta al crear la tarea y se reembolsa automáticamente si falla.
¿Necesitas recargar créditos? → Recarga en la página de precios. 1 USD = 100 créditos.
Seedance 2.5
Máxima calidad, compatible con 480p, 720p y 4K nativo.
| Resolución | Entrada | Tarifa | Ejemplo |
|---|---|---|---|
| 480p | Texto / imágenes / audio | 28 créditos / s | 10 s de salida = 280 créditos |
| 480p | Con vídeo de referencia | 17 créditos / s | 5 s de referencia + 10 s de salida = 255 créditos |
| 720p | Texto / imágenes / audio | 63 créditos / s | 10 s de salida = 630 créditos |
| 720p | Con vídeo de referencia | 38 créditos / s | 5 s de referencia + 10 s de salida = 570 créditos |
| 4k | Texto / imágenes / audio | 251 créditos / s | 10 s de salida = 2510 créditos |
| 4k | Con vídeo de referencia | 155 créditos / s | 5 s de referencia + 10 s de salida = 2325 créditos |
Seedance 2.5 Flash
Más rápido y barato, compatible con 480p y 720p.
| Resolución | Entrada | Tarifa | Ejemplo |
|---|---|---|---|
| 480p | Texto / imágenes / audio | 18.5 créditos / s | 10 s de salida = 185 créditos |
| 480p | Con vídeo de referencia | 11.5 créditos / s | 5 s de referencia + 10 s de salida = 173 créditos |
| 720p | Texto / imágenes / audio | 41 créditos / s | 10 s de salida = 410 créditos |
| 720p | Con vídeo de referencia | 25.5 créditos / s | 5 s de referencia + 10 s de salida = 383 créditos |
Con reference_video_urls, la facturación aplica la tarifa de entrada de vídeo más baja a los segundos de vídeo de referencia, además de los segundos de salida. La edición de vídeo (duration -1) factura el doble de la duración del vídeo de entrada. Los totales se redondean hacia arriba a un crédito entero.
Endpoints de la API
/v3/generateInicia un trabajo de Seedance 2.5 o Seedance 2.5 Flash. La llamada devuelve un task_id de inmediato; consulta /v3/status o pasa callback_url para obtener el resultado.
Cuerpo de la petición
Prompt de texto (obligatorio, hasta 5000 caracteres).
seedance-2.5 (predeterminado) o seedance-2.5-flash. Defaults to seedance-2.5.
Duración de salida en segundos: cualquier entero de 4 a 30. Usa -1 para la edición de vídeo, donde la salida mantiene la duración del vídeo de entrada. Defaults to 5.
Seedance 2.5: 480p, 720p o 4k. Seedance 2.5 Flash: 480p o 720p. 1080p no está disponible. Defaults to 720p.
16:9, 9:16, 4:3, 3:4 o adaptive. La edición de vídeo requiere adaptive. Defaults to 16:9.
Hasta 4 URL de imágenes de referencia (http/https). Describe en el prompt cómo debe usarse cada imagen.
URL de imagen usada como primer fotograma. No se puede combinar con image_urls, reference_video_urls ni reference_audio_urls.
URL de imagen opcional usada como último fotograma. Requiere first_frame_url.
Hasta 3 URL de vídeos de referencia, 30 segundos en total. Para la edición de vídeo, envía exactamente un vídeo de entre 4 y 30 segundos.
Hasta 3 URL de audio de referencia, por ejemplo música o una pista de voz.
Genera una banda sonora junto con el vídeo. Defaults to true.
Permite que el modelo busque en la web los temas del prompt. Defaults to false.
Webhook opcional llamado cuando la tarea termina (URL pública; localhost no está permitido).
Opcional: permite que el resultado aparezca en la galería pública.
Texto a vídeo
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "A slow dolly shot through a neon-lit street in the rain", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "720p", |
| 6 | "duration": 10 |
| 7 | } |
Imagen de referencia + audio
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio", |
| 4 | "image_urls": ["https://example.com/character.jpg"], |
| 5 | "reference_audio_urls": ["https://example.com/beat.mp3"], |
| 6 | "aspect_ratio": "9:16", |
| 7 | "resolution": "720p", |
| 8 | "duration": 8 |
| 9 | } |
Primer y último fotograma (Flash)
| 1 | { |
| 2 | "model": "seedance-2.5-flash", |
| 3 | "prompt": "The flower bud slowly opens into full bloom", |
| 4 | "first_frame_url": "https://example.com/bud.jpg", |
| 5 | "last_frame_url": "https://example.com/bloom.jpg", |
| 6 | "resolution": "480p", |
| 7 | "duration": 6 |
| 8 | } |
Edición de vídeo
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Change the season to winter with falling snow; keep the camera motion", |
| 4 | "reference_video_urls": ["https://example.com/input-12s.mp4"], |
| 5 | "aspect_ratio": "adaptive", |
| 6 | "duration": -1, |
| 7 | "resolution": "720p" |
| 8 | } |
Salida 4K
| 1 | { |
| 2 | "model": "seedance-2.5", |
| 3 | "prompt": "Macro shot of morning dew rolling off a green leaf", |
| 4 | "aspect_ratio": "16:9", |
| 5 | "resolution": "4k", |
| 6 | "duration": 5 |
| 7 | } |
Respuestas
Task created
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "IN_PROGRESS", |
| 7 | "consumed_credits": 630 |
| 8 | } |
| 9 | } |
/v3/statusConsulta por task_id hasta que status sea SUCCESS o FAILED. Aquí solo se devuelven las tareas creadas con /v3/generate.
Parámetros de consulta
ID de tarea devuelto por POST /v3/generate (termina en sd25).
Ejemplo de petición
| 1 | curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
Tip: Cuando status es SUCCESS, data.response es un array de URL de vídeo; usa data.response[0] para la primera URL. Descarga y guarda el archivo si necesitas conservarlo.
| 1 | const videoUrl = data.response[0]; |
Respuestas
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90a1b2c3d4e5f6sd25", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 630, |
| 8 | "created_at": "2026-11-19T10:30:00Z", |
| 9 | "type": "seedance-2.5-t2v", |
| 10 | "request": { |
| 11 | "model": "seedance-2.5", |
| 12 | "prompt": "A slow dolly shot…", |
| 13 | "aspect_ratio": "16:9", |
| 14 | "duration": 10 |
| 15 | }, |
| 16 | "response": [ |
| 17 | "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4" |
| 18 | ], |
| 19 | "error_message": null |
| 20 | } |
| 21 | } |
Playground de la API
Prueba la API en el navegador. Sustituye YOUR_API_KEY por tu clave real. Cada llamada correcta se factura.
Códigos de error
| Status | Cuándo ocurre |
|---|---|
| 400 Petición Incorrecta | Falta un parámetro o no es válido, por ejemplo un model, resolution, aspect_ratio, duration o URL de medio no admitido. El mensaje indica cuál. |
| 401 No autorizado | Falta la clave de API o no es válida. |
| 402 | Créditos insuficientes para esta tarea. |
| 404 No encontrado | La tarea no existe o no se creó con /v3/generate. |
| 500 Error interno del servidor | Error del servidor. Inténtalo más tarde; las tareas fallidas se reembolsan automáticamente. |