Seedance 2.5 Flash

Genera vídeos de 4–30 segundos a 480p o 720p a partir de texto, fotogramas iniciales/finales o referencias multimodales, o edita un vídeo de origen.

Seedance 2.5 Flash admite texto a vídeo, generación con fotogramas iniciales/finales, generación con referencias y edición de vídeo. Usa dreamina-seedance-2-5-flash con el nivel Default. Envía los archivos multimedia mediante URL públicas HTTP o HTTPS sin credenciales. Guarda el ID de tarea devuelto y consúltalo para obtener el vídeo terminado.

Consulta el playground y los precios en tiempo real, la especificación OpenAPI y la guía de precios.

Ejemplo rápido

Esta solicitud crea un vídeo de cuatro segundos. Revisa el precio actual antes de enviarla; enviar una generación que se complete correctamente conlleva un cargo.

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-flash",
    "content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
    "resolution": "480p",
    "duration": 4,
    "ratio": "16:9",
    "generate_audio": false
  }'

Parámetros

model y content son obligatorios. Todos los demás campos son opcionales. Se rechazan los valores null explícitos y los campos desconocidos.

Campo	Tipo	Valor predeterminado	Restricciones
`model`	cadena	obligatorio	`dreamina-seedance-2-5-flash`
`content`	matriz	obligatorio	Al menos un elemento de texto no vacío; los elementos multimedia requieren un rol.
`resolution`	cadena	`720p`	`480p` o `720p`.
`duration`	entero	`5`, o `-1` para edición	Generación: 4–30 segundos. Edición: omite el campo o usa `-1`; la salida sigue al origen.
`ratio`	cadena	`16:9`, o `adaptive` para fotogramas/edición	Generación con texto/referencias: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`. Fotogramas iniciales/finales y edición: solo `adaptive`.
`generate_audio`	booleano	`true`	Activa o desactiva el audio generado; no cambia la tarifa.
`omni_reference_task_type`	cadena	`generate`	`generate` o `edit`. La edición requiere exactamente un vídeo.
`content_filter`	booleano	`true`	Solo se acepta `true`; no se necesita ningún control en el playground.

La documentación establece un máximo de 10.000 tokens para los prompts. No se especifica ningún tokenizador público, por lo que un recuento de caracteres no debe tratarse como un recuento exacto de tokens.

Contenido y modos

El texto usa {"type":"text","text":"Describe the shot"}. Las imágenes, los vídeos y el audio usan una URL anidada y un rol explícito:

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/reference.jpg"},
  "role": "reference_image"
}

Modo	Contenido	Encuadre y duración
Texto a vídeo	Solo texto	Relación fija; 4–30 segundos.
Fotogramas iniciales/finales	Texto más una imagen `first_frame` y, opcionalmente, una imagen `last_frame`	`adaptive`; 4–30 segundos. El fotograma final requiere un fotograma inicial.
Generación con referencias	Texto más elementos `reference_image`, `reference_video` o `reference_audio`	Relación fija; 4–30 segundos. Hasta 10 imágenes, 5 vídeos y 5 audios.
Edición de vídeo	Texto, exactamente un `reference_video`, imágenes/audio de referencia opcionales; tipo de tarea `edit`	`adaptive`; duración omitida o `-1`.

Los elementos de vídeo usan type: "video_url", video_url: {"url": "..."}, role: "reference_video"; los elementos de audio usan audio_url y reference_audio con la misma estructura. Los fotogramas iniciales/finales no se pueden combinar con archivos multimedia de referencia. Los controles Draft, Extend, 1080p, marca de agua, semilla y salida del último fotograma no están disponibles en esta integración. No se ofrecen callbacks.

Restricciones de archivos multimedia

Archivo multimedia	Formatos	Tamaño y duración
Imagen	JPEG, PNG, WebP	Hasta 30 MB; cada lado 300–6000 px; relación ancho/alto 0,4–2,5.
Vídeo	MP4, MOV	Hasta 200 MB; 24–60 FPS; cada lado 300–6000 px; relación 0,4–2,5; 409.600–8.295.044 píxeles. Referencias: 2–30 segundos cada una, como máximo 30 segundos en total. Origen de edición: 4–30 segundos.
Audio	WAV, MP3	Hasta 15 MB; 2–30 segundos cada uno, como máximo 30 segundos en total.

Los archivos deben ser legibles antes del envío. La duración del vídeo se mide a partir del archivo multimedia para calcular el cargo. Usa URL públicas estables.

Respuesta de tarea y consultas periódicas

La creación devuelve id, model, status y created_at. Consulta la misma tarea hasta que termine:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

El estado es processing, completed o failed. Si se completa correctamente, lee output.video_url para obtener el vídeo almacenado. Si falla, lee error.code y error.message. Las respuestas públicas no incluyen costes. Un tiempo de espera agotado en las consultas periódicas no demuestra que la generación haya fallado: conserva el ID de tarea y vuelve a consultarlo en lugar de enviar otra generación.

Facturación

La tarifa en tiempo real depende de la resolución y de si se proporciona un vídeo. Sin vídeo de entrada, los segundos facturados equivalen a la duración de salida. Con vídeos de referencia, los segundos facturados equivalen a la duración de salida más el mayor valor entre la duración de salida y la duración total de entrada redondeada hacia arriba. La edición factura el doble de la duración de origen redondeada hacia arriba. El audio está incluido. Las solicitudes fallidas no se cobran.

Por ejemplo, una salida de cinco segundos con tres segundos de vídeo de referencia factura diez segundos. Una edición de un origen de diez segundos factura veinte segundos. Multiplica los segundos facturados por la tarifa en tiempo real aplicable.

Consulta el ciclo de vida de las tareas y los códigos de error para conocer las respuestas habituales y las indicaciones sobre reintentos.