Google: Veo 3.1
Veo 3.1 est le modèle vidéo de Google pour les scènes issues de texte et d’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 sorties 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 fondé sur une image. Son profil de production prend en charge la génération vidéo à partir de texte, la génération à partir d’une image et la création guidée par des images de début et de fin, avec son généré, références de ressources et processus distinct de continuation. Utilisez-le pour développer un concept cinématographique, un court récit de produit ou un segment visuel doté d’une scène, d’une action et d’une expérience sonore définies.
Décrivez d’abord le sujet et l’événement visible. Établissez l’environnement, le moment 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 voulu. Un exemple original de brief de scène peut montrer un récipient en verre sur une surface de studio sombre, avec un lent mouvement latéral révélant un reflet tandis qu’un doux son d’ambiance accompagne cette révélation. Chaque instruction fournit une caractéristique visible ou audible à évaluer dans le résultat achevé.
Le cadre de rédaction de Google traite le sujet, l’action, la scène, la caméra et l’esthétique comme des parties distinctes du brief. Utilisez celles qui servent le plan plutôt que d’ajouter tous les descripteurs possibles. Rédigez les indications en anglais pour le profil de prompt documenté. Si la scène comporte plusieurs actions, précisez leur relation et gardez-les proportionnées à un clip court pour que la révélation ou la réaction reste lisible.
Une image de départ établit l’apparence et la composition initiales. 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 inspectez le mouvement entre ces images après la génération.
Les références de ressources ont un autre rôle : 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 qui montrent les caractéristiques visuelles importantes et précisez le rôle de chaque ressource dans le prompt. La spécification de génération 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, distinct du choix de durée courant pour une scène issue de texte.
Le profil de production courant du fabricant génère des clips de quatre, six ou huit secondes à 24 images par seconde. Il prévoit des cadrages paysage 16:9 et portrait 9:16, jusqu’à quatre vidéos de sortie par prompt et des résolutions de sortie de 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 d’image d’entrée de 20 Mo et prend en charge des configurations d’entrée 720p/1080p. Choisissez le profil de sortie selon son emplacement prévu et gardez la composition lisible à cette taille.
Un 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 d’eux. Une instruction de dialogue et une instruction de caméra répondent à des questions différentes : l’une établit la prestation, l’autre la façon dont le public la voit. Gardez le texte dans le temps de parole utile du clip et vérifiez l’intelligibilité du son et sa relation avec l’action.
Pour une continuation, le fabricant propose un processus distinct d’extension vidéo. Partez d’un clip source généré approprié et décrivez l’événement visible suivant ou le changement de la scène. Préservez l’original et le segment poursuivi pour examiner leur jonction du point de vue de l’apparence, du mouvement et du son. Les choix normaux de durée et de résolution pour une nouvelle génération ne doivent pas être considérés comme un contrat universel pour chaque opération d’extension.
Une description négative peut concentrer les exclusions sur les exigences visuelles de la tâche. Pour une série de variantes de produit, gardez le sujet et la composition stables en changeant une seule direction créative, comme l’éclairage ou la distance de caméra. Consignez le prompt, les références et les réglages choisis avec le résultat. Vous pouvez ainsi comparer une différence créative utile plutôt qu’un ensemble de générations sans rapport.
Le profil de production Veo 3.1 standard et Veo 3.1 Fast ont des profils de résolution de sortie différents. Fast prévoit 720p et 1080p ; le profil 3.1 standard prévoit également la 4K. Gardez l’édition choisie associée au résultat sans remplacer silencieusement un identifiant de modèle de production par un ancien profil Preview ou une autre génération de Veo. L’apparence du sujet comme l’opération prise en charge dépendent du processus choisi.
La génération est une opération dont le résultat achevé fournit des livrables vidéo pour la lecture et le montage ultérieur. Conservez les fichiers renvoyés avec leurs images sources, leurs ressources de référence et leur brief, ainsi que les informations de provenance de contenu fournies. Inspectez chaque sortie réelle pour l’apparence du sujet, l’action, le cadrage, le son et la composition finale. Utilisez le clip retenu comme élément de production, avec des 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.1Premiers pas
Veo 3.1 est le modèle vidéo de Google pour les scènes issues de texte et d’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 sorties 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
- Types d’entrée
text- Types de sortie
video- Format de sortie
- mp4
- Nombre de sorties
- Jusqu’à 4 sorties
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites google/veo-3.1 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Nombre maximal d’octets UTF-8: 10 000 Caractères autres que des espaces requis: Oui | Par défaut— |
Champduration | Typeinteger | ExigenceObligatoire | Valeurs et limites 4, 6, 8 | Par défaut— |
Champresolution | Typestring | ExigenceObligatoire | Valeurs et limites 720p | Par défaut— |
Champaspect_ratio | Typestring | ExigenceObligatoire | Valeurs et limites 16:9, 9:16 | Par défaut— |
Champgenerate_audio | Typeboolean | ExigenceObligatoire | Valeurs 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ètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Paramètreadditional_properties | Contratfalse |
Paramètreparameters | Contrat{"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_types | Contrattext |
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 soumettez jamais à nouveau une 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.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Générer de l’audio | Résolution | Unité de facturation | Conditions de facturation | Coût |
|---|---|---|---|---|---|---|---|
| ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | Quantité 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 |
| ConfigurationUltra | Barème tarifaire— | Quantité prévisionnelleConfiguration demandée ; estimation uniquement. | Générer de l’audioAvec audio | Résolution720p | Unité de facturationpar seconde de vidéo en sortie | Conditions 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. Le montant final est calculé à 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éo | Barème tarifaire— | Quantité prévisionnelle— | Générer de l’audio— | Résolution— | Unité de facturationpar seconde de vidéo | Conditions de facturationaudio : with_audio ; résolution : 4k | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $1.2 par seconde de vidéo |
| ConfigurationUltra | Barème tarifaire— | Quantité prévisionnelleConfiguration demandée ; estimation uniquement. | Générer de l’audioSans audio | Résolution720p | Unité de facturationpar seconde de vidéo en sortie | Conditions 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. Le montant final est calculé à 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éo | Barème tarifaire— | Quantité prévisionnelle— | Générer de l’audio— | Résolution— | Unité de facturationpar seconde de vidéo | Conditions de facturationaudio : without_audio ; résolution : 4k | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.8 par seconde de vidéo |
| ConfigurationCoût de génération estimé | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Gé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.
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationTarif vidéo | Conditions de facturationaudio : with_audio | Coû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éo | Conditions de facturationaudio : with_audio ; résolution : 4k | Coû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éo | Conditions de facturationaudio : without_audio | Coû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éo | Conditions de facturationaudio : without_audio ; résolution : 4k | Coû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
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}/contentGET /v1/videos/generations/{request_id}/content
Vérifier l’état de la tâche
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
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.
Une fois la tâche terminée, conservez chaque URL signée vous appartenant dans data[] ainsi que les métadonnées complètes du statut. Enregistrez chaque sortie, 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 cette piste audio.
Si la réponse d’origine doit être vérifiée
Consultez la tâche d’origine existante ; ne soumettez jamais à nouveau un envoi dont l’issue est inconnue.
Nombre maximal de sorties : 4.
Champs de la réponse
| Champ | Type | Signification |
|---|---|---|
Champid | Typestring | Signification— |
Champobject | Typestring | Signification— |
Champmodel | Typestring | Signification— |
Champstatus | Typestring | Signification— |
Champdata[] | Typesigned content URL | Signification— |
Champcharge_pending_check | Typeboolean | Signification— |
Champerror.code | Typestring | Signification— |
Champerror.message | Typestring | Signification— |
Champoperation_id | Typestring | SignificationRéponse au statut ou au contenu d’origine HTTP503 result_pending_check : même identifiant vidéo public d’origine dans id. |
Champerror.type | Typestring | Significationserver_error pour HTTP503 result_pending_check. |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionLa 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_unavailable | ConditionL’analyse du profil vidéo exact échoue, ou le profil analysé complet ne dispose d’aucune fiche tarifaire exacte prête à l’emploi | Étape suivanteConservez la réponse ; utilisez le profil complet et exact autorisé ainsi que sa fiche publiée. Cette branche s’exécute avant l’envoi au fournisseur. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteInterrogez l’identifiant d’origine renvoyé et respectez Retry-After. |
Réponseserver_error | ConditionLa 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_check | ConditionGET du statut ou du contenu d’origine : la tâche n’est pas publiée, la tâche d’origine n’est pas failed/cancelled/expired et l’état local est unknown ou le statut de la tâche d’origine est completed. | Étape suivanteConservez les valeurs d’origine id et operation_id (même identifiant vidéo public), la réponse et les en-têtes ; consultez uniquement le statut et le contenu d’origine. Ne soumettez jamais une 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
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