label llms.txt open_chatgpt

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.

API v3 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

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

bash
1curl -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

http
1Authorization: Bearer YOUR_API_KEY

Modos de generación

ModoCampos a enviar
Texto a vídeoprompt + aspect_ratio
Generación por referencia (imágenes, vídeo, audio)prompt + image_urls / reference_video_urls / reference_audio_urls
Primer / último fotogramaprompt + first_frame_url (+ last_frame_url)
Edición de vídeoprompt + 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.

2.5

Seedance 2.5

Máxima calidad, compatible con 480p, 720p y 4K nativo.

ResoluciónEntradaTarifaEjemplo
480pTexto / imágenes / audio28 créditos / s10 s de salida = 280 créditos
480pCon vídeo de referencia17 créditos / s5 s de referencia + 10 s de salida = 255 créditos
720pTexto / imágenes / audio63 créditos / s10 s de salida = 630 créditos
720pCon vídeo de referencia38 créditos / s5 s de referencia + 10 s de salida = 570 créditos
4kTexto / imágenes / audio251 créditos / s10 s de salida = 2510 créditos
4kCon vídeo de referencia155 créditos / s5 s de referencia + 10 s de salida = 2325 créditos
Flash

Seedance 2.5 Flash

Más rápido y barato, compatible con 480p y 720p.

ResoluciónEntradaTarifaEjemplo
480pTexto / imágenes / audio18.5 créditos / s10 s de salida = 185 créditos
480pCon vídeo de referencia11.5 créditos / s5 s de referencia + 10 s de salida = 173 créditos
720pTexto / imágenes / audio41 créditos / s10 s de salida = 410 créditos
720pCon vídeo de referencia25.5 créditos / s5 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

POST/v3/generate

Inicia 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

Body ParametersJSON
prompt:string

Prompt de texto (obligatorio, hasta 5000 caracteres).

model:optional string

seedance-2.5 (predeterminado) o seedance-2.5-flash. Defaults to seedance-2.5.

duration:optional number

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.

resolution:optional string

Seedance 2.5: 480p, 720p o 4k. Seedance 2.5 Flash: 480p o 720p. 1080p no está disponible. Defaults to 720p.

aspect_ratio:optional string

16:9, 9:16, 4:3, 3:4 o adaptive. La edición de vídeo requiere adaptive. Defaults to 16:9.

image_urls:optional string[]

Hasta 4 URL de imágenes de referencia (http/https). Describe en el prompt cómo debe usarse cada imagen.

first_frame_url:optional string

URL de imagen usada como primer fotograma. No se puede combinar con image_urls, reference_video_urls ni reference_audio_urls.

last_frame_url:optional string

URL de imagen opcional usada como último fotograma. Requiere first_frame_url.

reference_video_urls:optional string[]

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.

reference_audio_urls:optional string[]

Hasta 3 URL de audio de referencia, por ejemplo música o una pista de voz.

generate_audio:optional boolean

Genera una banda sonora junto con el vídeo. Defaults to true.

web_search:optional boolean

Permite que el modelo busque en la web los temas del prompt. Defaults to false.

callback_url:optional string

Webhook opcional llamado cuando la tarea termina (URL pública; localhost no está permitido).

public:optional boolean

Opcional: permite que el resultado aparezca en la galería pública.

Texto a vídeo

json
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

json
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)

json
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

json
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

json
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}
GET/v3/status

Consulta por task_id hasta que status sea SUCCESS o FAILED. Aquí solo se devuelven las tareas creadas con /v3/generate.

Parámetros de consulta

Body ParametersJSON
task_id:string

ID de tarea devuelto por POST /v3/generate (termina en sd25).

Ejemplo de petición

bash
1curl -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.

javascript
1const 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.

Consola de APIPOST

Códigos de error

StatusCuándo ocurre
400 Petición IncorrectaFalta 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 autorizadoFalta la clave de API o no es válida.
402 Créditos insuficientes para esta tarea.
404 No encontradoLa tarea no existe o no se creó con /v3/generate.
500 Error interno del servidorError del servidor. Inténtalo más tarde; las tareas fallidas se reembolsan automáticamente.