Accès à l’API Veo semble simple si vous ne lisez que le nom du modèle. En production, il s’agit d’un flux de travail vidéo avec des vérifications du cycle de vie du modèle, une tarification à la seconde, des opérations asynchrones, des choix de résolution, des coûts de retry et une observabilité au niveau des routes. Si votre équipe compare Veo avec Seedance, des routes de type Sora ou un autre modèle vidéo derrière une seule passerelle, traitez l’accès comme une checklist plutôt que comme un simple remplacement d’API en une ligne.
Ce guide a été vérifié le 17 juin 2026, heure d’Asia/Shanghai, par rapport à la documentation vidéo Veo de l’API Gemini de Google, à la table de tarification de Veo 3.1 de Google, à une exécution récente d’Ahrefs MCP et à un instantané en direct du catalogue tarifaire Flatkey. L’objectif n’est pas d’affirmer que chaque route est prête pour la production aujourd’hui. L’objectif est de montrer exactement ce qu’il faut vérifier avant d’envoyer des tâches vidéo facturables via un routeur multi-fournisseurs.
Réponse rapide : quoi vérifier pour l’accès à l’API Veo
Avant d’approuver l’accès à l’API Veo pour du trafic de production, confirmez ces sept points :
- ID de modèle officiel : décidez si le workflow a besoin de
veo-3.1-generate-preview,veo-3.1-fast-generate-previewouveo-3.1-lite-generate-preview. - Statut du cycle de vie : évitez les anciens IDs Veo 3.0 et Veo 2.0, sauf si vous gérez une migration courte, car Google les prévoit pour une fermeture au 30 juin 2026.
- Unité de tarification : normalisez Veo par secondes, résolution et variante avant de le comparer avec des fournisseurs vidéo basés sur des jetons/des packs de ressources.
- Chemin de tâche asynchrone : journalisez le nom de l’opération, l’état de sondage, le nombre final de vidéos, la durée, la résolution, le nombre de tentatives et la raison de l’échec.
- Ligne de catalogue Flatkey : vérifiez la ligne exacte du modèle, la famille d’endpoint, le groupe, l’étiquette de prix et le statut de disponibilité le jour où vous acheminez le trafic.
- Règle de repli : décidez quand une tâche Veo échouée peut basculer vers un autre chemin, et quand elle doit échouer en dur pour des raisons de qualité ou de budget.
- Preuve d’utilisation : exécutez un petit test et confirmez que le tableau de bord affiche le modèle sélectionné, la route, le statut, l’unité facturable et le responsable des coûts.
C’est la version pratique de l’accès à l’API Veo : pas seulement « puis-je appeler Veo », mais « puis-je prouver quelle route vidéo a été exécutée, combien cela a coûté et ce qui se passe en cas d’échec ».
Liste de contrôle pour l’accès à l’API Veo
| Élément de la liste de contrôle | Pourquoi c’est important | Preuve à conserver |
|---|---|---|
| ID du modèle | Les variantes de Veo ne sont pas interchangeables en termes de coût, de latence, de résolution ou de prise en charge des routes. | ID officiel du modèle Google ainsi que la ligne Flatkey correspondante. |
| Famille d’endpoint | Une route vidéo peut ne pas se comporter comme une complétion de chat, même si la passerelle expose une surface compatible avec OpenAI. | Type d’endpoint, modèle de requête, paramètres acceptés et structure de réponse. |
| Unité de tarification | Veo est facturé par seconde, tandis que d’autres fournisseurs vidéo peuvent utiliser des tokens, des médias générés ou des packs de ressources. | Variante, résolution, secondes attendues, politique de nouvelle tentative et date de la source du prix. |
| Journalisation des opérations asynchrones | La génération Veo utilise un flux d’envoi puis de polling, donc une seule action utilisateur peut créer plusieurs événements internes. | ID d’opération, tentatives de polling, statut final, métadonnées de la vidéo générée et nombre de nouvelles tentatives. |
| Statut de disponibilité | Une ligne de catalogue n’est pas la même chose qu’une route de production réussie. | Statut du tableau de bord, heure de la dernière vérification, réponse de test et entrée du journal d’utilisation. |
| Périmètre de repli | Changer de modèle vidéo peut modifier le style, la durée, la qualité, le comportement des règles et le coût. | Matrice de repli approuvée et conditions d’échec fermé. |
Confirmez le modèle Veo officiel et son cycle de vie
La documentation de l'API Gemini de Google utilise actuellement veo-3.1-generate-preview dans les exemples de génération Veo. Le tableau des tarifs répertorie trois IDs d'aperçu Veo 3.1 : veo-3.1-generate-preview, veo-3.1-fast-generate-preview et veo-3.1-lite-generate-preview. C'est le premier point de départ pour une vérification de l'accès à l'API Veo, car un catalogue de passerelle peut contenir en même temps des IDs plus anciens, des alias et des libellés spécifiques au fournisseur.
Le cycle de vie est tout aussi important que l'ID actuel. La page de tarification de Google vérifiée pour cet article avertit que les modèles Veo 3 veo-3.0-generate-001 et veo-3.0-fast-generate-001 sont obsolètes et programmés pour être arrêtés le 30 juin 2026. Elle indique également que Veo 2 veo-2.0-generate-001 est obsolète et programmé pour le même arrêt le 30 juin 2026. Si un ancien exemple de code, une route enregistrée ou un favori du tableau de bord pointe encore vers là, considérez cela comme une tâche de migration, et non comme un chemin d'accès validé.
Normalisez la tarification de l’API Veo avant de comparer les options
Pour l’accès à l’API Veo, le prix affiché n’est utile qu’une fois la requête normalisée. La tarification payante actuelle de Veo 3.1 chez Google est indiquée par seconde en USD, avec différentes lignes pour les variantes Standard, Fast et Lite.
| Variante Veo 3.1 | ID officiel du modèle | Tarification vérifiée | Note de planification |
|---|---|---|---|
| Standard | veo-3.1-generate-preview |
0,40 $/sec à 720p ou 1080p ; 0,60 $/sec en 4K. | À utiliser lorsque les exigences de qualité justifient la ligne par défaut plus élevée. |
| Fast | veo-3.1-fast-generate-preview |
0,10 $/sec à 720p ; 0,12 $/sec à 1080p ; 0,30 $/sec en 4K. | Testez la qualité de sortie et la latence avant d’y acheminer des tâches destinées aux utilisateurs. |
| Lite | veo-3.1-lite-generate-preview |
0,05 $/sec à 720p ; 0,08 $/sec à 1080p ; 4K non pris en charge. | Utile pour des brouillons à moindre coût lorsque la 4K n’est pas requise. |
La page de tarification de Google précise également que vous n’êtes facturé que si la vidéo est générée avec succès. Cela ne supprime pas la nécessité d’enregistrer les tentatives. Une opération échouée, une invite modifiée ou une nouvelle exécution demandée par l’utilisateur peuvent toujours créer ultérieurement une autre tâche facturable. Votre liste de contrôle pour l’accès à l’API Veo doit inclure la durée, la résolution, la variante, le statut de réussite et le nombre de tentatives pour chaque requête.
Si vous comparez Veo à d’autres fournisseurs, utilisez la comparaison des tarifs des API de génération vidéo par IA plus large comme point de normalisation. Ne comparez pas directement une ligne Veo au tarif par seconde à un fournisseur basé sur des jetons ou des packs de ressources sans traduire la forme réelle de la requête.
Considérez la génération Veo comme une opération de longue durée
Le guide Veo de Google montre un flux d’opération de longue durée : soumettre la requête de génération, interroger l’opération jusqu’à son achèvement, puis récupérer la vidéo générée. Cela rend l’accès à l’API Veo différent d’une requête texte normale à réponse unique. Votre routeur et votre tableau de bord doivent conserver l’état du job pendant l’interrogation, et pas seulement capturer le premier appel HTTP.
Un journal prêt pour la production devrait répondre à ces questions :
- Quelle application, quelle clé d’équipe, quel environnement et quel workflow ont créé le job vidéo ?
- Quel ID de modèle Veo, quel format d’image, quelle résolution, quel type de prompt et quels médias d’entrée ont été utilisés ?
- Quel ID d’opération ou quel identifiant asynchrone équivalent a été renvoyé ?
- Combien de tentatives d’interrogation ont été effectuées avant l’achèvement ou l’échec ?
- Le job a-t-il réussi, échoué, été annulé, réessayé ou routé ailleurs ?
- Combien de vidéos générées ont été renvoyées, et où la sortie a-t-elle été stockée ?
- Quel enregistrement d’utilisation et quel enregistrement de coût la finance pourra-t-elle rapprocher plus tard ?
C’est aussi là que la compatibilité des points de terminaison doit être réellement testée. Une passerelle peut exposer une URL de base compatible avec OpenAI pour de nombreuses familles de modèles, mais la génération vidéo comporte souvent des champs spécifiques au fournisseur et une sémantique asynchrone. Conservez les extraits de code comme modèles jusqu’à ce que vous ayez testé une clé Flatkey actuelle, une ligne de modèle Veo actuelle et le corps de requête exact que votre application utilisera.
Vérifier les lignes du catalogue Flatkey avant la production
Le catalogue de prix public de Flatkey a été vérifié pour cet article le 17 juin 2026, Asia/Shanghai. La réponse contenait 638 lignes de modèles et la version de tarification a42d372ccf0b5dd13ecf71203521f9d2. Des lignes liées à Veo étaient présentes, notamment des identifiants et alias de style Google tels que veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview, veo3.1, veo3.1-fast et veo3.1-pro.
La mise en garde importante : chaque ligne Veo vérifiée dans cet instantané affichait un statut de disponibilité unknown_failure. Cela signifie que l’article peut utiliser ces lignes comme preuve de catalogue datée, mais ne doit pas prétendre à une disponibilité de production en direct. Le bon flux de travail pour l’accès à l’API Veo consiste à ouvrir la page de tarification Flatkey actuelle, confirmer la ligne exacte, vérifier le libellé du tableau de bord, contrôler la famille de points de terminaison et exécuter un petit test de fumée avant d’envoyer du trafic de production.
| Ligne Flatkey vérifiée | Types de points de terminaison observés | Champs de tarification observés | Statut dans l’instantané |
|---|---|---|---|
veo-3.1-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.4 |
unknown_failure |
veo-3.1-fast-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.15 |
unknown_failure |
veo-3.1-lite-generate-preview |
gemini, openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
veo3.1, veo3.1-fast, veo3.1-pro |
openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
Le texte produit public de Flatkey soutient une histoire de routage prudente : une seule clé API, une tarification claire, une facturation unifiée, un tableau de bord pour les clés, l’utilisation et le routage, ainsi qu’un langage de basculement/équilibrage de charge automatique. Gardez la preuve d’implémentation plus étroite que la promesse marketing. Pour l’accès à l’API Veo, le test d’acceptation doit être un enregistrement réel de requête adossé au tableau de bord, et pas seulement une ligne de catalogue.
Définir des règles de routage vidéo multi-fournisseurs
Le basculement vidéo est plus sensible que le basculement texte. Si une tâche Veo échoue, le passage à un autre fournisseur peut modifier la durée, le style visuel, l’interprétation du prompt, les filtres de contenu, le format de sortie et le prix. Un plan Veo API access doit définir quand le repli automatique est sûr et quand le workflow doit s’arrêter pour une revue humaine.
| Situation | Décision de routage suggérée | Raison |
|---|---|---|
| Erreur transitoire du fournisseur ou délai d’attente dépassé | Réessayer une fois ou basculer vers un parcours équivalent approuvé si le workflow le permet. | Protège l’expérience utilisateur sans masquer les échecs répétés. |
| ID de modèle obsolète | Bloquer le parcours et migrer vers un modèle actuel avant le trafic de production. | Empêche une dépendance silencieuse à un parcours avec une date d’arrêt fixe. |
| Paramètre de requête non pris en charge | Échouer en mode fermé et corriger la requête du client. | Un repli aveugle répète généralement la même mauvaise requête ailleurs. |
| Rendu final en haute résolution | Exiger une approbation explicite pour un repli vers un parcours plus coûteux. | La résolution et la durée multiplient rapidement le coût vidéo. |
| Version brouillon ou itération créative interne | Autoriser un repli à moindre coût uniquement si les différences de sortie sont acceptables. | Les workflows de brouillon peuvent tolérer plus de variabilité qu’une sortie destinée aux clients. |
La dimension fiabilité de cette décision est abordée plus en détail dans le guide équilibrage de charge et basculement des API d’IA. Pour la vidéo, ajoutez des contraintes de coût et de sortie créative à chaque échelle de repli.
Exécutez ce test de fumée avant le lancement
Un test de fumée responsable de l’accès à l’API Veo doit être petit, contrôlé et facile à inspecter :
- Créez ou sélectionnez une clé Flatkey hors production.
- Choisissez une ligne Veo actuelle sur la page de tarification en direct et notez son libellé exact de modèle.
- Confirmez la famille d’endpoint et le modèle de requête avec le responsable produit/docs.
- Exécutez un job vidéo à faible risque avec des paramètres de durée et de résolution connus.
- Capturez l’ID de l’opération, le chemin de sondage de statut, le résultat final, l’unité facturable et l’entrée du journal d’utilisation.
- Répétez avec un échec contrôlé lorsque c’est possible, comme un modèle obsolète bloqué ou un paramètre non pris en charge.
- Décidez si la route peut servir le trafic de production, uniquement le staging, ou uniquement le backlog de recherche.
Si l’un de ces contrôles échoue, maintenez la route hors production. Un journal d’utilisation manquant, une unité de tarification peu claire ou un statut de disponibilité unknown_failure ne sont pas un simple problème administratif pour la vidéo ; cela modifie les coûts, le support et les attentes des clients.
Questions fréquentes
Comment puis-je obtenir l’accès à l’API Veo ?
Commencez par la documentation actuelle de Google sur l’API Gemini Veo et les exigences de facturation, puis vérifiez l’ID du modèle, le point de terminaison et les tarifs le jour où vous développez. Si vous utilisez Flatkey pour le routage, consultez le catalogue de tarification et le tableau de bord actuels avant de considérer l’accès à l’API Veo comme prêt pour la production.
Quel ID de modèle Veo dois-je utiliser ?
Le tableau de tarification actuel de Veo 3.1 de Google répertorie veo-3.1-generate-preview, veo-3.1-fast-generate-preview et veo-3.1-lite-generate-preview. Évitez les anciens IDs Veo 3.0 et Veo 2.0 pour tout nouveau travail en production, car Google les indique pour une fermeture le 30 juin 2026.
Comment la tarification de l’API Veo est-elle calculée ?
Google indique une tarification payante de Veo 3.1 à la seconde, avec des tarifs différents selon la variante et la résolution. Pour l’accès à l’API Veo, normalisez les secondes attendues, la résolution, la politique de réussite et les tentatives avant de comparer la solution avec des fournisseurs vidéo basés sur des jetons ou des packs de ressources.
Veo peut-il être routé avec d’autres modèles de génération vidéo ?
Oui, mais seulement après avoir défini le contrat de routage. Un basculement de Veo vers un autre modèle vidéo peut modifier la qualité visuelle, la durée, le format de sortie, le comportement de modération et le coût. Utilisez des règles de repli approuvées plutôt que des nouvelles tentatives automatiques génériques.
Que doivent vérifier les utilisateurs de Flatkey avant la production ?
Vérifiez la ligne du modèle actuelle, la famille de points de terminaison, le libellé du tableau de bord, l’état de disponibilité, le libellé de prix, les champs du journal d’utilisation et un vrai résultat de test de fumée. Dans l’instantané du 17 juin 2026 utilisé pour cet article, les lignes Veo existaient mais affichaient unknown_failure, donc une utilisation en production nécessite une confirmation fraîche.
Point à retenir
L’accès à l’API Veo est une décision de production, pas seulement une case à cocher chez un fournisseur. Confirmez le modèle officiel, normalisez les secondes et la résolution, gérez les tâches asynchrones, vérifiez la ligne et les preuves du tableau de bord actuelles de Flatkey, et documentez les limites de repli avant la première demande vidéo destinée à un client.
Pour évaluer Veo aux côtés du reste de votre pile de modèles vidéo, commencez par le catalogue actuel de tarifs Flatkey et utilisez la liste de contrôle ci-dessus pour décider quelles routes sont prêtes pour la préproduction, lesquelles nécessitent un test rapide, et lesquelles doivent rester dans le backlog de recherche.
