Introducción
FLUX 3 Texto a video es el modelo de video de Black Forest Labs, con su API disponible desde el 4 de agosto de 2026. Convierte un prompt escrito en un clip de 5 a 20 segundos con sonido sincronizado, a 720p o 1080p en siete formas, y tiene un nivel borrador rápido para revisar un plano al precio más bajo.
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
Imagen y sonido juntos
El sonido se genera en la misma pasada que la imagen. Los diálogos entre comillas coincidieron palabra por palabra con nuestros prompts, y una línea Sound: dirige el ruido ambiente, como la lluvia o los pasos. Desactivar el sonido cuesta lo mismo.
Nivel borrador
El borrador es una vista previa rápida y más barata, siempre a 720p. El detalle es más suave que en estándar, pero basta para juzgar encuadre, acción y ambiente antes del render completo.
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. La relación de aspecto y el ajuste de sonido no lo cambian, y las solicitudes rechazadas o fallidas no se cobran.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5000 caracteres. Describe el sujeto, la acción, la cámara, la luz y el sonido; añade una línea Sound: para el ruido ambiente y pon las palabras habladas entre comillas. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Una de 16:9 (por defecto), 9:16, 1:1, 4:3, 3:4, 21:9 o 2:1. La forma no cambia el precio. |
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.
| Resolución | Calidad: Borrador | Calidad: Estándar |
|---|---|---|
| $0.06 / segundo | $0.29 / segundo |
| $0.06 / segundo | $0.17 / segundo |
Casos de uso
Escenas de diálogo y ambiente
Un personaje, una frase, un sonido de fondo y un movimiento de cámara lento.
Storyboards
Previsualiza cada plano en borrador y vuelve a renderizar los que te quedas.
Clips para redes y verticales
9:16 y 1:1 vienen incluidos, y 21:9 y 2:1 cubren los encuadres panorámicos de cine.
Guía de prompts y consejos prácticos
Escríbelo como un plano
Sujeto y vestuario, escenario, acción, movimiento de cámara, luz y, al final, una línea que empiece por Sound:.
Pon el diálogo entre comillas
Escribe las palabras habladas entre comillas, en el idioma en que quieres oírlas.
Una acción por clip
Una sola acción clara y un solo movimiento de cámara se mantienen mejor; los cambios grandes de luz o de lugar pueden hacer que el modelo corte o haga un fundido.
Primero el borrador
Ajusta el encuadre en borrador y luego lanza el mismo prompt en estándar.
Ten expectativas realistas sobre el contenido
Solo se renderizan los looks de nivel Suave; cualquier cosa más fuerte se rechaza y no se cobra.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.


























