Passer au contenu principal
POST
/
v3
/
veo-3.1-fast-generate-img2video
Veo 3.1 Fast image vers vidéo
curl --request POST \
  --url https://api.highwayapi.ai/v3/veo-3.1-fast-generate-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "last_image": "<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 désormais automatiquement compatible avec cette interface.
Utilisez le modèle de génération vidéo Veo 3.1 Fast pour créer du contenu vidéo de haute qualité à partir d’une image en 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 énumérée : 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, prenant en charge les formats URL ou encodé en base64.
last_image
string
Image de fin, utilisée pour remplir la dernière image de la vidéo. Prend en charge les formats URL ou encodé en base64.
aspect_ratio
string
Spécifie le rapport hauteur/largeur de la vidéo générée.Valeurs énumérées : 16:9, 9:16. La valeur par défaut est 16:9.
duration_seconds
integer
Durée du fichier vidéo que vous souhaitez générer (en secondes).Valeurs énumérées : 4, 6, 8. La valeur par défaut est 8.
enhance_prompt
boolean
Indique 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
Indique 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é contrôlant si la génération de personnes ou de visages est autorisée.Valeurs énumérées :
  • allow_adult (par défaut) : autorise uniquement la génération d’adultes
  • dont_allow : n’autorise pas les personnes ou les visages dans l’image
  • allow_all : autorise la génération de personnes de tous âges (le projet doit figurer dans l’allowlist)
resolution
string
Résolution de la vidéo générée.Valeurs énumérées : 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 mêmes autres paramètres produit la même vidéo de sortie, ce qui rend le processus de génération déterministe.Plage de valeurs : 0-4,294,967,295

Paramètres de réponse

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