FLUX 3 Video
Génération vidéo FLUX 3
- Mode de traitement asynchrone, retourne un identifiant de tâche pour les requêtes ultérieures
- Entrée unifiée : texte-vers-vidéo / image-vers-vidéo / continuation vidéo / brouillon en deux étapes
- Sortie H.264 + AAC avec audio synchronisé, durée 5~20 secondes
- Résolution hd / fhd, sept rapports d’aspect
POST
Authorization
string
requis
Tous les points de terminaison nécessitent une authentification Bearer TokenObtenez votre clé API depuis la page de gestion des clés API :
Modes de génération
flux-3-video est une entrée unifiée : le mode est déduit des champs, ou défini explicitement avec mode.
Valeurs de
mode : t2v / i2v / v2v / draft_enhance, ou orthographes officielles text-to-video / image-continuation / video-continuation. mode explicite a la priorité la plus élevée.
Sémantique des images clés image-vers-vidéo
L’ordre dansimage_urls est sémantique — ne pas trier ni dédupliquer :
Paramètres de la requête
string
requis
Valeur fixe :
flux-3-videostring
requis
Prompt. Ne doit pas être envoyé lors de l’utilisation de
draft_from_task_id (rejeté s’il est présent).integer
défaut:"5"
Durée en secondes, entier 5~20, par défaut
5Pour la continuation vidéo, la durée livrée peut être inférieure à celle demandée (ex. demander 5s, obtenir 4s). Les secondes demandées sont préfacturées et la différence est remboursée après achèvement ; le montant final est le
cost de la requête. Texte/image-vers-vidéo ne présentent pas cet écart.string
défaut:"hd"
Résolution
hd(par défaut ; accepte aussi720p)fhd(accepte aussi1080p)
hd ~1280×704 en 16:9 ; fhd ~1920×1088.string
défaut:"auto"
Rapport d’aspectOptions :
21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16, ou auto (par défaut ; choisi automatiquement d’après le prompt et les assets)string[]
Images clés image-vers-vidéo, 1~10, URL http(s) publique ou base64
string
Vidéo d’entrée pour la continuation (mp4, URL publique ou base64)
string[]
Identique à
video_url ; utilise le premier élément (compat)boolean
défaut:"true"
Générer l’audio synchronisé, par défaut
true. false produit une vidéo muette (pas de remise)boolean
défaut:"false"
Mode brouillon : aperçu basse qualité à ~1/3 du prix ; uniquement avec
resolution: hdstring
Brouillon → final : ID de votre tâche brouillon réussie
- Seule
resolutionpeut changer ; prompt, durée, images, vidéo ne le peuvent pas - Facturé au prix final plein ; les frais de brouillon ne sont pas crédités
- Mutuellement exclusif avec
draft:true
integer
défaut:"2"
Tolérance de modération 0~4, par défaut
2 (plus élevé = plus permissif)Ne pas confondre avec les images FLUX.2 (05) ou Kontext (06).
string
Mode explicite (optionnel) ; voir Modes de génération
Mode brouillon
Flux en deux étapes lorsque l’itération est coûteuse :Créer un brouillon
Brouillon vers final
Exemples de requêtes
Texte-vers-vidéo (portrait)
Image-vers-vidéo (début + fin)
Continuation vidéo
Vidéo muette
Contraintes
Erreurs de soumission courantes (généralement non facturées)
Les échecs de modération se terminent en
failed avec remboursement intégral.
Couverture des capacités
Response
integer
Code de statut ; 200 en cas de succès
array
Tableau de données de la réponse
Consulter les résultatsLa génération vidéo est asynchrone. Interrogez Obtenir le statut d’une tâche.Intervalle recommandé 5~10 secondes ; timeout client 15 minutes (20s fhd est plus lent). Mesuré ~60s pour
t2v + hd + 5s.En cas de succès, utilisez result.videos[0].url ; les assets sont mis en miroir sur le CDN de la plateforme. cost est le montant final facturé. Les échecs sont entièrement remboursés.