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é et non 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 limites connues, tandis que la documentation propre à Lite définit ses fonctions et limites de génération.
L’architecture référencé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 à différents niveaux de détail, et des données d’entraînement filtrées et dédupliquées. Cela explique l’objectif de génération conjointe d’image et de son. Cela ne révèle pas de nombre de paramètres propre à Lite et n’établit pas 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 Lite donne une limite d’entrée textuelle de 1’024 tokens et une vidéo de sortie. La colonne Lite du guide de génération indique 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 indiqué ; la sortie est documentée à 24 images par seconde. L’audio natif est toujours activé dans ce processus. Ces valeurs appartiennent au processus Lite nommé du producteur, et non à une édition Veo sans rapport ou à une réponse d’application mesurée séparément.
Lite ne prend en charge ni la sortie 4K ni le prolongement vidéo. Le tableau des paramètres marque également la fonction multiréférence referenceImages et une entrée vidéo pour le prolongement comme indisponibles dans la colonne Lite. Une image initiale peut établir la première image ; le tableau indique une image lastFrame avec cette image initiale pour une transition. Gardez ce parcours de contrôle par images distinct 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 la vidéo à partir de texte et allow_adult pour la vidéo à partir d’image et l’interpolation, tandis que les règles régionales peuvent restreindre davantage ce profil documenté. Choisissez l’image de départ pour correspondre à la première scène réellement voulue, avec le sujet, le cadrage et les détails visibles préparés avant de demander du mouvement.
Pour la vidéo à partir de texte, décrivez le sujet, son action, l’environnement et le style souhaité. Ajoutez position et mouvement de caméra, cadrage, mise au point et lumière lorsqu’ils comptent. Une scène originale de produit pourrait garder l’objet centré pendant que la caméra s’approche d’un détail de matière et que la lumière environnante change doucement. Identifiez l’état initial, l’action principale et le moment final pour que le court clip développe une idée cohérente. Une longue collection d’actions sans lien constitue une tâche différente d’un plan ciblé.
Pour la vidéo à partir d’image, fournissez une première image 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 de fin compatible et décrivez la transition entre les deux. Examinez le résultat au lieu de supposer qu’une identité, une position ou une forme demandée reste identique tout au long du clip. La fiche du modèle référencée identifie la cohérence complète dans les scènes complexes et les mouvements complexes comme un défi persistant.
Le guide de prompts prend en charge des indications explicites pour les dialogues, effets sonores et ambiances. Mettez la parole exacte entre guillemets, identifiez le locuteur et décrivez les sons en rapport avec l’action visible. Un effet sonore et une ambiance 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 temporalité 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 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 obtenu après que son état 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 souhaité 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é et non 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 limites connues, tandis que la documentation propre à Lite définit ses fonctions et limites de génération.\n\nL’architecture référencé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 à différents niveaux de détail, et des données d’entraînement filtrées et dédupliquées. Cela explique l’objectif de génération conjointe d’image et de son. Cela ne révèle pas de nombre de paramètres propre à Lite et n’établit pas 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 Lite donne une limite d’entrée textuelle de 1’024 tokens et une vidéo de sortie. La colonne Lite du guide de génération indique 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 indiqué ; la sortie est documentée à 24 images par seconde. L’audio natif est toujours activé dans ce processus. Ces valeurs appartiennent au processus Lite nommé du producteur, et non à une édition Veo sans rapport ou à une réponse d’application mesurée séparément.\n\nLite ne prend en charge ni la sortie 4K ni le prolongement vidéo. Le tableau des paramètres marque également la fonction multiréférence referenceImages et une entrée vidéo pour le prolongement comme indisponibles dans la colonne Lite. Une image initiale peut établir la première image ; le tableau indique une image lastFrame avec cette image initiale pour une transition. Gardez ce parcours de contrôle par images distinct 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 la vidéo à partir de texte et allow_adult pour la vidéo à partir d’image et l’interpolation, tandis que les règles régionales peuvent restreindre davantage ce profil documenté. Choisissez l’image de départ pour correspondre à la première scène réellement voulue, avec le sujet, le cadrage et les détails visibles préparés avant de demander du mouvement.\n\nPour la vidéo à partir de texte, décrivez le sujet, son action, l’environnement et le style souhaité. Ajoutez position et mouvement de caméra, cadrage, mise au point et lumière lorsqu’ils comptent. Une scène originale de produit pourrait garder l’objet centré pendant que la caméra s’approche d’un détail de matière et que la lumière environnante change doucement. Identifiez l’état initial, l’action principale et le moment final pour que le court clip développe une idée cohérente. Une longue collection d’actions sans lien constitue une tâche différente d’un plan ciblé.\n\nPour la vidéo à partir d’image, fournissez une première image 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 de fin compatible et décrivez la transition entre les deux. Examinez le résultat au lieu de supposer qu’une identité, une position ou une forme demandée reste identique tout au long du clip. La fiche du modèle référencée identifie la cohérence complète dans les scènes complexes et les mouvements complexes comme un défi persistant.\n\nLe guide de prompts prend en charge des indications explicites pour les dialogues, effets sonores et ambiances. Mettez la parole exacte entre guillemets, identifiez le locuteur et décrivez les sons en rapport avec l’action visible. Un effet sonore et une ambiance 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 temporalité 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 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 obtenu après que son état 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 souhaité 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": "43a487b1f453b8b50d50fc94b59e1734f15f26c8e4b9c95769a227c794a3d439", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "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é et non 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 limites connues, tandis que la documentation propre à Lite définit ses fonctions et limites de génération.
L’architecture référencé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 à différents niveaux de détail, et des données d’entraînement filtrées et dédupliquées. Cela explique l’objectif de génération conjointe d’image et de son. Cela ne révèle pas de nombre de paramètres propre à Lite et n’établit pas 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 Lite donne une limite d’entrée textuelle de 1’024 tokens et une vidéo de sortie. La colonne Lite du guide de génération indique 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 indiqué ; la sortie est documentée à 24 images par seconde. L’audio natif est toujours activé dans ce processus. Ces valeurs appartiennent au processus Lite nommé du producteur, et non à une édition Veo sans rapport ou à une réponse d’application mesurée séparément.
Lite ne prend en charge ni la sortie 4K ni le prolongement vidéo. Le tableau des paramètres marque également la fonction multiréférence referenceImages et une entrée vidéo pour le prolongement comme indisponibles dans la colonne Lite. Une image initiale peut établir la première image ; le tableau indique une image lastFrame avec cette image initiale pour une transition. Gardez ce parcours de contrôle par images distinct 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 la vidéo à partir de texte et allow_adult pour la vidéo à partir d’image et l’interpolation, tandis que les règles régionales peuvent restreindre davantage ce profil documenté. Choisissez l’image de départ pour correspondre à la première scène réellement voulue, avec le sujet, le cadrage et les détails visibles préparés avant de demander du mouvement.
Pour la vidéo à partir de texte, décrivez le sujet, son action, l’environnement et le style souhaité. Ajoutez position et mouvement de caméra, cadrage, mise au point et lumière lorsqu’ils comptent. Une scène originale de produit pourrait garder l’objet centré pendant que la caméra s’approche d’un détail de matière et que la lumière environnante change doucement. Identifiez l’état initial, l’action principale et le moment final pour que le court clip développe une idée cohérente. Une longue collection d’actions sans lien constitue une tâche différente d’un plan ciblé.
Pour la vidéo à partir d’image, fournissez une première image 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 de fin compatible et décrivez la transition entre les deux. Examinez le résultat au lieu de supposer qu’une identité, une position ou une forme demandée reste identique tout au long du clip. La fiche du modèle référencée identifie la cohérence complète dans les scènes complexes et les mouvements complexes comme un défi persistant.
Le guide de prompts prend en charge des indications explicites pour les dialogues, effets sonores et ambiances. Mettez la parole exacte entre guillemets, identifiez le locuteur et décrivez les sons en rapport avec l’action visible. Un effet sonore et une ambiance 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 temporalité 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 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 obtenu après que son état 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 souhaité 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. S’il est présent : exactement un élément {"type":"image_url","image_url":{"url":"<URL HTTPS réelle>"},"frame_type":"first_frame"} ; cet é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 pouvoir être analysée avec le schéma https, un nom d’hôte non vide, sans userinfo ni caractère # littéral ; les paramètres de requête signés 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. S’il est présent : exactement un élément {\\"type\\":\\"image_url\\",\\"image_url\\":{\\"url\\":\\"<URL HTTPS réelle>\\"},\\"frame_type\\":\\"first_frame\\"} ; cet é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 pouvoir être analysée avec le schéma https, un nom d’hôte non vide, sans userinfo ni caractère # littéral ; les paramètres de requête signés 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’identifiant renvoyé.
Consultez 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 facturationson : 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 facturationson : 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 facturationson : 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. 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. |
| 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 facturationson : 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 facturationson : 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 facturationson : 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 facturationson : 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 indice réel de sortie. Une tâche d’origine en échec peut renvoyer charge_pending_check ; vérifiez cette tâche d’origine au lieu de la recréer. 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.
Consultez la tâche d’origine existante ; ne répétez jamais 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 pour l’état ou le contenu d’origine : le même identifiant vidéo public d’origine est renvoyé dans id. |
Champerror.type | Typestring | Significationserver_error dans une réponse 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 suivanteConsultez périodiquement 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 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. |
Réponse422 · price_unavailable | ConditionL’analyse d’un objet frame_images fourni ou de son profil conditionnel échoue, ou le profil complet 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 dans le format d’objet spécifié. 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