Passer au contenu principal
POST
/
v3
/
async
/
veo-3.1-generate-img2video
Veo 3.1 image-vers-vidéo
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "last_image": "<string>",
  "reference_images": [
    {
      "image": "<string>",
      "reference_type": "<string>"
    }
  ],
  "aspect_ratio": "<string>",
  "duration_seconds": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "person_generation": "<string>",
  "resolution": "<string>",
  "sample_count": 123,
  "seed": {}
}
'
{
  "task_id": "<string>"
}
L’API de la version Veo 3.1 Preview est automatiquement compatible avec cette interface
Utilisez le modèle de génération vidéo Veo 3.1 pour générer du contenu vidéo de haute qualité à partir d’une image d’entrée et d’une description textuelle. Cette interface utilise un traitement asynchrone ; vous devez interroger le résultat final généré via le task_id.

​
En-têtes de requête

​
Content-Type
string
requis
Valeur d’énumération : application/json
​
Authorization
string
requis
Format d’authentification Bearer : Bearer {{API Key}}.

​
Corps de la requête

​
prompt
string
requis
Chaîne de texte décrivant la vidéo que vous souhaitez générer.
​
image
string
Image d’entrée, prise en charge sous forme d’URL ou d’encodage base64.
​
last_image
string
Image de fin, utilisée pour remplir la dernière image de la vidéo. Prise en charge sous forme d’URL ou d’encodage base64.
​
reference_images
object[]
Liste de jusqu’à trois images asset ou jusqu’à une image style, utilisée pour décrire les images de référence que le modèle doit utiliser lors de la génération de la vidéo.
​
aspect_ratio
string
Spécifie le rapport largeur/hauteur de la vidéo générée.Valeurs d’énumération : 16:9, 9:16. La valeur par défaut est 16:9.
​
duration_seconds
integer
Longueur du fichier vidéo que vous souhaitez générer (en secondes).Valeurs d’énumération : 4, 6, 8 ; lorsque reference_images est utilisé, seule la valeur 8 est possible.La valeur par défaut est 8.
​
enhance_prompt
boolean
Spécifie s’il faut utiliser Gemini pour améliorer votre prompt. Seule la valeur true est prise en charge.Valeur par défaut : true
​
generate_audio
boolean
requis
Spécifie s’il faut générer de l’audio pour la vidéo.
​
negative_prompt
string
Chaîne de texte décrivant le contenu que vous souhaitez empêcher le modèle de générer.
​
person_generation
string
Paramètre de sécurité qui contrôle l’autorisation de générer des personnes ou des visages.Valeurs d’énumération :
  • allow_adult (par défaut) : autorise uniquement la génération d’adultes
  • dont_allow : n’autorise pas la présence de personnes ou de visages dans l’image
  • allow_all : autorise la génération de personnes de tous âges (le projet doit être dans l’allowlist)
​
resolution
string
Résolution de la vidéo générée.Valeurs d’énumération : 720p (par défaut) ou 1080p
​
sample_count
integer
Nombre d’échantillons vidéo à générer.Plage de valeurs : 1-4
​
seed
uint32
Nombre utilisé pour initialiser le processus de génération aléatoire. L’utilisation de la même graine, du même prompt et des autres mêmes paramètres produira la même vidéo de sortie, rendant le processus de génération déterministe.Plage de valeurs : 0-4,294,967,295

​
Paramètres des informations de réponse

​
task_id
string
requis
Le task_id de la tâche asynchrone. Vous devez utiliser ce task_id pour appeler l’API de consultation du résultat de tâche afin d’obtenir le résultat généré