L’accès à l’API Veo n’est plus un simple remplacement de modèle en une ligne pour les équipes médias. Avant de placer le trafic des créateurs derrière les modèles vidéo de Google, vous devez vérifier l’ID du modèle, l’accès direct au fournisseur, l’unité de tarification, le comportement des tâches asynchrones, l’état de la route, la politique de repli et la preuve d’utilisation après génération. C’est l’objet de cette liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur.
Utilisez cette liste de vérification lorsque vous décidez si Veo doit être votre route vidéo par défaut, une route dans une politique multi-fournisseur, ou un workflow Google direct qui se situe en dehors d’une passerelle. Elle est rédigée pour les équipes produit, ingénierie et opérations médias qui ont besoin de contrôles reproductibles avant de mettre en production des tâches de texte vers vidéo et d’image vers vidéo.
Cette liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur a été vérifiée le 15 septembre 2026 par rapport à la documentation de l’API Google Gemini, à la tarification de l’API Google Gemini, aux pages de modèles Flatkey, à la documentation de démarrage rapide Flatkey et au répertoire de modèles Flatkey. Considérez chaque prix et chaque état de route comme un instantané public daté, puis revérifiez les conditions de votre compte avant de faire passer du trafic de production.
Réponse rapide : quoi vérifier pour l’accès à l’API Veo
Si vous n’avez le temps que pour un seul passage, vérifiez ces sept champs avant de router des tâches de production :
| Vérification | Pourquoi c’est important | Capture d’écran publiable |
|---|---|---|
| Famille de modèles Google directe | Google distingue désormais les conseils généraux sur la génération vidéo des documents spécifiques à Veo. | La page d’ensemble vidéo de Google indique que l’API Gemini propose Gemini Omni Flash et Veo ; elle recommande Gemini Omni Flash comme modèle vidéo par défaut et Veo 3.1 lorsque vous avez besoin d’une extension de scène, d’un contrôle de la dernière image ou de flux Veo hérités. |
| ID du modèle Veo | Les tâches de production doivent figer les ID exacts des modèles, et pas seulement « Veo ». | Les documents Veo de Google listent veo-3.1-generate-preview, veo-3.1-fast-generate-preview et veo-3.1-lite-generate-preview ; les pages de modèles publiques Flatkey ont vérifié les routes Standard et Fast, tandis que la page du modèle Lite Flatkey a renvoyé une erreur 404 pendant ce rafraîchissement. |
| Unité de tarification | Les coûts vidéo se cumulent selon les secondes, la résolution, les clips acceptés et les tentatives. | Google indique les tarifs de Veo 3.1 par seconde. Les pages de modèles Flatkey affichent des prix de route par seconde pour Standard et Fast avec une tarification « à partir de ». |
| Modèle de tâche asynchrone | La génération vidéo est un flux de production en file d’attente. | Google documente la génération Veo via une opération longue durée : soumettre, interroger jusqu’à done, puis télécharger le fichier. |
| Contraintes de sortie | La durée, le ratio d’aspect, la résolution, l’audio et les contrôles de référence déterminent si le repli est valide. | Google documente des choix de durée de 4 s, 6 s et 8 s, 16:9 et 9:16, l’audio natif, des options 720p/1080p/4k, ainsi que des contraintes d’image de référence/d’extension selon le modèle. |
| État de la route passerelle | Une route passerelle n’est utile que si la route spécifique est disponible et observable. | Les pages de modèles Flatkey vérifiées pour Standard et Fast affichaient availability_status: available et des familles de points de terminaison incluant openai-video, gemini et openai. |
| Preuve d’utilisation | La finance et les opérations ont besoin d’une preuve une fois la tâche terminée. | La documentation de démarrage rapide Flatkey décrit l’utilisation de https://router.flatkey.ai/v1, une configuration compatible avec le SDK OpenAI et les journaux d’utilisation pour examiner le modèle, les jetons, la latence et le coût. |
En bref : exécutez cette Liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur avant de comparer la qualité créative. Une démonstration de prompt peut sembler bonne alors que la route de production manque encore de preuve de facturation, de comportement de file d’attente ou d’un contrat de repli valide.
Liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur
Utilisez cette Liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur comme porte de lancement. Ne marquez une ligne comme terminée que lorsque l’environnement exact, le compte, l’ID du modèle, la route et la surface de facturation ont été vérifiés.
| Étape | Preuve requise | Condition de réussite |
|---|---|---|
| 1. Confirmer la classe de route vidéo | API Gemini directe, route Flatkey ou politique multi-fournisseur mixte. | L’équipe sait si le client appelle Google directement, le routeur de Flatkey, ou les deux. |
| 2. Choisir l’ID exact du modèle Veo | veo-3.1-generate-preview ou veo-3.1-fast-generate-preview pour les routes Flatkey vérifiées ; les équipes Google en direct peuvent aussi évaluer Lite. | Aucune tâche n’utilise un alias générique veo dans la configuration de production. |
| 3. Figer le contrat de sortie | Type de prompt, images de référence, format d’image, résolution, durée, attente audio native, exigence d’extension. | La route de repli peut préserver la même promesse visible pour l’utilisateur ou la tâche n’est pas éligible au repli. |
| 4. Normaliser la tarification | Prix par seconde, durée, résolution, politique de nouvelle tentative, taux de clips acceptés. | L’approbation utilise le coût estimé par clip accepté, et pas seulement le prix brut par seconde. |
| 5. Mettre en place le traitement asynchrone | Table des tâches, ID d’opération, polling/backoff, délai d’attente, chemin d’annulation, remise au stockage. | L’application peut survivre à des tâches longues et à des complétions retardées sans surprises de double facturation. |
| 6. Vérifier la santé de la route | Accès fournisseur, état de la route Flatkey, requête de test, classe d’erreur, enveloppe de latence. | Un test de fumée enregistre l’ID de requête, l’ID du modèle, la durée, la route, l’état d’achèvement et le coût. |
| 7. Définir la politique de repli | Fournisseurs de repli autorisés, comportement en cas de sortie bloquée, budget de nouvelles tentatives, message de dégradation. | Le repli ne peut pas modifier silencieusement la durée du clip, le format d’image ou la promesse audio. |
| 8. Vérifier l’observabilité | Journaux, registre des coûts, route, nombre de nouvelles tentatives, URL finale de l’asset, décision du réviseur. | Le produit, l’ingénierie et la finance peuvent examiner le même enregistrement de tâche. |
| 9. Revérifier avant le lancement | Docs Google, tarification Google, page du modèle Flatkey, page de tarification Flatkey, runbook interne. | La tarification et la disponibilité sont datées dans la note de version. |
Pour une politique de route plus large, associez cette liste de vérification au guide de Flatkey sur le routage d’agents multimodaux. Pour l’interprétation du catalogue, utilisez le guide du catalogue de modèles d’IA avant d’approuver une ligne de modèle.
Confirmer si Veo est la bonne route vidéo Google
La première question d’accès n’est pas « Pouvons-nous appeler Veo ? » C’est « Ce flux de travail doit-il utiliser Veo ou un autre modèle vidéo Google ? » La présentation vidéo de l’API Gemini de Google indique qu’elle propose à la fois Gemini Omni Flash et Veo. Cette même présentation positionne Gemini Omni Flash comme modèle vidéo par défaut et oriente les équipes vers Veo 3.1 lorsqu’elles ont besoin d’une extension de scène, d’un contrôle du dernier cadre ou d’anciens pipelines Veo.
Cette distinction est importante, car l’accès à l’API Veo apparaît souvent dans une feuille de route à partir d’une exigence créative : mouvement cinématographique amélioré, sortie haute résolution, audio natif, contrôle par référence ou extension à partir d’une scène générée existante. Si la tâche concerne la compréhension vidéo générale ou un travail multimodal plus large, votre décision de routage peut être différente.
Utilisez Veo lorsque la tâche dépend d’une ou plusieurs de ces propriétés :
- Courtes séquences générées avec audio natif.
- Sortie en 720p, 1080p ou 4k lorsque cela est pris en charge par le modèle et le compte sélectionnés.
- Sortie
16:9ou9:16avec une durée contrôlée. - Comportement de première image, dernière image ou extension.
- Gouvernance du compte Google ou sémantique d’exploitation directe de l’API Gemini.
Utilisez une route gateway lorsque l’équipe doit comparer Veo à d’autres fournisseurs de génération vidéo, centraliser les dépenses ou conserver un processus cohérent de revue des routes sur les modèles texte, image, audio et vidéo. La comparaison Seedance vs Veo API est la lecture interne adjacente lorsque la décision porte spécifiquement sur Veo par rapport à Seedance.
Choisissez l’identifiant du modèle Veo actuel
Dans cette liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur, la règle de l’identifiant de modèle est simple : ne configurez pas « Veo » comme libellé de production. Configurez un identifiant de modèle exact et consignez la raison de ce choix.
| ID du modèle | Où il est documenté | À utiliser lorsque | État de la route Flatkey vérifié lors de cette actualisation |
|---|---|---|---|
veo-3.1-generate-preview | Documentation et tarification Google Veo ; page de modèle publique Flatkey. | Vous avez besoin de la route Veo 3.1 standard et pouvez accepter le coût de route plus élevé. | La page publique Flatkey a renvoyé un 200 et a affiché les métadonnées de route disponibles. |
veo-3.1-fast-generate-preview | Documentation et tarification Google Veo ; page de modèle publique Flatkey. | Vous voulez une voie Veo plus rapide et moins coûteuse, et vous avez testé la qualité pour votre classe de requêtes. | La page publique Flatkey a renvoyé un 200 et a affiché les métadonnées de route disponibles. |
veo-3.1-lite-generate-preview | Documentation et tarification Google Veo. | Vous évaluez le comportement direct de Google Lite et ses contraintes. | La page publique du modèle Lite de Flatkey a renvoyé un 404 lors de cette actualisation, donc cet article ne prétend pas qu’une route Flatkey Lite soit active. |
La documentation de Google indique que la famille Veo 3.1 est en aperçu. Traitez cela comme une contrainte de gestion des versions : votre liste de vérification de production doit inclure des contrôles d’accès datés, les droits du compte, les régions autorisées si elles sont pertinentes pour votre déploiement, le comportement de blocage lié à la sécurité, des tests de latence et un plan de retour arrière.
Normalisez la tarification de l’API Veo avant le routage
La liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur doit comparer la tarification comme un coût de tâche, et non comme un coût de nom de modèle. Commencez par la durée et la résolution exactes exposées par votre produit, puis ajoutez le taux de retry et le taux de clips acceptés.
| Itinéraire | Aperçu public des tarifs vérifié le 15 septembre 2026 | Exemple de planification pour 8 secondes | Notes |
|---|---|---|---|
Google direct veo-3.1-generate-preview | 0,40 $/sec en 720p ou 1080p ; 0,60 $/sec en 4k. | 3,20 $ en 720p/1080p ; 4,80 $ en 4k. | Google indique que le niveau gratuit n’est pas disponible pour Veo 3.1 et que la facturation n’a lieu qu’en cas de génération réussie de la vidéo. |
Google direct veo-3.1-fast-generate-preview | 0,10 $/sec en 720p ; 0,12 $/sec en 1080p ; 0,30 $/sec en 4k. | 0,80 $ en 720p ; 0,96 $ en 1080p ; 2,40 $ en 4k. | Bon candidat pour des brouillons ou des voies vidéo Google à moindre coût après des tests de qualité. |
Google direct veo-3.1-lite-generate-preview | 0,05 $/sec en 720p ; 0,08 $/sec en 1080p ; 4k non pris en charge. | 0,40 $ en 720p ; 0,64 $ en 1080p. | Tarification Google directe uniquement dans cet article ; l’itinéraire Flatkey Lite n’a pas été vérifié. |
Flatkey veo-3.1-generate-preview | La page du modèle affichait une tarification à la seconde à partir de 0,32 $/sec. | À partir de 2,56 $ pour 8 secondes. | Vérifiez les paramètres d’itinéraire en production et la facturation avant le lancement. |
Flatkey veo-3.1-fast-generate-preview | La page du modèle affichait une tarification à la seconde à partir de 0,08 $/sec. | À partir de 0,64 $ pour 8 secondes. | Vérifiez les paramètres d’itinéraire en production et la facturation avant le lancement. |
L’erreur principale de routage consiste à valider un fallback parce qu’il semble moins cher à la seconde, puis à découvrir qu’il modifie la résolution, le comportement audio, le contrôle des références ou le taux de clips acceptés. Effectuez la comparaison finale ainsi :
accepted_clip_cost:
total_generation_cost: "$ facturé pour toutes les tentatives"
accepted_clips: "clips ayant passé les contrôles qualité marque, sécurité, mouvement et canal"
formula: "total_generation_cost / accepted_clips"Si un itinéraire a un coût brut plus faible mais produit davantage de clips rejetés, le coût réel de production peut être plus élevé.
Traitez Veo comme un job vidéo asynchrone
La documentation Veo de Google utilise un modèle d’opération longue durée. Un client envoie une requête de génération, reçoit un objet d’opération, interroge l’état jusqu’à ce que l’opération soit terminée, puis télécharge la vidéo générée. La documentation de Google indique également que les vidéos générées sont stockées pendant deux jours et doivent être téléchargées dans cette fenêtre.
Cela signifie que l’accès à l’API Veo nécessite un système de jobs, et pas seulement un wrapper de requêtes. Votre client doit enregistrer :
- ID interne du job.
- ID d’opération du fournisseur ou ID de requête de la passerelle.
- ID du modèle.
- Type d’entrée et ressources de référence.
- Durée, résolution et format d’image.
- Heure de début, nombre d’interrogations, heure d’achèvement, état de timeout.
- Blocage sécurité, erreur fournisseur, nombre de tentatives et itinéraire de repli s’il a été utilisé.
- Emplacement final de l’asset et politique de conservation/suppression.
- Montant final facturé et lien vers le journal d’utilisation.
Pour les utilisateurs de Flatkey, le guide de démarrage rapide de l’API Flatkey est l’étape suivante pour la configuration de l’URL de base. Le guide documente https://router.flatkey.ai/v1 et une configuration compatible avec le SDK OpenAI ; pour la vidéo en production, gardez la même rigueur, mais effectuez un test rapide du point de terminaison vidéo spécifique et de la route de modèle que vous comptez utiliser.
Vérifier l’état de la route Flatkey et la famille de points de terminaison
La vérification de la route Flatkey doit se faire sur la page du modèle et dans les journaux de votre propre compte.
Pour cette actualisation, les pages publiques des modèles Flatkey ont renvoyé 200 pour :
https://flatkey.ai/models/veo-3.1-generate-previewhttps://flatkey.ai/models/veo-3.1-fast-generate-preview
Ces pages indiquaient Google comme fournisseur, availability_status: available, une tarification par seconde et des familles de points de terminaison incluant openai-video, gemini et openai. La page publique de veo-3.1-lite-generate-preview a renvoyé 404, donc l’affirmation sûre est limitée : Google documente Lite directement, mais cette actualisation n’a pas vérifié une route Lite Flatkey.
Avant la production, capturez une capture d’écran ou exportez la ligne du modèle, puis lancez un petit test rapide et confirmez qu’il apparaît dans les journaux d’utilisation. Le répertoire des modèles et la page de tarification de Flatkey doivent faire partie de la liste de vérification datée de la mise en production.
Définir des règles de repli entre fournisseurs vidéo
Le repli est plus difficile pour la vidéo que pour le texte. Le repli d’un modèle de texte peut préserver l’intention avec un style différent. Le repli d’un modèle vidéo peut modifier la durée du clip, le comportement de la caméra, le respect des références, l’audio, la résolution, le coût et le résultat de modération.
Utilisez cette matrice de repli avant d’activer les nouvelles tentatives automatiques :
| Classe d’échec | Réessayer la même route ? | Repli autorisé ? | Note d’exploitation |
|---|---|---|---|
| Erreur transitoire de route | Oui, dans une limite de tentatives plafonnée. | Oui, si le contrat de sortie est équivalent. | Préservez l’idempotence afin que les tentatives ne créent pas de doublons de frais utilisateur. |
| Blocage de sécurité ou de politique | Non, pas de nouvelle tentative automatique sans entrée modifiée. | En général non. | Demandez une révision du prompt/de la référence au lieu de changer discrètement de fournisseur. |
| Seuil de latence dépassé | Peut-être, si le travail n’est pas visible par l’utilisateur. | Oui, pour les files de brouillon. | Affichez un état de progression et évitez les nouvelles tentatives cachées répétées. |
| Plafond budgétaire atteint | Non. | Non, sauf si une route moins coûteuse a été préapprouvée. | Les plafonds budgétaires doivent arrêter le travail, pas masquer les dépenses. |
| Fonctionnalité non prise en charge | Non. | Uniquement si le repli prend en charge la fonctionnalité requise. | Ne revenez pas d’exigences audio natives à une vidéo silencieuse sans décision produit. |
Pour les équipes vidéo multi-fournisseurs, l’essentiel est d’orienter selon la classe de flux de travail :
- Clips Google avec audio natif.
- Clips Veo de brouillon à moindre coût.
- Clips créateur à forte dépendance aux références.
- Tâches vidéo sociales plus longues.
- Tâches d’export en haute résolution.
- Tâches de révision manuelle où les sorties bloquées doivent revenir à un éditeur.
C’est là qu’une passerelle unifiée est utile : elle offre à l’ingénierie un point unique pour acheminer, au produit un point unique pour définir la politique de modèle, et à la finance un registre unique à consulter. Elle ne supprime pas la nécessité de vérifier le comportement exact de sortie de chaque route.
Exécutez le test de fumée de lancement
Exécutez ce test de fumée de la liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur en environnement de préproduction avant d’ouvrir l’accès à l’API Veo au trafic des créateurs :
- Créez trois tâches représentatives : un clip paysage basé uniquement sur le prompt, un clip portrait référencé par une image et un clip avec audio natif.
- Exécutez chaque tâche sur la route Veo choisie avec la durée et la résolution exactes prévues pour la production.
- Enregistrez l’ID d’opération, l’ID de requête, l’ID de modèle, la route, l’heure de début, l’heure de fin et l’URL de sortie.
- Vérifiez que la tâche apparaît dans Flatkey Usage Logs ou dans les enregistrements d’utilisation Google directs.
- Confirmez que le coût total correspond à l’unité attendue par seconde, à la durée et à la résolution.
- Provoquez un échec récupérable et confirmez que l’idempotence empêche les doublons dans les enregistrements finaux.
- Provoquez une tâche bloquée ou rejetée et confirmez que l’interface utilisateur demande une entrée révisée au lieu de basculer silencieusement.
- Confirmez que les ressources générées sont téléchargées et stockées avant l’expiration de la fenêtre de rétention du fournisseur.
- Examinez les preuves finales avec le produit, l’ingénierie et la finance avant le lancement.
Enregistrement d’accès Veo copiable
Utilisez cet enregistrement de la liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur dans votre liste de vérification de publication ou votre dépôt de routage :
veo_access_record:
checked_at: "YYYY-MM-DD"
owner: "team or person"
route_mode: "direct_google | flatkey | mixed"
model_id: "veo-3.1-fast-generate-preview"
provider_docs_checked:
- "Google Gemini API video overview"
- "Google Gemini API Veo docs"
- "Google Gemini API pricing"
flatkey_checks:
model_page_status: "200"
availability_status: "available"
endpoint_family: "openai-video"
usage_logs_verified: true
output_contract:
duration_seconds: 8
aspect_ratio: "16:9"
resolution: "720p"
native_audio_required: true
reference_images_required: 0
cost_review:
billing_unit: "per_second"
displayed_unit_price: "record current account/page value"
retry_budget: "max attempts"
accepted_clip_cost_target: "USD"
async_handling:
operation_id_saved: true
polling_backoff: "configured"
timeout_policy: "configured"
asset_download_window: "before provider expiry"
fallback_policy:
enabled: false
allowed_routes: []
contract_preserved: true
rollback:
owner: "team or person"
trigger: "error rate, cost, latency, quality, safety"
action: "disable route or switch workflow class"Questions fréquentes
Comment puis-je obtenir l’accès à l’API Veo ?
Commencez par la documentation de l’API Gemini de Google et l’accès à votre compte Google, puis décidez si la route doit passer directement par Google ou via une passerelle telle que Flatkey. Utilisez la liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur afin de vérifier la page du modèle en direct et d’exécuter une requête de préproduction avant le trafic de production.
Quel ID de modèle Veo dois-je utiliser ?
Utilisez veo-3.1-generate-preview lorsque vous avez besoin de la voie Veo 3.1 standard. Utilisez veo-3.1-fast-generate-preview lorsque la qualité Fast correspond à votre flux de travail et que l’itinéraire au coût par seconde inférieur est approprié. Évaluez veo-3.1-lite-generate-preview uniquement par rapport à la documentation Google directe, sauf si votre compte Flatkey ou la page du modèle confirme une route Lite active.
Comment le prix de l’API Veo est-il calculé ?
Google affiche les prix de Veo 3.1 par seconde générée, avec des tarifs différents selon le modèle et la résolution. Les pages des modèles Flatkey affichent également les prix des routes par seconde pour les pages Veo Standard et Fast vérifiées. Votre revue de production doit multiplier le prix unitaire par la durée, la résolution, les nouvelles tentatives et le taux de clips acceptés.
Veo peut-il être acheminé avec d’autres modèles de génération vidéo ?
Oui, mais le fallback doit préserver le contrat de sortie visible par l’utilisateur. Ne faites pas automatiquement un fallback d’un job Veo natif avec audio, de 8 secondes et en 1080p vers un job silencieux, plus court et à plus faible résolution, sauf si le produit autorise explicitement cette dégradation.
Que doivent vérifier les utilisateurs de Flatkey avant la production ?
Vérifiez la page du modèle Flatkey, le répertoire des modèles, la page de tarification, l’état de la route et les journaux d’utilisation. Ensuite, exécutez un test de fumée spécifique à la vidéo plutôt que de supposer qu’un démarrage rapide textuel compatible OpenAI prouve le comportement vidéo.
À retenir
La liste de vérification de l’accès à l’API Veo pour le routage vidéo multi-fournisseur doit se terminer avec des preuves datées, pas avec une préférence. Geler l’ID du modèle, normaliser la tarification par clip accepté, concevoir pour des jobs asynchrones, vérifier la route Flatkey ou le compte Google direct, et approuver le fallback uniquement lorsqu’il préserve le contrat de sortie. Ensuite, utilisez le répertoire des modèles, la page de tarification, le démarrage rapide et les journaux d’utilisation de Flatkey pour conserver l’auditabilité de la route de production après le lancement.
