Veo 3.1 Lite est le membre Lite de la gamme de génération vidéo Veo 3 de Google. Il synthétise une vidéo avec audio à partir d’une description en langage naturel ou d’une image d’entrée. La sortie est un clip généré, pas une analyse textuelle d’un enregistrement existant. La fiche Lite du fabricant renvoie à Veo 3 pour l’architecture sous-jacente, les données d’entraînement et les limitations connues, tandis que la documentation propre à Lite définit ses fonctions et limites de génération.
L’architecture citée utilise la diffusion latente sur des représentations audio temporelles et vidéo spatio-temporelles. Le modèle de base a été entraîné sur de l’audio, des vidéos et des images, avec des légendes de niveaux de détail différents, et des données filtrées et dédupliquées. Cela explique sa finalité de génération conjointe d’image et d’audio. Cela ne divulgue pas un nombre de paramètres propre à Lite ni ne prouve que chaque mouvement généré respecte la réalité physique. Pour une scène pratique, décidez ensemble de l’action visible et du son correspondant.
La documentation exacte de Lite indique une limite d’entrée textuelle de 1 024 tokens et une vidéo en sortie. La colonne Lite du guide de génération répertorie des durées de 4, 6 et 8 secondes, avec 720p par défaut et 1080p nécessitant un clip de 8 secondes. Le rapport paysage 16:9 est celui par défaut et le portrait 9:16 est également proposé ; la sortie est documentée à 24 images par seconde. L’audio natif est toujours actif dans ce processus. Ces valeurs appartiennent au processus Lite nommé du producteur, pas à une autre édition Veo ni à une réponse d’application mesurée séparément.
Lite ne prend pas en charge la sortie 4K ni l’extension vidéo. Le tableau des paramètres indique aussi comme indisponibles dans la colonne Lite la fonction multiréférence referenceImages et l’entrée vidéo d’extension. Une image initiale peut établir la première image du clip ; le tableau répertorie une image lastFrame associée à cette image initiale pour une transition. Distinguez cette voie de contrôle des images limites du mélange de plusieurs références de style ou de sujet. Les réglages de génération de personnes du producteur dépendent du mode : le tableau Lite indique allow_all pour texte-vers-vidéo et allow_adult pour image-vers-vidéo et l’interpolation, tandis que des règles régionales peuvent restreindre davantage ce profil documenté. Choisissez une image de départ correspondant à la première scène réellement souhaitée, avec le sujet, le cadrage et les détails visibles préparés avant de demander du mouvement.
Pour texte-vers-vidéo, décrivez le sujet, son action, l’environnement et le style prévu. Ajoutez la position et le mouvement de caméra, le cadrage, la mise au point et la lumière lorsqu’ils comptent. Une scène produit originale pourrait garder l’objet centré pendant que la caméra s’approche d’un détail de matériau et que la lumière environnante change doucement. Identifiez l’état initial, l’action principale et le dernier instant pour que le court clip exprime une idée cohérente. Une longue suite d’actions sans rapport constitue une autre tâche qu’un plan ciblé.
Pour image-vers-vidéo, fournissez une image initiale claire et expliquez ce qui doit bouger et ce qui doit rester stable. Précisez séparément le mouvement du sujet et tout mouvement de caméra. Si vous utilisez une contrainte d’image finale, préparez une composition finale compatible et décrivez la transition entre les deux. Examinez le résultat au lieu de supposer que l’identité, la position ou la forme demandées restent identiques tout au long du clip. La fiche citée du modèle reconnaît la cohérence complète dans les scènes complexes et les mouvements complexes comme une difficulté persistante.
Le guide de rédaction prend en charge des indications explicites de dialogue, d’effets sonores et d’ambiance. Placez les paroles exactes entre guillemets, identifiez la personne qui parle et décrivez les sons en lien avec l’action visible. Un effet sonore et une atmosphère de fond ne doivent pas être confondus avec une réplique. L’anglais est documenté comme pleinement pris en charge pour les prompts, tandis que les autres langues n’ont pas été évaluées dans ce guide. Vérifiez les mots audibles, leur synchronisation et la qualité sonore comme parties du même livrable que la vidéo, au lieu de considérer l’audio comme une transcription garantie fidèle du prompt.
Le processus du producteur est asynchrone : une requête de génération renvoie une opération, et le résultat terminé est récupéré après que son statut indique la fin. Conservez l’identité de l’opération et examinez le clip renvoyé. Le guide décrit une conservation de deux jours côté producteur et un marquage SynthID ; un livrable conservé doit donc comprendre le résultat téléchargé, le prompt, les images sources et les réglages choisis. Une graine peut améliorer la répétabilité sans garantir le déterminisme. Vérifiez la continuité du sujet, l’action, le cadrage, le son et le point d’arrivée prévu avant d’utiliser le clip dans un montage ; la fin du traitement ne prouve pas à elle seule que les exigences créatives sont remplies.
", "aboutText": "Veo 3.1 Lite est le membre Lite de la gamme de génération vidéo Veo 3 de Google. Il synthétise une vidéo avec audio à partir d’une description en langage naturel ou d’une image d’entrée. La sortie est un clip généré, pas une analyse textuelle d’un enregistrement existant. La fiche Lite du fabricant renvoie à Veo 3 pour l’architecture sous-jacente, les données d’entraînement et les limitations connues, tandis que la documentation propre à Lite définit ses fonctions et limites de génération.\n\nL’architecture citée utilise la diffusion latente sur des représentations audio temporelles et vidéo spatio-temporelles. Le modèle de base a été entraîné sur de l’audio, des vidéos et des images, avec des légendes de niveaux de détail différents, et des données filtrées et dédupliquées. Cela explique sa finalité de génération conjointe d’image et d’audio. Cela ne divulgue pas un nombre de paramètres propre à Lite ni ne prouve que chaque mouvement généré respecte la réalité physique. Pour une scène pratique, décidez ensemble de l’action visible et du son correspondant.\n\nLa documentation exacte de Lite indique une limite d’entrée textuelle de 1 024 tokens et une vidéo en sortie. La colonne Lite du guide de génération répertorie des durées de 4, 6 et 8 secondes, avec 720p par défaut et 1080p nécessitant un clip de 8 secondes. Le rapport paysage 16:9 est celui par défaut et le portrait 9:16 est également proposé ; la sortie est documentée à 24 images par seconde. L’audio natif est toujours actif dans ce processus. Ces valeurs appartiennent au processus Lite nommé du producteur, pas à une autre édition Veo ni à une réponse d’application mesurée séparément.\n\nLite ne prend pas en charge la sortie 4K ni l’extension vidéo. Le tableau des paramètres indique aussi comme indisponibles dans la colonne Lite la fonction multiréférence referenceImages et l’entrée vidéo d’extension. Une image initiale peut établir la première image du clip ; le tableau répertorie une image lastFrame associée à cette image initiale pour une transition. Distinguez cette voie de contrôle des images limites du mélange de plusieurs références de style ou de sujet. Les réglages de génération de personnes du producteur dépendent du mode : le tableau Lite indique allow_all pour texte-vers-vidéo et allow_adult pour image-vers-vidéo et l’interpolation, tandis que des règles régionales peuvent restreindre davantage ce profil documenté. Choisissez une image de départ correspondant à la première scène réellement souhaitée, avec le sujet, le cadrage et les détails visibles préparés avant de demander du mouvement.\n\nPour texte-vers-vidéo, décrivez le sujet, son action, l’environnement et le style prévu. Ajoutez la position et le mouvement de caméra, le cadrage, la mise au point et la lumière lorsqu’ils comptent. Une scène produit originale pourrait garder l’objet centré pendant que la caméra s’approche d’un détail de matériau et que la lumière environnante change doucement. Identifiez l’état initial, l’action principale et le dernier instant pour que le court clip exprime une idée cohérente. Une longue suite d’actions sans rapport constitue une autre tâche qu’un plan ciblé.\n\nPour image-vers-vidéo, fournissez une image initiale claire et expliquez ce qui doit bouger et ce qui doit rester stable. Précisez séparément le mouvement du sujet et tout mouvement de caméra. Si vous utilisez une contrainte d’image finale, préparez une composition finale compatible et décrivez la transition entre les deux. Examinez le résultat au lieu de supposer que l’identité, la position ou la forme demandées restent identiques tout au long du clip. La fiche citée du modèle reconnaît la cohérence complète dans les scènes complexes et les mouvements complexes comme une difficulté persistante.\n\nLe guide de rédaction prend en charge des indications explicites de dialogue, d’effets sonores et d’ambiance. Placez les paroles exactes entre guillemets, identifiez la personne qui parle et décrivez les sons en lien avec l’action visible. Un effet sonore et une atmosphère de fond ne doivent pas être confondus avec une réplique. L’anglais est documenté comme pleinement pris en charge pour les prompts, tandis que les autres langues n’ont pas été évaluées dans ce guide. Vérifiez les mots audibles, leur synchronisation et la qualité sonore comme parties du même livrable que la vidéo, au lieu de considérer l’audio comme une transcription garantie fidèle du prompt.\n\nLe processus du producteur est asynchrone : une requête de génération renvoie une opération, et le résultat terminé est récupéré après que son statut indique la fin. Conservez l’identité de l’opération et examinez le clip renvoyé. Le guide décrit une conservation de deux jours côté producteur et un marquage SynthID ; un livrable conservé doit donc comprendre le résultat téléchargé, le prompt, les images sources et les réglages choisis. Une graine peut améliorer la répétabilité sans garantir le déterminisme. Vérifiez la continuité du sujet, l’action, le cadrage, le son et le point d’arrivée prévu avant d’utiliser le clip dans un montage ; la fin du traitement ne prouve pas à elle seule que les exigences créatives sont remplies.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "9690a86d9e1e983da4c62119696a7f44e9d9e422816655b32ec97d5bb756d77e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-be", "methods": [ { "html": "google/veo-3.1-liteTransformez la description d’une scène en une vidéo de 4, 6 ou 8 secondes en 720p.
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 Lite est le membre Lite de la gamme de génération vidéo Veo 3 de Google. Il synthétise une vidéo avec audio à partir d’une description en langage naturel ou d’une image d’entrée. La sortie est un clip généré, pas une analyse textuelle d’un enregistrement existant. La fiche Lite du fabricant renvoie à Veo 3 pour l’architecture sous-jacente, les données d’entraînement et les limitations connues, tandis que la documentation propre à Lite définit ses fonctions et limites de génération.
L’architecture citée utilise la diffusion latente sur des représentations audio temporelles et vidéo spatio-temporelles. Le modèle de base a été entraîné sur de l’audio, des vidéos et des images, avec des légendes de niveaux de détail différents, et des données filtrées et dédupliquées. Cela explique sa finalité de génération conjointe d’image et d’audio. Cela ne divulgue pas un nombre de paramètres propre à Lite ni ne prouve que chaque mouvement généré respecte la réalité physique. Pour une scène pratique, décidez ensemble de l’action visible et du son correspondant.
La documentation exacte de Lite indique une limite d’entrée textuelle de 1 024 tokens et une vidéo en sortie. La colonne Lite du guide de génération répertorie des durées de 4, 6 et 8 secondes, avec 720p par défaut et 1080p nécessitant un clip de 8 secondes. Le rapport paysage 16:9 est celui par défaut et le portrait 9:16 est également proposé ; la sortie est documentée à 24 images par seconde. L’audio natif est toujours actif dans ce processus. Ces valeurs appartiennent au processus Lite nommé du producteur, pas à une autre édition Veo ni à une réponse d’application mesurée séparément.
Lite ne prend pas en charge la sortie 4K ni l’extension vidéo. Le tableau des paramètres indique aussi comme indisponibles dans la colonne Lite la fonction multiréférence referenceImages et l’entrée vidéo d’extension. Une image initiale peut établir la première image du clip ; le tableau répertorie une image lastFrame associée à cette image initiale pour une transition. Distinguez cette voie de contrôle des images limites du mélange de plusieurs références de style ou de sujet. Les réglages de génération de personnes du producteur dépendent du mode : le tableau Lite indique allow_all pour texte-vers-vidéo et allow_adult pour image-vers-vidéo et l’interpolation, tandis que des règles régionales peuvent restreindre davantage ce profil documenté. Choisissez une image de départ correspondant à la première scène réellement souhaitée, avec le sujet, le cadrage et les détails visibles préparés avant de demander du mouvement.
Pour texte-vers-vidéo, décrivez le sujet, son action, l’environnement et le style prévu. Ajoutez la position et le mouvement de caméra, le cadrage, la mise au point et la lumière lorsqu’ils comptent. Une scène produit originale pourrait garder l’objet centré pendant que la caméra s’approche d’un détail de matériau et que la lumière environnante change doucement. Identifiez l’état initial, l’action principale et le dernier instant pour que le court clip exprime une idée cohérente. Une longue suite d’actions sans rapport constitue une autre tâche qu’un plan ciblé.
Pour image-vers-vidéo, fournissez une image initiale claire et expliquez ce qui doit bouger et ce qui doit rester stable. Précisez séparément le mouvement du sujet et tout mouvement de caméra. Si vous utilisez une contrainte d’image finale, préparez une composition finale compatible et décrivez la transition entre les deux. Examinez le résultat au lieu de supposer que l’identité, la position ou la forme demandées restent identiques tout au long du clip. La fiche citée du modèle reconnaît la cohérence complète dans les scènes complexes et les mouvements complexes comme une difficulté persistante.
Le guide de rédaction prend en charge des indications explicites de dialogue, d’effets sonores et d’ambiance. Placez les paroles exactes entre guillemets, identifiez la personne qui parle et décrivez les sons en lien avec l’action visible. Un effet sonore et une atmosphère de fond ne doivent pas être confondus avec une réplique. L’anglais est documenté comme pleinement pris en charge pour les prompts, tandis que les autres langues n’ont pas été évaluées dans ce guide. Vérifiez les mots audibles, leur synchronisation et la qualité sonore comme parties du même livrable que la vidéo, au lieu de considérer l’audio comme une transcription garantie fidèle du prompt.
Le processus du producteur est asynchrone : une requête de génération renvoie une opération, et le résultat terminé est récupéré après que son statut indique la fin. Conservez l’identité de l’opération et examinez le clip renvoyé. Le guide décrit une conservation de deux jours côté producteur et un marquage SynthID ; un livrable conservé doit donc comprendre le résultat téléchargé, le prompt, les images sources et les réglages choisis. Une graine peut améliorer la répétabilité sans garantir le déterminisme. Vérifiez la continuité du sujet, l’action, le cadrage, le son et le point d’arrivée prévu avant d’utiliser le clip dans un montage ; la fin du traitement ne prouve pas à elle seule que les exigences créatives sont remplies.
POST /v1/videostext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites google/veo-3.1-lite | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 Nombre maximal d’octets: 10 000 Unité: octets UTF8 | Par défaut— |
Champduration | Typeinteger | ExigenceObligatoire | Valeurs et limites 4, 6, 8 Unité: secondes | 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 | Par défaut— |
Champframe_images | Typearray | ExigenceFacultatif | Valeurs et limites Conditions: Omettez ce champ pour text_to_video. Lorsqu’il est présent : exactement un élément {"type":"image_url","image_url":{"url":"<actual HTTPS URL>"},"frame_type":"first_frame"} ; l’élément contient exactement type,image_url,frame_type ; image_url contient exactement url. Aucune clé supplémentaire ou en double. Uniquement duration=4,resolution="720p",aspect_ratio="16:9",generate_audio=false. L’URL doit être analysable avec le schéma https, un nom d’hôte non vide, sans userinfo ni caractère # littéral ; la chaîne de requête signée et le chemin encodé sont conservés. Le code source ne vérifie ni le type MIME d’entrée, ni la taille du fichier, ni les dimensions en pixels. | Par défaut— |
Texte vers vidéo · Obligatoire : prompt
Image vers vidéo · Obligatoire : prompt, frame_images
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Paramètreother_options | Contratfalse |
Paramètreresolution | Contrat720p |
Paramètreprompt_max_bytes | Contrat10000 |
Paramètreduration | Contrat4, 6, 8 |
Paramètreaspect_ratio | Contrat16:9, 9:16 |
Paramètregenerate_audio | Contratfalse |
Paramètrematerial_types | Contrattext, image |
Paramètreparameters | Contrat{"name":"model","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["google/veo-3.1-lite"],"availability":"source_interface"}, {"name":"prompt","type":"string","required":true,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","min_length":1,"maximum_bytes":10000,"maximum_length":null,"unit":"octets UTF8"}, {"name":"duration","type":"integer","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[4,6,8],"availability":"source_interface","unit":"secondes"}, {"name":"resolution","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["720p"],"availability":"source_interface"}, {"name":"aspect_ratio","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["16:9","9:16"],"availability":"source_interface"}, {"name":"generate_audio","type":"boolean","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[false],"availability":"source_interface"}, {"name":"frame_images","type":"array","required":false,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","conditions":"Omettez ce champ pour text_to_video. Lorsqu’il est présent : exactement un élément {\\"type\\":\\"image_url\\",\\"image_url\\":{\\"url\\":\\"<actual HTTPS URL>\\"},\\"frame_type\\":\\"first_frame\\"} ; l’élément contient exactement type,image_url,frame_type ; image_url contient exactement url. Aucune clé supplémentaire ou en double. Uniquement duration=4,resolution=\\"720p\\",aspect_ratio=\\"16:9\\",generate_audio=false. L’URL doit être analysable avec le schéma https, un nom d’hôte non vide, sans userinfo ni caractère # littéral ; la chaîne de requête signée et le chemin encodé sont conservés. Le code source ne vérifie ni le type MIME d’entrée, ni la taille du fichier, ni les dimensions en pixels."} |
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
Créez une seule fois et enregistrez l’ID renvoyé.
Interrogez périodiquement l’état d’origine ; conservez chaque ressource terminée et sa durée.
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.
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 · 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 |
| 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.16 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 : 720p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.1 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 | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.1 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.06 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 ne constitue pas la quantité facturable. |
| ConfigurationCoût estimé de la génération | 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.24 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 →
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.
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.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. |
| ConfigurationTarif vidéo | Conditions de facturationaudio : without_audio | Coût Sortie · Tarif vidéo $0.1 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.1 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.06 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. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/veo-3.1-lite", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 4, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": false}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the actual HTTPS URL of your first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os,re\nfrom pathlib import Path\nfrom urllib.parse import urlsplit\nimage=os.environ["AILOOT_IMAGE_URL"]\ntry:\n parsed=urlsplit(image)\n valid=(image.startswith("https://") and parsed.scheme=="https" and bool(parsed.hostname)\n and parsed.username is None and parsed.password is None and "#" not in image\n and not any(ord(c)<32 or ord(c)==127 for c in image)\n and re.search(r"%(?![0-9A-Fa-f]{2})",image) is None)\nexcept ValueError:\n valid=False\nif not valid:\n raise SystemExit("Use your actual HTTPS image URL with a hostname, no userinfo and no fragment")\np={"model":"google/veo-3.1-lite","prompt":"The subject makes a slow, natural movement. Keep the opening composition.","duration":4,"resolution":"720p","aspect_ratio":"16:9","generate_audio":False,"frame_images":[{"type":"image_url","image_url":{"url":image},"frame_type":"first_frame"}]}\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint("Keep the complete JSON, headers and original returned id. Use the existing GET status tab for that original operation, then save every completed owned output. Never resubmit an unknown generation.")\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nEnregistrez 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, data[] contient toutes les URL de contenu signées dont vous êtes propriétaire. Récupérez chaque URL renvoyée, ou utilisez le point de terminaison de contenu avec index défini sur un index de sortie réel. Une tâche d’origine échouée peut renvoyer charge_pending_check ; vérifiez cette tâche d’origine au lieu de la créer à nouveau. 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.
Consultez la tâche d’origine existante ; ne soumettez jamais de nouveau un envoi dont l’issue est inconnue.
Nombre maximal de sorties : 4.
| 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 ID vidéo public d’origine est renvoyé dans id. |
Champerror.type | Typestring | Significationserver_error en cas de HTTP503 result_pending_check. |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteInterrogez périodiquement l’ID 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 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 id et operation_id d’origine, qui correspondent au même ID vidéo public, ainsi que la réponse et les en-têtes ; consultez uniquement l’état ou le contenu d’origine. Ne soumettez jamais de nouvelle requête de génération. |
Réponse422 · price_unavailable | ConditionL’analyse d’un objet frame_images fourni ou de son profil conditionnel échoue, ou le profil entièrement analysé ne dispose d’aucune fiche tarifaire exacte prête à l’emploi. | Étape suivanteConservez model, prompt, duration, resolution, aspect_ratio et generate_audio. Ajoutez frame_images contenant exactement un élément first_frame au format d’objet précisé. Définissez duration=4, resolution="720p", aspect_ratio="16:9" et generate_audio=false. Cette validation s’exécute avant l’envoi de la requête. |
Ailoot Ultra google/veo-3.1-lite
/v1/videos/generations, /videos, /videos/generations