Google: Veo 3.1 Fast
Veo 3.1 Fast est le modèle vidéo de Google pour de courtes scènes guidées par texte ou image avec son généré. Son profil de production renvoie des séquences MP4 de quatre, six ou huit secondes à 24 images/s, avec sortie en 720p ou 1080p et images d’ouverture ou de clôture guidées.
À 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 Fast est le profil de génération vidéo rapide de Google pour une courte scène décrite dans du texte ou établie par une image. Il combine le plan visuel avec du son généré et prend en charge des images d’ouverture et de clôture guidées. Utilisez-le pour développer un concept de scène, préparer de courtes variantes créatives ou créer un segment audiovisuel compact avec une action et une direction visuelle claires.
Construisez le brief autour du sujet, de l’action et du décor. Ajoutez ensuite le cadrage, le mouvement de caméra, l’éclairage et le traitement visuel qui rendent le plan utile. Un brief de produit original pourrait montrer une petite lampe en céramique sur un bureau en bois, avec la caméra qui s’approche lentement pendant que la lumière s’allume et qu’un léger bruit d’interrupteur accompagne l’action. Le sujet et l’événement visible décrivent l’image; la direction sonore décrit l’expérience d’écoute.
Rédigez la direction de scène en anglais, comme le précise le profil de prompts du producteur. Gardez l’action principale proportionnée à la durée de la séquence et distinguez le mouvement de caméra du mouvement du sujet. Une vue d’ensemble d’introduction, un gros plan de texture et un plan qui suit un objet en mouvement répondent à des questions créatives différentes. Choisissez la vue qui communique le détail voulu au lieu de combiner des directions de caméra sans lien dans un seul plan court.
Pour une scène guidée par image, préparez une image de départ claire qui établit déjà l’apparence et la composition. Le brief de mouvement peut ensuite se concentrer sur l’événement qui suit. Une image de fin peut fournir une destination visuelle pour la transition. Gardez les détails importants du sujet et le style cohérents entre les images, ou décrivez explicitement la transformation voulue. Vérifiez la transition elle-même ainsi que son ouverture et son image finale.
Le profil de production du fabricant prend en charge des séquences de quatre, six ou huit secondes, un cadrage paysage 16:9 ou portrait 9:16 et jusqu’à quatre vidéos de sortie par prompt. La sortie Fast est en 720p ou 1080p, à 24 images par seconde, au format MP4. Le profil guidé par image accepte JPEG ou PNG, indique une taille maximale d’image d’entrée de 20 Mo et prend en charge des configurations d’entrée 720p/1080p. Préparez la composition pour l’orientation prévue et gardez l’entrée dans cette limite d’image.
Le son peut faire partie de la scène générée. Décrivez toute réplique, tout son environnemental ou effet pertinent avec l’action visible, en identifiant le sujet qui doit parler et l’événement qui doit produire le son. Gardez le dialogue assez court pour l’interprétation voulue et distinguez-le de l’ambiance ou de la musique. La génération audio suit le brief de scène écrit; un enregistrement audio ne figure pas parmi les entrées normales documentées de ce profil.
Le profil de production actuel indique aussi la génération par références de ressources et la prolongation vidéo. Les références guident l’apparence d’un sujet ou d’un objet, tandis que les images de début et de fin guident la composition d’ouverture et de clôture. Choisissez des références dont le rôle est clair dans la scène au lieu de traiter chaque image comme une commande interchangeable. Pour une séquence à poursuivre, choisissez le processus de prolongation distinct et décrivez ce qui doit se produire après l’action existante; sa gestion des entrées est distincte de celle d’un nouveau plan guidé par texte.
Une description négative peut identifier le contenu ou les traitements visuels à éviter. Gardez le prompt principal centré sur la scène voulue et rendez les exclusions propres à la tâche. Pour une variante de produit, conservez le sujet et le cadrage en changeant un détail, comme une direction d’éclairage ou un traitement de matière. Conservez les réglages et l’ensemble de références pour comparer les résultats afin que la différence créative reste claire.
Veo 3.1 Fast et le profil Veo 3.1 standard restent des choix distincts. La sortie de production Fast documentée est en 720p/1080p; le profil standard indique aussi la 4K. Conservez l’édition choisie et ses réglages de sortie avec le résultat au lieu de traiter un identifiant Preview ou une autre version Veo comme un synonyme automatique de ce profil de production.
Le processus crée une opération de génération et rend les fichiers vidéo renvoyés accessibles après la fin du traitement. Conservez chaque sortie réelle sélectionnée pour la vérification, avec son brief, ses images sources et ses réglages pertinents. Un identifiant d’opération est un enregistrement de la génération; le fichier MP4 terminé est ce qui peut être lu et utilisé dans le montage. Conservez avec la vidéo toute métadonnée de provenance du contenu fournie.
Vérifiez l’apparence du sujet, l’action demandée, le traitement de caméra et le son pendant toute la séquence. Contrôlez l’intelligibilité du dialogue et la relation entre le son et les événements visibles avant de l’utiliser dans une composition plus longue. Le résultat utile peut être un plan conceptuel, une révélation de produit ou un court segment narratif, auquel des titres, des transitions et d’autres travaux de montage sont ensuite ajoutés dans le processus de production environnant.
Ailoot Ultra · Vidéo POST /v1/videos google/veo-3.1-fast
google/veo-3.1-fastPour commencer
Veo 3.1 Fast est le modèle vidéo de Google pour de courtes scènes guidées par texte ou image avec son généré. Son profil de production renvoie des séquences MP4 de quatre, six ou huit secondes à 24 images/s, avec sortie en 720p ou 1080p et images d’ouverture ou de clôture guidées.
- 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
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites google/veo-3.1-fast | 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-fast"]}, {"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 retournés.
Ne soumettez jamais de nouveau une création dont l’état est inconnu.
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 des jetons | 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 · Jetons en entrée · Estimation à des fins de comparaison uniquement — / 1K jetons Sortie · Jetons en sortie · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K jetons |
| 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 | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.24 par seconde de vidéo |
| 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 $0.6 par seconde de vidéo |
| ConfigurationUltra | Barème tarifaire— | Quantité prévisionnelleConfiguration demandée; estimation seulement. | 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.2 par seconde de vidéo en sortie Le tarif affiché estime le coût avant la génération. Le coût 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 | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.2 par seconde de vidéo |
| 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.5 par seconde de vidéo |
| ConfigurationUltra | Barème tarifaire— | Quantité prévisionnelleConfiguration demandée; estimation seulement. | 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.16 par seconde de vidéo en sortie Le tarif affiché estime le coût avant la génération. La facturation finale 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. |
| 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 $0.64 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.24 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 $0.6 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.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 : with_audio; résolution : 720p | Coût Sortie · Tarif vidéo $0.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; résolution : 4k | Coût Sortie · Tarif vidéo $0.5 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 : 720p | Coût Sortie · Tarif vidéo $0.16 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-fast", "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.
Conservez chaque URL signée appartenant à votre compte dans le tableau data[] terminé et toutes les métadonnées d’état. 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 de nouveau un envoi dont l’état est inconnu.
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 HTTP503 result_pending_check de l’état ou du contenu d’origine : le même identifiant public d’opération vidéo d’origine dans id. |
Champerror.type | Typestring | Significationserver_error sur 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 demande échoue avant l’analyse du profil vidéo | Étape suivanteConservez la réponse retournée et corrigez le corps de demande illisible. |
Réponse422 · price_unavailable | ConditionL’analyse du profil vidéo exact échoue ou le profil complet analysé ne possède aucune fiche tarifaire exacte prête à l’emploi | Étape suivanteConservez la réponse; utilisez le profil complet exact autorisé et sa fiche publiée. Cette branche s’exécute avant tout 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 retourné 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 de l’état ou du contenu d’origine : la tâche n’est pas publiée, la tâche d’origine n’est ni failed, ni cancelled, ni expired, et l’état local est unknown ou l’état de la tâche d’origine est completed. | Étape suivanteConservez les valeurs id et operation_id d’origine (le même identifiant vidéo public), la réponse et les en-têtes; consultez seulement l’état ou 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-fast
Alias des chemins de méthode
/v1/videos/generations, /videos, /videos/generations
ID d’appel associés
FAQ · Google: Veo 3.1 Fast
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/videos·google/veo-3.1-fast:text→video- Quels champs la requête utilise-t-elle ?
POST /v1/videos·google/veo-3.1-fast:model,prompt,duration,resolution,aspect_ratio,generate_audio