curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo-3.1-lite-generate-preview",
  "prompt": "A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-lite-generate-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 600,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 12.24,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: veo-3.1-lite-generate-preview",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Veo3.1

Génération vidéo Veo3.1-Lite

Veo 3.1 Lite est le niveau économique de Veo 3.1 : texte vers vidéo et image vers vidéo avec première image / première et dernière images ; pas d’images de référence ni de 4k
Facturé à la seconde de vidéo générée ; le tarif dépend de la résolution et de la génération audio, voir les tarifs des modèles EvoLink
Traitement asynchrone : utilisez l’ID de tâche renvoyé pour consulter son état
Les liens vidéo générés sont valides pendant 24 heures, veuillez les enregistrer rapidement

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo-3.1-lite-generate-preview",
  "prompt": "A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo-3.1-lite-generate-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "processing",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 600,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 12.24,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: veo-3.1-lite-generate-preview",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

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:veo-3.1-lite-generate-preview

requis

Nom du modèle de génération vidéo. Ce modèle n'accepte pas image_start, image_end ni model_params (réponse 400)

Options disponibles:

veo-3.1-lite-generate-preview

Exemple:

"veo-3.1-lite-generate-preview"

prompt

string

requis

Prompt décrivant la vidéo, jusqu’à 2000 tokens. Comptés avec cl100k ; les tokens ne sont pas des caractères. Google indique l’anglais comme langue de prompt prise en charge. EvoLink ne rejette pas les requêtes selon la langue du prompt ; les résultats dans d’autres langues ne sont pas garantis.

Exemple:

"A golden retriever puppy running through a sunlit meadow, slow motion, cinematic lighting"

image_urls

string<uri>[]

URLs des images d'entrée pour image-vers-vidéo

Remarques :

Maximum 2 images par requête : 1 image est utilisée comme première image, 2 images comme première et dernière images
Taille d'image : pas plus de 10 MB
Formats de fichier pris en charge : .jpg, .jpeg, .png

Maximum array length: 2

Exemple:

["https://example.com/first-frame.jpg"]

generation_type

enum<string>

Mode de génération. S'il est omis, il est déduit du nombre d'images :

TEXT : Texte vers vidéo (les images envoyées ne sont pas utilisées)
FIRST&LAST : Première-dernière image, 1-2 images

REFERENCE (image de référence) n'est pas pris en charge par ce modèle et renvoie 400

Options disponibles:

TEXT,

FIRST&LAST

aspect_ratio

enum<string>

Rapport d'aspect de la vidéo. auto équivaut à omettre aspect_ratio : aucun rapport n'est imposé, le modèle décide

Options disponibles:

auto,

16:9,

9:16

generate_audio

boolean

défaut:true

Générer l'audio, par défaut true. La génération audio augmente le prix par seconde

duration

enum<integer>

défaut:4

Durée de la vidéo en secondes, par défaut 4. Les vidéos plus longues coûtent plus cher

Options disponibles:

4,

6,

8

integer

défaut:1

Nombre de vidéos à générer, par défaut 1. Chaque vidéo est facturée séparément

Plage requise: 1 <= x <= 4

quality

enum<string>

défaut:720p

Résolution de sortie, par défaut 720p. 1080p a un prix par seconde plus élevé ; 4k n'est pas pris en charge par ce modèle

Options disponibles:

720p,

1080p

seed

integer

Graine aléatoire pour reproduire les résultats de génération

Plage requise: 1 <= x <= 4294967295

negative_prompt

string

Prompt négatif décrivant le contenu à exclure de la vidéo

person_generation

enum<string>

Contrôle de la génération de personnes. Si le paramètre est omis, la valeur par défaut du fournisseur est allow_adult. allow_adult : autoriser uniquement les adultes ; dont_allow : ne pas générer de vidéos contenant des personnes ou des visages

Options disponibles:

allow_adult,

dont_allow

resize_mode

enum<string>

Mode d’ajustement de l’image pour la génération image-vers-vidéo. Si le paramètre est omis, la valeur par défaut du fournisseur est pad. pad : ajouter des marges pour adapter l’image au format de sortie ; crop : effectuer un recadrage centré pour l’adapter. Une image d’entrée est requise ; fournir ce paramètre sans image renvoie 400

Options disponibles:

pad,

crop

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 ou échoué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 octets UTF-8

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 creation de la tache

Exemple:

1757169743

string

ID de la tache

Exemple:

"task-unified-1757169743-7cvnl5zw"

model

string

Nom du modele effectivement utilise

Exemple:

"veo-3.1-lite-generate-preview"

object

enum<string>

Type specifique de la tache

Options disponibles:

video.generation.task

progress

integer

Pourcentage de progression de la tache (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tache

Options disponibles:

pending,

processing,

completed,

failed

Exemple:

"processing"

task_info

object

Informations detaillees de la tache video

Show child attributes

type

enum<string>

Type de sortie de la tache

Options disponibles:

text,

image,

audio,

video

Exemple:

"video"

usage

object

Informations d'utilisation et de facturation

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Génération vidéo Veo3.1-Lite

Autorisations

Corps

Réponse