Passer au contenu principal
POST
/
v1
/
videos
/
generations
Interface veo3.1-pro
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo3.1-pro-beta",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo3.1-pro-beta",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 180,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 25.7,
    "user_group": "default"
  }
}

Autorisations

​
Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json
​
model
enum<string>
défaut:veo3.1-pro-beta
requis

Nom du modèle de génération vidéo

Rétrocompatible : Le nom de modèle précédemment intégré veo3.1-pro reste utilisable et est automatiquement mappé vers veo3.1-pro-beta

Options disponibles:
veo3.1-pro-beta
Exemple:

"veo3.1-pro-beta"

​
prompt
string
requis

Invite décrivant quel type de vidéo générer, limitée à 2000 tokens

Maximum string length: 2000
Exemple:

"A cat playing piano"

​
aspect_ratio
enum<string>
défaut:auto

Rapport d'aspect vidéo. Lorsque défini sur auto : image-vers-vidéo sélectionnera automatiquement en fonction du rapport de l'image d'entrée, texte-vers-vidéo sélectionnera automatiquement en fonction du contenu de l'invite

Options disponibles:
auto,
16:9,
9:16
Exemple:

"auto"

​
image_urls
string<uri>[]

Liste d'URL d'images de référence pour la fonctionnalité image vers vidéo

Remarque :

  • Une seule requête prend en charge jusqu'à 2 images (1 image pour la génération vidéo première image, 2 images pour la génération vidéo première et dernière image)
  • Taille d'image : pas plus de 10MB
  • Formats de fichiers pris en charge : .jpg, .jpeg, .png, .webp
  • Les URL d'images doivent être directement visibles par le serveur, ou l'URL de l'image doit déclencher un téléchargement direct lors de l'accès (généralement ces URL se terminent par des extensions de fichiers image, telles que .png, .jpg)
Maximum array length: 2
Exemple:
["http://example.com/image1.jpg"]
​
quality
enum<string>

Résolution vidéo, par défaut 720p

Options disponibles:
720p
​
generation_type
enum<string>

Mode de génération vidéo, correspondance par défaut basée sur le nombre d'images, sélection manuelle recommandée. Modes disponibles :

  • TEXT : Texte vers vidéo
  • FIRST&LAST : Première et dernière image vers vidéo, prend en charge 1~2 images
Options disponibles:
TEXT,
FIRST&LAST
​
enhance_prompt
boolean
défaut:true

S'il faut traduire automatiquement le prompt en anglais. Lorsqu'activé, les prompts non anglais seront automatiquement traduits en anglais pour de meilleurs résultats de génération

Exemple:

true

​
callback_url
string<uri>

Adresse de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

  • Déclenché lorsque la tâche est terminée, échouée ou annulée
  • Envoyé après confirmation de la facturation

Restrictions de sécurité :

  • Seul le protocole HTTPS est pris en charge
  • Les rappels vers les adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

  • Délai d'expiration : 10 secondes
  • Maximum 3 tentatives en cas d'échec (tentatives après 1 seconde/2 secondes/4 secondes)
  • Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de requête de tâche
  • Un code de statut 2xx renvoyé par l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative
Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tâche de génération vidéo créée avec succès

​
created
integer

Horodatage de création de la tâche

Exemple:

1757169743

​
id
string

ID de tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"veo3.1-pro-beta"

​
object
enum<string>

Type de tâche spécifique

Options disponibles:
video.generation.task
​
progress
integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100
Exemple:

0

​
status
enum<string>

Statut de la tâche

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"pending"

​
task_info
object

Informations détaillées de la tâche vidéo

​
type
enum<string>

Type de sortie de la tâche

Options disponibles:
text,
image,
audio,
video
Exemple:

"video"

​
usage
object

Informations d'utilisation et de facturation