Skip to main content
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 en image_urls es semántico — no ordene ni elimine duplicados:

Parámetros de la solicitud

string
requerido
Valor fijo: flux-3-video
string
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 5
duration: "auto" no se admite (la facturación necesita un recuento fijo de segundos). Omitido, "auto", o no enteros → se tratan como 5 segundos sin error y sin longitud adaptativa.
En 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 acepta 720p)
  • fhd (también acepta 1080p)
Medido: hd ~1280×704 en 16:9; fhd ~1920×1088.
El modo borrador (draft:true) solo permite hd.
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: hd
string
Borrador → final: ID de su tarea de borrador exitosa
  • Solo resolution puede 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

El paso de borrador a final vuelve a renderizar a calidad completa con los parámetros guardados del borrador (mode / prompt / seed / assets). Los borradores de continuación se finalizan a tarifas finales de continuación.

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.