Introducción
FLUX 3 Imagen a video anima una imagen fija con el modelo de video FLUX 3 de Black Forest Labs. Dale un fotograma inicial y, si quieres, uno final; genera de 5 a 20 segundos de movimiento con sonido sincronizado a 720p o 1080p.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | FLUX 3 Texto a video |
| una imagen fija para animar, con un último fotograma opcional | FLUX 3 Imagen a video |
| un clip para continuar | FLUX 3 Extensión de video |
| un clip para ampliar | FLUX 3 Ampliación de video |
Funciones y aspectos destacados
La imagen fija el aspecto
La persona, la ropa y el escenario vienen del fotograma inicial, así que el prompt solo tiene que describir la acción, la cámara y el sonido.
Fotograma inicial y final
Con una imagen final, el clip se mueve de una a otra. Los fotogramas cercanos en luz y posición se mezclan con suavidad; los que están muy separados pueden producir un corte brusco en medio.
La forma sigue a la imagen
Si omites la relación de aspecto, el clip conserva la forma del fotograma inicial.
Facturación por segundo
El precio depende de la duración y del nivel (borrador el más bajo, luego 720p estándar y después 1080p estándar); un último fotograma y el ajuste de sonido no cuestan nada extra.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5000 caracteres. Describe lo que ocurre después de la imagen inicial: la acción, el movimiento de cámara y una línea Sound:. mínimo 1 caracteres · máximo 5000 caracteres |
image_url | Sí | El fotograma inicial, subido o enlazado. El sujeto conserva su aspecto de esta imagen. mínimo 1 caracteres |
last_image_url | No | Fotograma final opcional. El clip se mueve de la imagen inicial a esta; cuando ambas difieren mucho, el modelo puede hacer un corte brusco en medio en lugar de un cambio gradual. mínimo 1 caracteres |
aspect_ratio | No | Una de 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 o 2:1. Omítela para seguir la imagen inicial. |
quality | No | standard (por defecto) renderiza a la resolución que elijas; draft es una vista previa rápida y más barata que siempre es 720p ( |
resolution | No | 720p (por defecto) o 1080p. El 1080p cuesta más. |
duration_seconds | No | Duración en segundos enteros, de 5 a 20; 5 por defecto. Se factura por segundo, así que fija el precio junto con el nivel. |
generate_audio | No | Genera sonido sincronizado con la imagen. Activado por defecto; desactivado da un archivo silencioso. Valor predeterminado: |
Precios
Se factura por segundo de video según el nivel: el borrador es el más barato, luego el 720p estándar y después el 1080p estándar. El sonido activado o desactivado cuesta lo mismo, y la relación de aspecto no cambia el precio. Las solicitudes rechazadas o fallidas no se cobran. Añadir un último fotograma no cambia el precio.
| Resolución | Calidad: Borrador | Calidad: Estándar |
|---|---|---|
| $0.06 / segundo | $0.29 / segundo |
| $0.06 / segundo | $0.17 / segundo |
Casos de uso
Dar vida a retratos
Una sonrisa, un giro de cabeza, viento en el cabello, con el sonido del lugar a juego.
Movimientos de antes y después
Cambios de hora del día o de pose entre un fotograma inicial y uno final.
Imágenes de producto y de lugares
Un arco lento de cámara alrededor de un sujeto del que ya tienes una foto.
Guía de prompts y consejos prácticos
Describe el movimiento, no la imagen
La imagen ya muestra quién y dónde; escribe lo que cambia.
Mantén los dos fotogramas cercanos
Una luz y una posición parecidas dan un movimiento suave; los fotogramas muy distintos suelen unirse con un corte.
No confíes en la fórmula del plano único
Pedir un solo plano continuo no lo garantiza, así que revisa el resultado.
Espera pequeñas desviaciones del rostro en movimientos largos
El rostro puede variar un poco durante giros de cabeza amplios o cuando las manos lo cruzan.
Previsualiza en borrador
Prueba el movimiento en borrador antes de un render completo.
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": "black-forest-labs/flux-3/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p"
}
}'
# 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.


























