Documentation de l’API Veo 3.1

Guide complet pour intégrer la génération vidéo par IA de Google dans vos applications.

Guide de démarrage rapide

Démarrez avec l’API Veo 3.1 en quelques minutes.

1

Obtenez votre clé API

Vous devez d’abord obtenir une clé API depuis votre tableau de bord.

2

Effectuez votre première requête

1curl -X POST "https://veo3api.com/generate" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "prompt": "a dog running",
6 "model": "veo4",
7 "duration": 5,
8 "resolution": "720p"
9 }'
3

Vérifier l’état de la génération

La génération vidéo est asynchrone. Utilisez le point de terminaison https://veo3api.com/feed pour vérifier l’état, ou fournissez une

cURL
1curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Référence de l’API

Référence complète de tous les points de terminaison, paramètres et formats de réponse de l’API Veo 3.1.

URL de base

https://veo3api.com

Les points de terminaison n’utilisent pas de préfixe /api — appelez https://veo3api.com/ (par exemple https://veo3api.com/generate).

Authentification

Toutes les requêtes API nécessitent une authentification via un jeton Bearer dans l’en-tête Authorization.

Authorization: Bearer YOUR_API_KEY
POSThttps://veo3api.com/generate

Générer une vidéo à partir d’un prompt texte ou image

Corps de la requête

ParamètreTypeRequisDescription
promptstring*Le prompt texte pour la génération vidéo
modelstring*Choisissez veo3 (haute qualité, 180 crédits), veo3-fast (génération rapide, 25 crédits) ou veo4 (tarif selon la durée et la résolution ; voir le tableau ci-dessous)
durationintegerDurée de Veo 4 : 5, 10 ou 15 secondes (par défaut : 5)
resolutionstringRésolution de sortie Veo 4 : 480p, 720p (par défaut) ou 1080p
aspect_ratiostringFormat d’image : 16:9 (par défaut, 1080P HD), 9:16 (portrait) ou Auto (adapter à l’image)
image_urlsstring[]Tableau d’URL d’images pour la génération image-vers-vidéo
watermarkstringTexte de filigrane personnalisé. Définissez sur null pour aucun filigrane

Exemple de requête

JSON
1{
2 "prompt": "a dog running",
3 "model": "veo4",
4 "duration": 5,
5 "resolution": "720p",
6 "aspect_ratio": "16: 9"
7}

Réponse

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd20",
6 "status": "IN_PROGRESS",
7 "consumed_credits": 240,
8 "model": "veo4"
9 }
10}

Consommation de crédits

Type de modèleCréditsCoût
veo3-fast25 credits$0.25
veo3180 credits$1.80
veo4480p · 5s / 10s / 15s160 / 320 / 480 credits$1.60 / $3.20 / $4.80
veo4720p · 5s / 10s / 15s240 / 480 / 720 credits$2.40 / $4.80 / $7.20
veo41080p · 5s / 10s / 15s360 / 720 / 1080 credits$3.60 / $7.20 / $10.80
extendIdentique à l’original-
get-1080pGratuit$0.00

Le tarif de Veo 4 dépend de la durée et de la résolution ; le texte-vers-vidéo et l’image-vers-vidéo utilisent le même tarif.

Remarque : les crédits sont débités uniquement lorsque la génération vidéo est terminée avec succès. Les tâches échouées ne consomment pas de crédits.

GEThttps://veo3api.com/feed

Vérifier l’état d’une tâche de génération vidéo

Exemple de requête

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

Réponse

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "request": {
6 "prompt": "a dog running",
7 "model": "veo4",
8 "duration": 5,
9 "resolution": "720p",
10 "aspect_ratio": "16: 9"
11 },
12 "response": [
13 "https://cdn.veo3api.com/video/example_watermarked.mp4"
14 ],
15 "status": "COMPLETED",
16 "consumed_credits": 240,
17 "type": "text-to-video",
18 "model": "veo4",
19 "created_at": "2025-10-29 12: 20: 46"
20 }
21}

💡 Astuce : l’URL de la vidéo générée peut être obtenue depuis le tableau data.response.

POSThttps://veo3api.com/extend

Étendre une vidéo existante avec un nouveau prompt. La vidéo étendue reprend là où la vidéo originale s’est arrêtée.

Corps de la requête

ParamètreTypeRequisDescription
task_idstring*Le task_id de la vidéo originale terminée à étendre
promptstring*Le prompt texte décrivant comment poursuivre/étendre la vidéo
seedsintegerGraine aléatoire (10000-99999) pour une génération reproductible. La même graine produit des résultats similaires
watermarkstringTexte de filigrane personnalisé. Définissez sur null pour aucun filigrane

Exemple de requête

JSON
1{
2 "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
3 "prompt": "The dog continues running and jumps over a fence",
4 "watermark": "veo"
5}

Réponse

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
6 "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
7 "credits_consumed": 25
8 }
9}

Remarque : ce point de terminaison prend uniquement en charge les tâches veo3 et veo3-fast terminées. Il n’est pas disponible pour les tâches Veo 4 ; les vidéos converties en 1080P ne peuvent pas non plus être étendues.

GEThttps://veo3api.com/get-1080pGratuit

Obtenir la version haute définition 1080P d’une tâche vidéo terminée. Ce point de terminaison est gratuit et ne consomme aucun crédit.

Exemple de requête

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

Réponse

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
6 "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
7 }
8}

💡 Astuce : ce point de terminaison prend uniquement en charge les tâches veo3 et veo3-fast terminées. Il est gratuit et ne consomme aucun crédit. Veo 4 peut être généré directement en 1080p.

Codes de statut HTTP

Code de statutDescription
200Requête réussie
400Mauvaise requête - Paramètres invalides
401Non autorisé - Clé API invalide
429Limite de taux dépassée
500Erreur interne du serveur