Black Forest Labs
FLUX 3 Video
flux-3-video
El primer modelo de vídeo de Black Forest Labs, con arquitectura multimodal unificada, compatible con texto a vídeo, imagen a vídeo y continuación de fotogramas clave; genera imagen y audio nativo de forma sincronizada, con una duración máxima de aproximadamente 20 segundos en HD por generación
Probar flux-3-video
Entrada
Creaciones
Ver todas las creacionesSalida
videoPrecios
flux-3-video per second
Descripción general
FLUX 3 Video es un modelo de generación de vídeo presentado por Black Forest Labs, que adopta una arquitectura multimodal unificada entrenada conjuntamente con imagen, vídeo, audio y movimiento. Admite tres tipos de tareas: texto a vídeo, imagen a vídeo y continuación de vídeo, y genera de forma sincronizada audio nativo que coincide con la imagen. Los desarrolladores pueden llamarlo a través de la interfaz unificada de HiAPI.ai para obtener clips de 5 a 20 segundos en 720p o 1080p. Es adecuado para equipos de publicidad y vídeos cortos que necesitan producir rápidamente material comercial con sonido, así como para creadores de preproducción audiovisual que necesitan extender planos y previsualizar el control de fotogramas clave.
Puntos clave
- Tres tipos de tareas de vídeo comparten un mismo conjunto de parámetros: un mismo modelo cubre a la vez texto a vídeo, imagen a vídeo y continuación de vídeo; cambiar de tarea no requiere cambiar el método de acceso ni reconstruir el flujo de trabajo.
- Generación sincronizada de imagen y audio nativo: por defecto genera sonido ambiente, diálogos y efectos de sonido junto con la imagen, lo que elimina los procesos de doblaje y alineación por separado; se puede desactivar para obtener clips silenciosos.
- Varias imágenes forman un storyboard o fotogramas clave: 1 imagen define el primer fotograma, 2 imágenes definen el primer y último fotograma, y de 3 a 10 imágenes forman un storyboard según una línea de tiempo uniforme, lo que facilita controlar el ritmo del plano.
- Modo borrador para probar clips a bajo coste: al activar el borrador se obtiene una vista previa en 720p con mayor rapidez y menor coste, útil para validar el prompt y la composición antes de la versión final.
Descripción de capacidades
Texto a vídeo: genera un clip completo solo a partir de un prompt de texto; el prompt se analiza y se amplía antes de generar, lo que resulta adecuado para construir planos desde cero sin material de referencia.
Imagen a vídeo y control de fotogramas clave: sube de 1 a 10 imágenes para impulsar el movimiento: una sola imagen define el primer fotograma, dos imágenes definen el primer y último fotograma, y varias imágenes forman un storyboard según una línea de tiempo uniforme, para controlar con precisión el inicio, el final y el ritmo del plano.
Continuación de vídeo: se puede enviar un MP4 de hasta 15 segundos y 50 MB como máximo para continuar la generación desde el fotograma final, lo que sirve para alargar clips existentes o hacer un relevo de planos; este parámetro es mutuamente excluyente con la entrada de imágenes.
Duración y resolución controlables: la duración del clip es de 5 a 20 segundos y la resolución se puede elegir entre 720p o 1080p; la relación de aspecto admite ocho preajustes desde 21:9 hasta 9:16, además de la selección automática auto.
Generación de audio nativo: por defecto genera sonido ambiente, diálogos y efectos de sonido sincronizados con la imagen; al desactivarlo se obtiene un clip silencioso, lo que facilita añadir música o voz por separado en posproducción.
Casos de uso
- Equipos de publicidad y marcas: generar clips promocionales a partir de una sola imagen de producto: sube una imagen del producto y describe el movimiento de cámara para obtener material de 5 a 20 segundos con sonido ambiente, listo para publicaciones en redes sociales o para la primera pantalla del sitio web.
- Creadores de preproducción audiovisual: previsualización de planos con fotogramas clave: fija el ritmo con 2 a 10 imágenes de storyboard y genera clips de previsualización dinámica para que el director y el director de fotografía confirmen el movimiento de cámara y los puntos de montaje.
- Operación de vídeos cortos: extender planos con material existente: envía un MP4 de no más de 15 segundos y continúa desde el final para obtener fragmentos más largos, lo que reduce los rodajes y regrabaciones.
- Marketing multilingüe: material localizado con sincronización labial: especifica el idioma y los diálogos mediante el prompt para obtener cortos localizados con audio e imagen sincronizados, destinados a versiones de campaña para distintas regiones.
Limitaciones y recomendaciones de selección
La duración máxima por generación es de 20 segundos; los contenidos más largos deben generarse por segmentos y unirse mediante la continuación de vídeo. La facturación se basa en los segundos de salida, por lo que los clips largos o las regeneraciones repetidas aumentan el coste. El audio nativo se genera sincronizado con la imagen, por lo que el margen para ajustar la pista de audio por separado en posproducción es limitado; si se necesita una mezcla precisa, se recomienda desactivar el audio y producirlo aparte. Los parámetros de entrada de imágenes y de continuación de vídeo son mutuamente excluyentes y no pueden usarse a la vez en la misma solicitud; el modo borrador solo está disponible en 720p. Si la tarea requiere planos continuos de más de 20 segundos o un control de audio preciso fotograma a fotograma, conviene evaluar soluciones de unión por segmentos u otras herramientas especializadas.
Novedades
Ver el registro de cambios →- Nuevo modelo Lanzamiento del modelo de generación de video flux-3-video
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: flux-3-video
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para flux-3-video y la ruta default; consulta la tabla de parámetros a continuación.
draftbooleanOpcionalPredeterminado: falseGenerate a faster, lower-cost 720p preview instead of a full-quality clip.
imagesarrayOpcionalminItems 1maxItems 10Optional PNG, JPEG, or WebP images. One image sets the opening frame, two set opening and closing frames, and 3-10 images form an evenly timed storyboard. Cannot be combined with start_video.
Array [ string ]
promptstringObligatoriominLength 1maxLength 4700Describe the scene, action, camera movement, dialogue, and sound. The prompt is interpreted and expanded before generation.
durationintegerOpcionalPredeterminado: 5min 5max 20Generated clip duration in seconds. HiAPI uses an explicit 5-20 second duration for deterministic billing.
resolutionstringOpcionalPredeterminado: "720p"Output resolution. Draft generation is available at 720p only.
720p1080pstart_videostringOpcionalOptional MP4 to continue from its final frames. Maximum 50 MB and 15 seconds. Cannot be combined with images.
aspect_ratiostringOpcionalPredeterminado: "auto"Output aspect ratio. Auto selects a ratio from the prompt and media inputs.
auto21:92:116:94:31:13:49:16generate_audiobooleanOpcionalPredeterminado: trueGenerate synchronized ambient sound, dialogue, and effects. Disable for a silent clip.
callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-3-video",
"input": {
"draft": false,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "flux-3-video",
input: {
"draft": false,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "flux-3-video",
"input": {
"draft": False,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": True
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Kling 4.0 Kuaishou $0.330 /segundo -
Grok Imagine 1.5 xAI $0.011 /segundo -
Veo 3.1 Google $0.290 /segundo -
FLUX 3 Max Black Forest Labs $0.061 /segundo -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Kling 2.5 Kuaishou $0.060 /segundo -
PixVerse V6 PixVerse $0.036 /segundo -
Kandinsky 6.0 Pro $1.93 /vídeo -
MiniMax H3 MiniMax $0.072 /segundo -
Seedance 2.0 ByteDance $0.017 /segundo -
Wan 3.0 Video Alibaba $0.040 /segundo -
LTX 2.5 Fast Lightricks $0.086 /segundo
Mismo proveedor
-
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FLUX.2 Black Forest Labs $0.035 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
FLUX 3 Max Black Forest Labs $0.061 /segundo -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagen -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /imagen



