Skip to main content
POST

Autorisation

string
requis
Tous les points de terminaison de l’API nécessitent une authentification par Bearer TokenObtenez votre API Key :Rendez-vous sur la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la dans l’en-tête de la requête :

Paramètres de la requête

string
requis
Nom du modèle de génération vidéoModèles disponibles :
  • veo3.1-fast-official — Veo 3.1 Official Fast
  • veo3.1-quality-official — Veo 3.1 Official High Quality
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
Prompt textuel positifDécrivez en détail les scènes, les actions, les styles, etc. pour de meilleurs résultats. Les prompts en anglais sont recommandés.Exemple : "a golden retriever running on the beach, sunset, cinematic"
string
Prompt négatif pour exclure le contenu indésirableExemple : "blurry, low quality, watermark, text"
integer
défaut:"8"
Durée de la vidéo en secondesValeurs recommandées : 4 / 6 / 8Par défaut : 8Remarque : doit être un nombre pur (par ex. 8), n’ajoutez pas de guillemets, sinon une erreur se produira
string
défaut:"16:9"
Rapport d’aspect de la vidéoValeurs disponibles :
  • 16:9 — paysage
  • 9:16 — portrait
Par défaut : 16:9
string
défaut:"720p"
Résolution de la vidéoValeurs disponibles :
  • 720p — résolution standard
  • 1080p — haute définition
  • 4K — ultra haute définition
Par défaut : 720p
string
URL de l’image de la première image pour la génération image-vers-vidéo
  • L’URL de l’image doit être accessible publiquement, sans protection anti-hotlink
  • Il est recommandé d’utiliser des URL de stockage d’objets plutôt que des liens de téléchargement temporaires
string
URL de l’image de la dernière image pour la génération image-vers-vidéoUtilisée avec first_frame_image pour contrôler la première et la dernière image
integer
Seed aléatoire pour reproduire les résultats de générationPlage de valeurs : 04294967295
integer
défaut:"1"
Nombre d’échantillons à générer (1-4), il est actuellement recommandé d’utiliser 1Par défaut : 1
boolean
défaut:"false"
Générer ou non une piste audio
string
défaut:"allow_adult"
Politique de génération de personnesValeurs disponibles :
  • allow_adult — n’autoriser que la génération de personnes/visages adultes
  • disallow — ne pas autoriser la génération de personnes ou de visages
Par défaut : allow_adult
string
défaut:"pad"
Stratégie de redimensionnement de l’image (effective pour image-vers-vidéo)Valeurs disponibles :
  • pad — mode de remplissage
  • crop — mode de recadrage
Par défaut : pad
boolean
défaut:"true"
Activer ou non l’amélioration du prompt en amontPar défaut : true
  • Ce paramètre ne peut être défini que sur true. Le définir sur false provoquera une erreur de requête
  • Si vous n’avez pas besoin de ce paramètre, ne l’incluez pas

Texte-vers-vidéo vs image-vers-vidéo

Le système détermine automatiquement le mode selon que des paramètres d’image sont fournis ou non : sans image pour texte-vers-vidéo, avec image pour image-vers-vidéo.

Réponse

integer
Code d’état de la réponse, 200 en cas de succès
array
Tableau de données de la réponse

Scénarios d’utilisation

Scénario 1 : texte-vers-vidéo (basique)

Scénario 2 : texte-vers-vidéo (paramètres complets)

Scénario 3 : image-vers-vidéo (une seule première image)

Scénario 4 : image-vers-vidéo (première image + dernière image)

Scénario 5 : vidéo avec audio

Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.