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, fixé à gemini-omni-flash-preview.
string
requis
Instruction textuelle. Pour le Text-to-Video, il s’agit de la description de la scène ; pour l’Image/Video-to-Video, il s’agit de l’instruction de mouvement / style / édition.
prompt et les éléments de référence (image_urls / video_urls) : fournissez au moins l’un des deux.
array<string>
Images de référence, 16 au maximum. Chaque élément est une URL http(s)://.Prend en charge JPEG / PNG. Pour plusieurs sujets (par exemple « chat + pelote de laine »), vous pouvez transmettre plusieurs images et décrire dans le prompt la manière dont elles interagissent.
array<string>
Vidéo de référence / à éditer, 1 au maximum (les références multi-vidéos ne sont pas prises en charge). Il peut s’agir d’un lien direct http(s):// ou de data:video/....
  • La vidéo de référence dure de 1 à 24 secondes ; recommandation officielle : ≤3 secondes.
  • video_urls et extend_from_task_id sont mutuellement exclusifs ; n’en fournissez qu’un seul, pas les deux à la fois.
string
défaut:"16:9"
Format d’image de la vidéo, qui contrôle réellement l’orientation de la sortie.
Lorsque video_urls est fourni, le paramètre aspect_ratio n’est pas pris en compte.
Prend uniquement en charge :
  • 16:9 - paysage (par défaut)
  • 9:16 - portrait
Les autres valeurs sont traitées comme 16:9.
string
défaut:"720p"
Résolution de la vidéo. Actuellement, seul 720p est pris en charge.
string
Identifiant de la tâche précédente : indiquez le ** task_id** de la tâche de génération précédente.
extend_from_task_id et video_urls sont mutuellement exclusifs ; n’en fournissez qu’un seul, pas les deux à la fois.

Réponse

integer
Code de statut de la réponse. En cas de succès, il vaut 200.
array
Tableau de tâches renvoyé.

Interroger le résultat de la tâche

La génération vidéo est une tâche asynchrone. Après la soumission, un task_id est renvoyé ; utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et le résultat de la génération.

Exemple de résultat réussi

Cas d’usage

Scénario 1 : Text-to-Video

Scénario 2 : Image-to-Video

Scénario 3 : Video-to-Video