Introducción
Seedance 2.0 Fast imagen a video empieza el clip en una imagen que tú proporcionas y la anima hasta por 15 segundos. Si agregas una imagen final, la toma tiene que llegar a ella, y eso hace repetibles las transiciones y los pares de antes y después.
Seedance 2.0 Fast es el nivel rápido de la línea Seedance 2.0 de ByteDance. Sus tres endpoints devuelven clips de 4 a 15 segundos en 480p o 720p, con audio generado junto con la imagen.
Elige el modo de Seedance 2.0 Fast según tu material inicial
| Material inicial | Modo |
|---|---|
| Un guion o la descripción de una escena | Seedance 2.0 Fast Texto a video |
| Una imagen inicial aprobada | Seedance 2.0 Fast Imagen a video |
| Referencias separadas de apariencia, movimiento o audio | Seedance 2.0 Fast Referencias a video |
Funciones y aspectos destacados
Un mismo conjunto de campos, tres fuentes
Los tres endpoints aceptan los mismos campos base: prompt, duration_seconds de 4 a 15 (o -1 para que el modelo elija), resolution en 480p o 720p, aspect_ratio, generate_audio y seed. Lo que cambia es la fuente que ancla la imagen: nada, un fotograma inicial o un conjunto de referencias. Una solicitud pasa de un modo a otro con solo agregar o quitar esa fuente.
Imagen y sonido en una sola pasada
generate_audio viene activado y genera ambiente, efectos de movimiento y voz sincronizados con los fotogramas. Desactivarlo no baja la tarifa en este nivel, así que apágalo solo para loops mudos o para material que vas a musicalizar en posproducción.
Formato adaptable por defecto
aspect_ratio usa adaptive por defecto: imagen a video conserva las proporciones del fotograma inicial, referencias a video sigue la referencia principal y texto a video deja que el modelo elija la forma que sugiere el prompt. Las seis relaciones fijas, 16:9, 9:16, 4:3, 3:4, 1:1 y 21:9, están disponibles cuando el destino impone el formato.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | No | Opcional, pero conviene escribirlo: di qué pasa después del fotograma en lugar de repetir lo que ya se ve — la acción, el movimiento de cámara, el paso del tiempo, el sonido. mínimo 1 caracteres |
image_url | Sí | Enlace público y descargable directo al primer fotograma; obligatorio. |
last_image_url | No | Fotograma final opcional. Decide la imagen en la que aterriza la toma: una transición, un antes y después, o un bucle que abre y cierra con la misma imagen. |
aspect_ratio | No | Encuadre de salida, adaptive por defecto: el clip conserva las proporciones de tu fotograma inicial, así que no se recorta nada. |
resolution | No | Resolución de salida: 480p o 720p por defecto. Elige un escalón de tarifa y gobierna solo el formato entregado; no añade detalle que el primer fotograma no tuviera ya. |
duration_seconds | No | Duración del clip final en segundos enteros, de 4 a 15, 5 por defecto, y la cantidad facturable; con -1 la elige el modelo y la estimación supone 15 segundos. |
generate_audio | No | Determina si se renderiza una banda sonora nativa sincronizada con la imagen. Activo por defecto; apagarlo no baja la tarifa en esta versión. Valor predeterminado: |
seed | No | Seed entera; si la omites, cada tirada saca la suya. Fíjala con todo lo demás constante para juzgar qué cambió realmente un retoque de prompt. |
return_last_frame | No | Devuelve además el último fotograma del clip como imagen aparte, junto al video. Valor predeterminado: |
bitrate_mode | No | Tasa de bits del archivo entregado: |
watermark | No | Añade al video la marca de agua visible «AI generated» del propio modelo. Valor predeterminado: |
Precios
| Especificación | Precio |
|---|---|
| $0.04499712 / segundo |
| $0.096768 / segundo |
Casos de uso
Resultados literales desde un fotograma propio
Lo que muestra el fotograma inicial ya está en el clip, así que el prompt solo tiene que describir el movimiento y no justificar el contenido. Es el camino confiable cuando el filtro propio de Seedance rechaza la misma escena escrita como texto.
Antes y después, y transiciones
Envía last_image_url junto con image_url y la toma tendrá que terminar en la imagen final. El ejemplo publicado llena una habitación vacía con una alfombra, un sofá y lámparas en diez segundos con la cámara fija: la forma de una revelación de remodelación o de la transformación de un producto.
Prueba en 480p, entrega en 720p
Haz pasadas económicas en 480p hasta que la acción y el encuadre funcionen, y luego repite la misma solicitud en 720p para la toma que te quedas. La resolución solo cambia el formato entregado; no agrega detalle que el primer fotograma no tenga.
Guía de prompts y consejos prácticos
Prepara primero el fotograma
image_url fija la composición, el aspecto del sujeto, el color y el techo de calidad. Los textos, marcas de agua y logotipos pasan al video, así que elimínalos antes. Cada lado de la imagen debe medir entre 300 y 6000 píxeles; si no, la solicitud se rechaza antes de empezar a generar.
Describe lo que pasa después, no lo que ya se ve
El prompt es opcional, pero conviene escribirlo: nombra la acción, el movimiento de cámara, el paso del tiempo y el sonido. Una toma guiada por un solo fotograma se desvía más cuanto más dura, así que confirma el movimiento en 4 o 5 segundos antes de pagar por 15.
Adapta el ejemplo incluido
El ejemplo publicado usa aspect_ratio 16:9, duration_seconds 6, generate_audio true y resolution 720p, con la foto de un escaparate como image_url.
A hand reaches into frame and flips the door sign from CLOSED to OPEN, then withdraws; steam drifts off the machine behind the glass and the street reflection keeps moving. Camera stays where it is.
16:9 se indica de forma explícita para un espacio horizontal fijo, en lugar de dejar que adaptive siga la imagen. Conserva la cámara fija y una sola acción clara cuando uses tu propio fotograma.
Mantén los dos fotogramas con la misma forma
Si agregas last_image_url, dale las mismas proporciones que al fotograma inicial; si no coinciden, la imagen final se recorta para ajustarse. Mantén la cámara y la luz estables entre ambas y cambia un solo estado claro, o el centro del clip se convierte en un corte.
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.0-fast/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"generate_audio": true,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
