Introducción
Envía video_url (un clip de hasta 60 segundos) y un prompt que describa lo que pasa después; duration_seconds, resolution, generate_audio, last_image_url y watermark son opcionales. La plataforma toma el último fotograma de tu clip, genera la continuación con Flash de imagen a video y la empalma con tu material, conservando la cadencia de cuadros y el sonido original de tu clip.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
| Desarrollador | ByteDance (Seedance 2.5 Flash, versión rápida de Seedance 2.5, anunciada por BytePlus el 12 de noviembre de 2026) |
| Nombres de la API | bytedance/seedance-2.5-flash/text-to-video, image-to-video, reference-to-video, video-edit, video-extend |
| Resolución | 480p o 720p (720p por defecto); 1080p y 4K no son compatibles |
| Duración del clip | 4–30 segundos enteros, 5 por defecto; video-edit sigue su origen de 4–30 s |
| Relación de aspecto | 16:9 (por defecto), 9:16, 4:3, 3:4, 1:1, 21:9 o adaptive en solicitudes de texto y de referencia; imagen a video sigue la imagen inicial |
| Límites de referencias | Hasta 10 imágenes, 5 clips (30 s en total) y 5 archivos de audio en referencia a video |
| Reglas de los clips de referencia | Cada clip cuenta como mínimo 2 s y necesita unos 409.600 píxeles (854×480 o más) |
| Entradas de la edición |
|
| Audio |
|
| Opciones de salida | mp4 (por defecto) o mov; watermark desactivado por defecto; |
| Base del cobro | Por segundo según la resolución; los clips de referencia suman sus segundos; las ediciones cobran los segundos del origen; las generaciones fallidas no se cobran |
| Tiempo de render medido | De 84 s a unos 11 min para 4 s en 480p (ejecuciones del 13 de noviembre de 2026) |
Funciones y aspectos destacados
Los flujos del modelo insignia con un techo más bajo
Flash conserva los cuatro flujos de Seedance 2.5 que encajan con el trabajo de borrador (texto, fotogramas inicial y final, referencias mixtas, edición de clips), deja fuera 1080p y 4K, y suma una extensión de video basada en su modo de imagen a video. BytePlus presenta el intercambio como resultados cercanos al modelo insignia con casi el doble de velocidad. Nuestros renders de 4 segundos en 480p tardaron entre 84 segundos y unos 11 minutos, así que mide la velocidad en tu propia cola.
Asigna una función a cada archivo en el prompt
Nombra los archivos por tipo y orden, con un espacio: @Image 1, @Video 1, @Audio 1. Con dos retratos como @Image 1 y @Image 2 en 16:9, ambas personas aparecieron juntas en una misma escena de elevador y conservaron rostro, cabello y ropa. Con una imagen, un clip y un archivo de voz, la calle, el tranvía amarillo y la cámara de seguimiento del clip pasaron al resultado, pero la persona quedó de espaldas a la cámara y el rostro de @Image 1 apenas se vio.
Una calle soleada convertida en una tarde nevada
Los dos ciclistas, sus bicicletas, el tranvía y el movimiento de cámara coincidieron con el origen fotograma por fotograma; cambiaron el clima y la luz, y nada más. Fue un clip de 4,0 s en 480p con el audio desactivado, que además conservó la banda sonora original.
Un interruptor decide qué banda sonora obtienes
generate_audio viene activado por defecto y produce voces, efectos y ambiente junto con la imagen. En video-edit, desactivarlo conserva la pista propia del clip de origen (44,1 kHz en nuestra prueba), mientras que activarlo genera una nueva que puede seguir a @Audio 1. El interruptor no afecta el precio.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio. Describe solo lo que pasa después del último fotograma: la acción siguiente, hacia dónde va la cámara y qué se oye. mínimo 1 caracteres · máximo 20000 caracteres |
video_url | Sí | Obligatorio. MP4, MOV o WebM, de hasta 60 segundos y 3840 píxeles en el lado largo. mínimo 1 caracteres |
last_image_url | No | Imagen opcional en la que termina el segmento nuevo, para tomas que deben llegar a una pose o un encuadre concretos. |
resolution | No | 480p o 720p para el segmento nuevo, 720p por defecto; la tarifa por segundo sigue esta elección. |
duration_seconds | No | Duración del segmento nuevo en segundos enteros, de 4 a 30, 5 por defecto. Solo se cobran estos segundos; el material de origen va delante en el archivo unido sin costo. |
generate_audio | No | Activado por defecto: Flash crea el sonido del segmento nuevo a partir del prompt y la imagen, y se funde con la pista de tu clip en la unión. Valor predeterminado: |
watermark | No | Desactivado por defecto. Valor predeterminado: |
Precios
Solo se cobra el segmento nuevo, igual que una solicitud de Flash de imagen a video: cada segundo solicitado a la tarifa de la resolución que elijas. El clip de origen y la unión no tienen costo extra, el sonido, el fotograma final y la marca de agua no cambian el precio, y una extensión que falla no se cobra.
| Especificación | Precio |
|---|---|
| $0.115 / segundo |
| $0.2392 / segundo |
Casos de uso
Probar un plano antes del render final
Envía un prompt de 4 segundos, 480p y 16:9 que termine con una línea Audio:, por ejemplo un cruce peatonal bajo la lluvia por la noche. Nuestra prueba devolvió 854×480 a 24 fps, con 4,064 s de duración y una pista AAC estéreo con lluvia y risas. Cambia una frase y vuelve a ejecutar para ver qué se movió.
Cambiar el estilo de material que ya grabaste
Sube un clip de 4 a 30 segundos, describe el cambio y enumera lo que debe mantenerse. En nuestra prueba, una calle soleada con dos ciclistas y un tranvía se convirtió en una tarde nevada, y con generate_audio desactivado volvió la banda sonora original sin cambios.
Maquetas de personajes y productos
Adjunta un retrato y una foto de producto como @Image 1 y @Image 2 y pide 9:16. Nuestra prueba con dos imágenes devolvió 480×854 con el hombre levantando un frasco de vidrio con gotero hacia el lente, así que ambas referencias aparecieron. Usa el resultado para evaluar la idea antes de armar una versión pulida.
Animar un retrato en bucle
Da la misma foto como image_url y last_image_url y describe el movimiento entre ambas. Nuestro retrato de una alfarera devolvió un clip de 562×748 y 4,064 s cuyos fotogramas inicial y final coincidían con la pose de origen.
Encadenar un plano con el siguiente
Pon return_last_frame en true y el MP4 llega con un JPEG de su último fotograma (854×480 en 480p y 16:9 en nuestra prueba). Pasa ese JPEG como image_url de la siguiente solicitud de imagen a video para que el plano siguiente empiece donde terminó el anterior.
Guía de prompts y consejos prácticos
Elige el endpoint según tu entrada
Usa texto a video para un prompt solo, imagen a video para un fotograma inicial, referencia a video para imágenes, clips o una voz, edición de video para un clip existente de 4–30 segundos y extensión de video para sumar de 4 a 30 segundos a un clip de hasta 60 segundos. Los cinco comparten el rango 480p/720p y el interruptor
generate_audio.Envía la solicitud createTask
Haz POST a https://api.spicyapi.ai/api/v1/jobs/createTask con el encabezado Authorization: Bearer YOUR_SPICY_API_KEY y el cuerpo {"model": "bytedance/seedance-2.5-flash/text-to-video", "input": {"prompt": "A lighthouse keeper climbs a spiral stair at dawn and wipes fog from the lamp glass. Audio: wind, boots on iron.", "
duration_seconds": 4, "resolution": "480p"}}.Consulta el clip terminado
La respuesta entrega un taskId en estado queued. Llama a GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID, o pasa un callBackUrl, hasta que el estado sea succeeded; luego lee la dirección del MP4 en output.assets. Los detalles de los campos están en la guía de tareas en docs.spicyapi.ai/docs/tasks.
Cambia una frase y luego sube de nivel
Compara variaciones en 480p y 4 segundos, cambiando una sola frase por ejecución. Cuando una toma funcione, vuelve a ejecutarla en 720p y con la duración objetivo, o envía la misma instrucción a Seedance 2.5 para 1080p.
Extensión de video de Seedance 2.5 Flash en una sola llamada
La extensión de video de Seedance 2.5 Flash agrega material nuevo a un clip que ya tienes. SpicyAPI toma el último fotograma de video_url, se lo pasa a Flash de imagen a video como imagen inicial junto con tu prompt y une el resultado de 4 a 30 segundos al final de tu material. Recibes un MP4 que se reproduce de corrido y el segmento nuevo en un archivo aparte, ambos en 480p o 720p con sonido generado.
Ejemplo de solicitud
POST https://api.spicyapi.ai/api/v1/jobs/createTask con Authorization: Bearer YOUR_SPICY_API_KEY. Cinco segundos más para un clip de seis segundos:
{
"model": "bytedance/seedance-2.5-flash/video-extend",
"input": {
"video_url": "https://example.com/cyclist.mp4",
"prompt": "The cyclist rests one foot on the curb, the light turns green, and she pushes off out of frame to the left while the camera holds still. Audio: idling traffic, a short bell ring.",
"duration_seconds": 5,
"resolution": "720p"
}
}
Ejemplo de respuesta
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "queued"}}
Consulta GET /api/v1/jobs/recordInfo?taskId=task_abc123 o pasa callBackUrl. output.assets muestra primero el clip unido (video) y después la parte nueva (segment); las duraciones reales llevan decimales:
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/joined.mp4", "role": "video", "durationSeconds": 11.0}, {"url": "https://example.com/segment.mp4", "role": "segment", "durationSeconds": 5.0}]}}}
Parámetros
| Parámetro | Valores | Por defecto |
|---|---|---|
video_url | MP4, MOV o WebM, hasta 60 s | Obligatorio |
prompt | Lo que pasa después del último fotograma | Obligatorio |
duration_seconds | 4 a 30, segmento nuevo | 5 |
resolution | 480p, 720p | 720p |
generate_audio | true, false | true |
last_image_url | Imagen en la que termina el segmento nuevo | Opcional |
watermark | Marca del modelo en el segmento nuevo | false |
El segmento nuevo toma la forma del último fotograma de tu clip, y el archivo unido siempre es un MP4.
Cómo funciona el cobro
El segmento nuevo cuesta lo mismo que una solicitud de Flash de imagen a video: cada segundo solicitado a la tarifa de tu resolución. El clip de origen y la unión son gratis, y el sonido, un fotograma final o la marca de agua no cambian el precio. Si la continuación o la unión fallan, la tarea se reembolsa por completo.
Consejos para buenos resultados
- Termina el origen en un fotograma claro y quieto. Un desenfoque, un corte o un fundido en el último fotograma pasa al segmento nuevo, así que recorta en un momento limpio.
- Describe lo que sigue, no la escena. El fotograma ya define quién está y cómo cae la luz.
- Vuelve a escribir el movimiento que debe seguir. Una imagen fija no tiene velocidad, así que escribe algo como "sigue caminando hacia la izquierda al mismo ritmo".
- Planea el sonido. Cierra con una línea
Audio:que encaje con el ambiente del origen, o apagagenerate_audioy musicaliza después.
Límites y errores
- La salida es 480p o 720p; se acepta un origen en 1080p, pero la parte nueva se ve más suave sobre su lienzo.
- Un solo fotograma no transmite lo que queda fuera de cuadro, ni el impulso de la cámara, ni el ritmo de la pista, y la luz puede cambiar un poco en la unión, así que revisa el empalme.
- Los orígenes de más de 60 segundos o de más de 3840 píxeles en el lado largo, y los archivos ilegibles, se rechazan sin costo.
- Usa el nombre completo del endpoint: una llamada a nivel de familia con
video_urlllega aquí solo si también defineduration_seconds,last_image_urlowatermark; si no, ejecuta una edición de video. - Extiende solo material propio o que tengas permiso de usar, y nunca el video de una persona real sin su consentimiento.
Cuándo usar la extensión del modelo insignia
La extensión de video de Seedance 2.5 genera hasta 1080p y lee hasta los últimos 30 segundos de tu clip en lugar de un solo fotograma, lo que ayuda a que un movimiento o una voz sigan; esos segundos de referencia también se cobran.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.5-flash/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.










