Skip to main content
POST

Authentification

string
requis
Toutes les requêtes nécessitent une authentification par Bearer Token.Obtenir une clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé API.Ajoutez l’en-tête suivant lors de l’envoi des requêtes :

Paramètres de la requête

string
requis
Nom du modèle de génération vidéo. Doit être Omni-Flash-Ext.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description du contenu de la vidéo. Nous recommandons de décrire en détail la scène, le sujet, l’action, l’environnement, les mouvements de caméra, le style visuel et les indices sonores.Exemple : "a girl is dancing happily in a sunny garden"
integer
défaut:"6"
Durée de la vidéo en secondes.Valeurs prises en charge : 4, 6, 8, 10.
D’autres valeurs telles que 5 ou 7 renvoient une erreur invalid_duration.
Ne transmettez pas duration lorsque vous importez une vidéo de référence. duration et video_urls ne peuvent pas être transmis en même temps.
string
défaut:"720p"
Résolution de la vidéo. Les valeurs sont insensibles à la casse.Valeurs prises en charge :
  • 720p
  • 1080p
  • 4k
D’autres résolutions renvoient une erreur invalid_resolution.
string
défaut:"16:9"
Format d’image de la vidéo. Utilisez-le pour contrôler la sortie en paysage ou en portrait.Valeurs courantes :
  • 16:9 — paysage
  • 9:16 — portrait
Par défaut : 16:9
string
Champ de compatibilité. Il a la même signification que aspect_ratio. Si les deux sont fournis, maintenez-les cohérents.
string
Type de génération, utilisé pour spécifier la manière dont les images sont utilisées.Options :
  • frame - Mode première image. image_urls ne peut contenir qu’1 image, utilisée comme première image de la vidéo.
  • reference - Mode référence. image_urls peut contenir 1 ou 3 images, utilisées comme images de référence.
Lorsque generation_type est frame, image_urls ne prend en charge qu’1 image ; transmettre toute autre quantité renvoie une erreur unsupported_image_count.
array<url>
Tableau d’URL d’images de référence. Vous pouvez l’omettre, fournir 1 image ou 3 images, selon generation_type :
  • Omis ou tableau vide : Text-to-Video
  • 1 image : Image-to-Video à image unique
  • 3 images : fusion d’images de référence (pris en charge uniquement lorsque generation_type est reference)
Relation avec generation_type :
  • generation_type est frame : seule 1 image peut être téléchargée.
  • generation_type est reference : 1 ou 3 images peuvent être téléchargées.
Seules les URL d’images publiquement accessibles sont prises en charge.
Le mode « première image + dernière image » avec 2 images n’est pas pris en charge. La transmission de 2 images renvoie une erreur unsupported_image_count. 4 images ou plus n’ont pas été entièrement vérifiées et ne sont pas recommandées.
array<url>
Tableau d’URL de vidéos de référence. Vous pouvez l’omettre ou fournir 1 vidéo de référence.Seules les URL vidéo HTTP/HTTPS publiquement accessibles sont prises en charge. Vous pouvez le transmettre avec image_urls : les images servent de références d’identité ou de composition, tandis que la vidéo sert de référence de mouvement.
Omni-Flash-Ext ne prend en charge que 0 ou 1 vidéo de référence. La transmission de 2 vidéos ou plus renvoie une erreur unsupported_video_count.
Ne transmettez pas duration lorsque vous transmettez video_urls. video_urls et duration ne peuvent pas être transmis en même temps.

Réponse

integer
Code de statut de la réponse. Les requêtes réussies renvoient 200.
array
Tableau de tâches renvoyé.

Interroger le résultat de la tâche

La génération vidéo est asynchrone. Après la soumission, l’API renvoie un task_id. Utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats.
cURL
Nous recommandons d’attendre 5 à 10 secondes après la soumission avant la première interrogation, puis d’interroger toutes les 5 à 10 secondes. Une tâche unique s’achève généralement en environ 3 à 5 minutes.

Exemple de résultat réussi

Exemple de résultat échoué

Cas d’usage

Scénario 1 : Texte vers vidéo

Scénario 2 : vidéo à image unique

Scénario 3 : fusion de 3 images de référence

Scénario 4 : courte vidéo 4K

Scénario 5 : génération avec vidéo de référence

Codes d’erreur

Lorsqu’une tâche échoue, l’API de statut de tâche renvoie la raison de l’échec dans data.error. Les causes courantes incluent l’épuisement temporaire du quota en amont, l’échec de la modération du contenu ou un délai d’attente en amont.