FLUX 3 Video
Generación de vídeo FLUX 3
- Modo de procesamiento asíncrono, devuelve un ID de tarea para consultas posteriores
- Entrada unificada: texto a vídeo / imagen a vídeo / continuación de vídeo / borrador en dos pasos
- Salida H.264 + AAC con audio sincronizado, duración 5~20 segundos
- Resolución hd / fhd, siete proporciones de aspecto
POST
Authorization
string
requerido
Todos los endpoints requieren autenticación mediante Bearer TokenObtenga su clave de API en la página de gestión de claves de API:
Modos de generación
flux-3-video es una entrada unificada: el modo se infiere de los campos, o se define explícitamente con mode.
Valores de
mode: t2v / i2v / v2v / draft_enhance, u ortografías oficiales text-to-video / image-continuation / video-continuation. mode explícito tiene la máxima prioridad.
Semántica de keyframes imagen a vídeo
El orden enimage_urls es semántico — no ordene ni elimine duplicados:
Parámetros de la solicitud
string
requerido
Valor fijo:
flux-3-videostring
requerido
Prompt. No debe enviarse al usar
draft_from_task_id (se rechaza si está presente).integer
predeterminado:"5"
Duración en segundos, entero 5~20, predeterminado
5En la continuación de vídeo, la duración entregada puede ser menor que la solicitada (p. ej. solicitar 5s, obtener 4s). Se cobran por adelantado los segundos solicitados y se reembolsa la diferencia al completar; el importe final es el
cost de la consulta. Texto/imagen a vídeo no muestran esta diferencia.string
predeterminado:"hd"
Resolución
hd(predeterminado; también acepta720p)fhd(también acepta1080p)
hd ~1280×704 en 16:9; fhd ~1920×1088.string
predeterminado:"auto"
Proporción de aspectoOpciones:
21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16, o auto (predeterminado; se elige automáticamente según el prompt y los assets)string[]
Keyframes imagen a vídeo, 1~10, URL http(s) pública o base64
string
Vídeo de entrada para continuación (mp4, URL pública o base64)
string[]
Igual que
video_url; usa el primer elemento (compat)boolean
predeterminado:"true"
Generar audio sincronizado, predeterminado
true. false produce vídeo silencioso (sin descuento)boolean
predeterminado:"false"
Modo borrador: vista previa de baja calidad a ~1/3 del precio; solo con
resolution: hdstring
Borrador → final: ID de su tarea de borrador exitosa
- Solo
resolutionpuede cambiar; prompt, duración, imágenes, vídeo no pueden - Se cobra al precio final completo; la tarifa del borrador no se acredita
- Mutuamente excluyente con
draft:true
integer
predeterminado:"2"
Tolerancia de moderación 0~4, predeterminado
2 (mayor = más permisivo)No confunda con imágenes FLUX.2 (05) o Kontext (06).
string
Modo explícito (opcional); ver Modos de generación
Modo borrador
Flujo de trabajo en dos pasos cuando iterar es costoso:Crear borrador
Borrador a final
Ejemplos de solicitud
Texto a vídeo (retrato)
Imagen a vídeo (inicio + fin)
Continuación de vídeo
Vídeo silencioso
Restricciones
Errores comunes de envío (normalmente no se cobran)
Los fallos de moderación terminan como
failed con reembolso completo.
Cobertura de capacidades
Response
integer
Código de estado; 200 en caso de éxito
array
Array de datos de la respuesta
Consultar resultadosLa generación de vídeo es asíncrona. Consulte Obtener el estado de la tarea.Intervalo recomendado 5~10 segundos; timeout del cliente 15 minutos (20s fhd es más lento). Medido ~60s para
t2v + hd + 5s.En caso de éxito use result.videos[0].url; los assets se reflejan en el CDN de la plataforma. cost es el cargo final. Los fallos se reembolsan por completo.