API Veo 3.1 — le texte-vers-vidéo de Google avec audio natif, compatible OpenAI (2026)

Veo 3 est le modèle texte-vidéo de Google, et l’API Veo 3 génère des clips cinématographiques — avec un audio natif et synchronisé — à partir d’un prompt textuel ou d’une image fixe. Kunavo fournit toute la famille (veo-3-lite, veo-3 Fast et veo-3-quality) via l’endpoint vidéo de style OpenAI, avec un seul bearer token et à environ 50–70 % sous le tarif catalogue de Google.

Appeler l’API Veo 3

Générez une clé sur /app/keys et envoyez une requête POST à /v1/video/generations. La génération prend quelques minutes ; l’appel synchrone maintient donc la connexion jusqu’à ce que le clip soit prêt :

import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",                 # Fast tier; also veo-3-lite / veo-3-quality
        "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
        "aspect_ratio": "16:9",
        "resolution": "720p",
    },
    timeout=600,  # Veo 3 generation takes minutes
)
print(resp.json()["data"][0]["url"])

Le même appel avec curl :

curl https://api.kunavo.com/v1/video/generations \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "model": "veo-3",
    "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Si le reste de votre base de code utilise déjà le SDK OpenAI, vous pouvez conserver un seul client pour tout — le chat, les images et la vidéo partagent la clé et le base_url :

# Already using the OpenAI SDK? Keep it — only base_url changes.
# Video isn't in the OpenAI SDK surface, so reuse its client for auth/config
# and post to the video route directly.
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

resp = client.post(
    "/video/generations",
    body={"model": "veo-3", "prompt": "a neon-lit alley in the rain"},
    cast_to=object,
    options={"timeout": 600.0},
)
print(resp["data"][0]["url"])

duration (en secondes) définit la durée du clip pour les modèles facturés à la seconde : les modèles Seedance et le modèle Wan 2.7. Les modèles Veo l’ignorent ; chaque clip Veo dure 8 secondes et est facturé par vidéo.

Les URL renvoyées sont permanentes. Les paramètres complets (resolution, aspect_ratio, image_urls, image_mode) figurent dans la référence de l’API vidéo.

Sur Kunavo, Veo n’a ni paramètre de seed ni paramètre de prompt négatif. Si une requête en envoie un, ce paramètre est ignoré.

Niveaux et tarification

Veo 3 propose trois niveaux de qualité. Les tarifs par vidéo ci-dessous concernent un clip de 8 secondes en 720p ; le 1080p et la 4K sont plus chers. Les tarifs actuels figurent sur la page de chaque modèle.

Génération de vidéo à partir d’images

Passez image_url pour animer une image fixe — utile pour conserver la cohérence d’un produit ou d’un personnage. Passez une première et une dernière image pour contrôler les transitions.

# Image-to-video: animate a still by passing image_url
requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "slow parallax, gentle wind through the grass",
        "image_url": "https://your-cdn.com/keyframe.png",
    },
    timeout=600,
)

Asynchrone en production

Ne maintenez pas une connexion de plusieurs minutes à grande échelle. Soumettez une tâche à /v1/videos, récupérez un identifiant de tâche, puis interrogez GET /v1/videos/{id} jusqu’à son achèvement — avec des clés d’idempotence et des webhooks facultatifs. La boucle complète figure dans la documentation vidéo.

Rédiger des prompts pour Veo 3

• Décrivez le plan, pas seulement le sujet — le mouvement de caméra (travelling, panoramique, rapprochement), le rendu de l’objectif, l’éclairage et le rythme sont les éléments les plus importants.
• Misez sur l’audio — Veo 3 génère le son ; indiquez donc l’ambiance ou les effets souhaités.
• Définissez explicitement le format — 16:9 pour le paysage, 9:16 pour le vertical/social.
• Chaque clip Veo dure 8 secondes — prévoyez chaque plan pour cette durée et assemblez plusieurs générations pour les séquences plus longues.

Kunavo face à un appel direct à Google

Veo 3 est également disponible directement via l’API Gemini et Vertex AI. Cette voie convient si vous avez besoin du SLA et du contrat d’assistance propres à Google. Voici le compromis, en toute transparence :

En bref : Kunavo l’emporte sur le temps de configuration, le prix unitaire et l’utilisation d’une seule clé pour toutes les modalités. Google en direct l’emporte lorsque vous avez besoin d’une garantie de quota ou d’un accord d’entreprise.

Veo 3 face à Sora et Kling

Veo 3 est aujourd’hui le modèle texte-vidéo généralement disponible le plus performant, et le seul actuellement disponible sur Kunavo. Sora et Kling sont prévus sur le même endpoint — consultez le guide de l’API texte-vidéo pour le panorama des modèles, ainsi que les guides API Sora et API Kling pour ces familles.

Vous choisissez entre les modèles vidéo en fonction du prix plutôt que de cette seule famille ? La comparaison des API de génération vidéo tarifie les huit modèles sur la base du même clip de 8 secondes en 720p.

Questions fréquentes