models

Google: Veo 3.1

Markdown · JSON

Google: Veo 3.1

Veo 3.1 est le modèle vidéo de Google pour les scènes guidées par du texte et des images, avec son généré, images de début et de fin guidées et ressources de référence. Son profil de production fournit des clips de quatre, six ou huit secondes à 24 images/s, avec des options de sortie comprenant 720p, 1080p et 4K.

À propos du modèle

Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.

Veo 3.1 est le modèle de génération vidéo de Google pour créer une courte scène audiovisuelle à partir de texte ou d’un brief guidé par une image. Son profil de production prend en charge la vidéo à partir de texte, d’image et de première et dernière image guidées, avec son généré, références de ressources et processus de prolongement séparé. Utilisez-le pour développer un concept cinématographique, un court récit de produit ou un segment visuel avec une scène, une action et une expérience d’écoute définies.

Décrivez d’abord le sujet et l’événement visible. Établissez les alentours, l’heure de la journée et la lumière, puis définissez le point de vue ou le mouvement de caméra et le style visuel souhaité. Un brief original de scène pourrait montrer un récipient en verre sur une surface de studio sombre, avec un lent déplacement latéral révélant un reflet pendant qu’un doux son environnemental accompagne la révélation. Chaque instruction donne une caractéristique visible ou audible pouvant être évaluée dans le résultat terminé.

Le cadre de rédaction de prompts de Google traite le sujet, l’action, la scène, la caméra et l’esthétique comme des parties distinctes du brief. Utilisez les parties qui servent le plan plutôt que d’ajouter tous les descripteurs possibles. Rédigez la direction en anglais pour le profil de prompts documenté. Si la scène comporte plusieurs actions, indiquez leur relation et gardez-les proportionnées à un court clip afin qu’une révélation ou une réaction reste lisible.

Une image de départ établit l’apparence et la composition d’ouverture. Utilisez-la lorsque le personnage, le produit ou le décor existe déjà comme ressource visuelle, et décrivez le mouvement qui doit en découler. Une dernière image ajoute une composition cible pour la fin. Préparez des images de début et de fin qui communiquent une transition plausible et préservent les détails identifiant le sujet principal, puis examinez le mouvement entre ces images après génération.

Les références de ressources ont une autre fonction : elles guident l’apparence d’un personnage ou d’un objet dans une scène nouvellement générée, tandis que les images de début et de fin définissent des moments précis de cette scène. Choisissez des références montrant les traits visuels importants et explicitez le rôle de chaque ressource dans le prompt. La spécification de vidéo à partir d’images de référence du modèle de production utilise une sortie de huit secondes pour ce processus de référence, séparément de la sélection de durée textuelle ordinaire.

Le profil de production ordinaire du fabricant génère des clips de quatre, six ou huit secondes à 24 images par seconde. Il indique un cadrage paysage 16:9 et portrait 9:16, jusqu’à quatre sorties vidéo par prompt et des résolutions de sortie 720p, 1080p et 4K. Le format vidéo de sortie est MP4. Sa spécification fondée sur une image accepte JPEG ou PNG, indique un maximum de 20 Mo pour l’image d’entrée et prend en charge les configurations d’entrée 720p/1080p. Choisissez le profil de sortie pour l’emplacement prévu et gardez la composition des images lisible à cette taille.

Le son natif peut accompagner la scène visible. Précisez les répliques, l’atmosphère et les effets sonores comme parties du même brief, en nommant le sujet ou l’événement qui produit chacun. Une instruction de dialogue et une instruction de caméra répondent à des questions différentes : l’une établit l’interprétation, l’autre la façon dont le spectateur la voit. Gardez les mots dans le temps de parole utile du clip et vérifiez l’intelligibilité du son ainsi que son rapport avec l’action.

Pour un prolongement, le fabricant fournit un processus séparé de prolongement vidéo. Partez d’un clip source généré approprié et décrivez le prochain événement visible ou changement dans la scène. Préservez l’original et le segment prolongé afin de pouvoir contrôler leur raccord pour l’apparence, le mouvement et le son. Les choix ordinaires de durée et de résolution des clips nouvellement générés ne doivent pas être considérés comme un contrat universel pour toute opération de prolongement.

Une description négative peut cibler les exclusions selon les exigences visuelles de la tâche. Pour une série de variations de produit, gardez le sujet et la composition stables en changeant une seule direction créative, telle que l’éclairage ou la distance de caméra. Enregistrez le prompt, les références et les réglages sélectionnés avec le résultat. Cela permet de comparer une différence créative utile plutôt qu’une collection de générations sans rapport.

Le profil de production Veo 3.1 normal et Veo 3.1 Fast ont des profils de résolution de sortie différents. Fast indique 720p et 1080p ; la version 3.1 normale indique aussi la 4K. Gardez l’édition choisie attachée au résultat, sans remplacer implicitement un identifiant de modèle de production par un ancien profil Preview ou une autre génération Veo. L’apparence d’un sujet et l’opération prise en charge dépendent toutes deux du processus sélectionné.

La génération est une opération dont le résultat terminé fournit des livrables vidéo pour la lecture et le montage ultérieur. Conservez les fichiers renvoyés avec leurs images sources, ressources de référence et brief, et préservez les informations de provenance de contenu fournies. Examinez chaque sortie réelle pour l’apparence du sujet, l’action, le cadrage, le son et la composition finale. Utilisez le clip choisi comme élément de production, avec les titres, transitions ou autres finitions ajoutés dans le montage environnant.

Ailoot Ultra · Vidéo POST /v1/videos google/veo-3.1

google/veo-3.1

Google /google/veo-3.1

Premiers pas

Veo 3.1 est le modèle vidéo de Google pour les scènes guidées par du texte et des images, avec son généré, images de début et de fin guidées et ressources de référence. Son profil de production fournit des clips de quatre, six ou huit secondes à 24 images/s, avec des options de sortie comprenant 720p, 1080p et 4K.

Entrées acceptées
Texte
Résultats
Vidéo

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Vidéo POST /v1/videos
Entrée
text
Sortie
video
Format de sortie
mp4
Nombre de sorties
Jusqu’à 4 sorties
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
google/veo-3.1
Par défaut—
ChamppromptTypestringExigenceObligatoireValeurs et limites
Nombre maximal d’octets UTF-8: 10'000
Caractères autres que des espaces requis: Oui
Par défaut—
ChampdurationTypeintegerExigenceObligatoireValeurs et limites
4, 6, 8
Par défaut—
ChampresolutionTypestringExigenceObligatoireValeurs et limites
720p
Par défaut—
Champaspect_ratioTypestringExigenceObligatoireValeurs et limites
16:9, 9:16
Par défaut—
Champgenerate_audioTypebooleanExigenceObligatoireValeurs et limites
false, true
Par défaut—
Combinaisons d’éléments d’entrée

Texte vers vidéo · Obligatoire : prompt

Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, prompt, duration, resolution, aspect_ratio, generate_audio
Paramètreadditional_propertiesContratfalse
ParamètreparametersContrat{"name":"model","type":"string","required":true,"enum":["google/veo-3.1"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]}
Paramètrematerial_typesContrattext

Alias de méthode : /v1/videos/generations, /videos, /videos/generations

Cycle de vie : submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Conservez la réponse complète et les identifiants d’origine renvoyés.

Ne renvoyez jamais une demande de création dont l’issue est inconnue.

Tarifs

Calcul du coût final

Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs estimés à des fins de comparaison

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationBarème tarifaireQuantité prévisionnelleGénérer de l’audioRésolutionUnité de facturationConditions de facturationCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseQuantité prévisionnelle—Générer de l’audio—Résolution—Unité de facturation—Conditions de facturation—Coût
Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens
Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens
ConfigurationUltraBarème tarifaire—Quantité prévisionnelleConfiguration demandée ; estimation uniquement.Générer de l’audioAvec audioRésolution720pUnité de facturationpar seconde de vidéo en sortieConditions de facturation—Coût
Sortie · Seconde estimée de vidéo en sortie · Estimation à des fins de comparaison uniquement $0.8 par seconde de vidéo en sortie

Le tarif affiché estime le coût avant la génération. La facturation définitive est calculée à partir du coût enregistré pour la génération d’origine. La durée physique de la vidéo n’est pas la quantité facturable.

ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Générer de l’audio—Résolution—Unité de facturationpar seconde de vidéoConditions de facturationson : with_audio; résolution : 4kCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $1.2 par seconde de vidéo
ConfigurationUltraBarème tarifaire—Quantité prévisionnelleConfiguration demandée ; estimation uniquement.Générer de l’audioSans audioRésolution720pUnité de facturationpar seconde de vidéo en sortieConditions de facturation—Coût
Sortie · Seconde estimée de vidéo en sortie · Estimation à des fins de comparaison uniquement $0.4 par seconde de vidéo en sortie

Le tarif affiché estime le coût avant la génération. La facturation définitive est calculée à partir du coût enregistré pour la génération d’origine. La durée physique de la vidéo n’est pas la quantité facturable.

ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Générer de l’audio—Résolution—Unité de facturationpar seconde de vidéoConditions de facturationson : without_audio; résolution : 4kCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.8 par seconde de vidéo
ConfigurationCoût estimé de la générationBarème tarifaire—Quantité prévisionnelleEstimation pour une générationGénérer de l’audio—Résolution—Unité de facturation—Conditions de facturation—Coût
Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $1.6 estimation avant génération

Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.

Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →

Détails du tarif de référence

Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.

Références tarifaires des configurations vidéo

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationConditions de facturationCoût
ConfigurationTarif vidéoConditions de facturationson : with_audioCoût
Sortie · Tarif vidéo $0.8 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

ConfigurationTarif vidéoConditions de facturationson : with_audio; résolution : 4kCoût
Sortie · Tarif vidéo $1.2 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

ConfigurationTarif vidéoConditions de facturationson : without_audioCoût
Sortie · Tarif vidéo $0.4 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

ConfigurationTarif vidéoConditions de facturationson : without_audio; résolution : 4kCoût
Sortie · Tarif vidéo $0.8 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

Exemples de requêtes

Ailoot Ultra · Vidéo

curl · profil configuré exact
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Recevoir et enregistrer les résultats

Ailoot Ultra · Vidéo

mp4

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/videos/generations/{request_id}/content
Vérifier l’état de la tâche
GET état de l’opération d’origine
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Autres lectures de contenu
Enregistrer chaque sortie terminée dont vous êtes propriétaire
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Conserver tous les résultats terminés

Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.

Conservez chaque URL signée de data[] correspondant à un résultat terminé et dont vous êtes propriétaire, ainsi que toutes les métadonnées d’état. Enregistrez chaque résultat, y compris son audio généré. Une piste audio AAC valide peut être présente même avec generate_audio=false ; conservez le MP4 d’origine complet, y compris cet audio.

Si la réponse d’origine doit être vérifiée

Consultez la tâche d’origine existante ; ne répétez jamais un envoi dont l’issue est inconnue.

Nombre maximal de sorties : 4.

Champs de la réponse
ChampTypeSignification
ChampidTypestringSignification—
ChampobjectTypestringSignification—
ChampmodelTypestringSignification—
ChampstatusTypestringSignification—
Champdata[]Typesigned content URLSignification—
Champcharge_pending_checkTypebooleanSignification—
Champerror.codeTypestringSignification—
Champerror.messageTypestringSignification—
Champoperation_idTypestringSignificationRéponse HTTP503 result_pending_check pour l’état ou le contenu d’origine : le même identifiant vidéo public d’origine est renvoyé dans id.
Champerror.typeTypestringSignificationserver_error dans une réponse HTTP503 result_pending_check.
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionLa lecture du corps brut de la requête échoue avant l’analyse du profil vidéoÉtape suivanteConservez la réponse renvoyée et corrigez le corps illisible de la requête.
Réponse422 · price_unavailableConditionL’analyse du profil vidéo exact échoue, ou le profil complet analysé ne dispose d’aucune fiche tarifaire exacte prête à l’emploiÉtape suivanteConservez la réponse ; utilisez le profil autorisé exact et complet, ainsi que sa fiche publiée. Cette branche est exécutée avant l’envoi au fournisseur.
Réponse409 · video_not_readyConditionLe contenu du résultat d’origine n’est pas encore disponibleÉtape suivanteConsultez périodiquement l’identifiant d’origine renvoyé et respectez Retry-After.
Réponseserver_errorConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérificationÉtape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création.
Réponse503 · result_pending_checkConditionGET de l’état ou du contenu d’origine : la tâche n’est pas publiée, la tâche d’origine n’est pas en échec, annulée ou expirée, et l’état local est unknown ou l’état de la tâche d’origine est completed.Étape suivanteConservez les valeurs d’origine id et operation_id, qui désignent le même identifiant vidéo public, ainsi que la réponse et les en-têtes ; consultez uniquement l’état ou le contenu d’origine. N’envoyez jamais de nouvelle demande de génération.

Alias

Alias du modèle

Ailoot Ultra google/veo-3.1

Alias des chemins de méthode

/v1/videos/generations, /videos, /videos/generations

ID d’appel associés

google/veo-3.1

FAQ · Google: Veo 3.1
Quelles entrées et quels résultats sont disponibles ?

POST /v1/videos · google/veo-3.1: text → video

Quels champs la requête utilise-t-elle ?

POST /v1/videos · google/veo-3.1: model, prompt, duration, resolution, aspect_ratio, generate_audio

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence