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.

Obtenez votre clé API

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

Effectuez votre première requête

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo3-fast",
    "watermark": "veo"
  }'

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

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -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ètre	Type	Requis	Description
`prompt`	string	*	Le prompt texte pour la génération vidéo
`model`	string	*	Choisissez entre veo3 (haute qualité, 180 crédits) ou veo3-fast (génération rapide, 25 crédits)
`aspect_ratio`	string		Format d’image : 16:9 (par défaut, 1080P HD), 9:16 (portrait) ou Auto (adapter à l’image)
`image_urls`	string[]		Tableau d’URL d’images pour la génération image-vers-vidéo
`watermark`	string		Texte de filigrane personnalisé. Définissez sur null pour aucun filigrane

Exemple de requête

JSON

{
  "prompt": "a dog running",
  "model": "veo3-fast",
  "watermark": "veo"
}

Réponse

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
  }
}

Consommation de crédits

Type de modèle	Crédits	Coût
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`extend`	Identique à l’original	-
`get-1080p`	Gratuit	$0.00

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

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo3-fast",
      "watermark": "veo"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

💡 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ètre	Type	Requis	Description
`task_id`	string	*	Le task_id de la vidéo originale terminée à étendre
`prompt`	string	*	Le prompt texte décrivant comment poursuivre/étendre la vidéo
`seeds`	integer		Graine aléatoire (10000-99999) pour une génération reproductible. La même graine produit des résultats similaires
`watermark`	string		Texte de filigrane personnalisé. Définissez sur null pour aucun filigrane

Exemple de requête

JSON

{
  "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

Réponse

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Remarque : seules les tâches vidéo terminées peuvent être étendues. Les vidéos converties en 1080P ne peuvent pas ê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

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 Astuce : ce point de terminaison est entièrement gratuit. Vous pouvez obtenir la version 1080P de toute vidéo terminée sans consommer de crédits.

Codes de statut HTTP

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