Skip to main content
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 dans image_urls est sémantique — ne pas trier ni dédupliquer :

Paramètres de la requête

string
requis
Valeur fixe : flux-3-video
string
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 5
duration: "auto" n’est pas pris en charge (la facturation nécessite un nombre de secondes fixe). Omise, "auto", ou non-entiers → traités comme 5 secondes sans erreur et sans longueur adaptative.
Pour 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 aussi 720p)
  • fhd (accepte aussi 1080p)
Mesuré : hd ~1280×704 en 16:9 ; fhd ~1920×1088.
Le mode brouillon (draft:true) n’autorise que hd.
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: hd
string
Brouillon → final : ID de votre tâche brouillon réussie
  • Seule resolution peut 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

Le passage brouillon → final re-rend en qualité pleine avec les paramètres enregistrés du brouillon (mode / prompt / seed / assets). Les brouillons de continuation sont finalisés aux tarifs finaux de continuation.

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.