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 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 une diffusion latente sur des représentations audio temporelles et des représentations vidéo spatio-temporelles. Le modèle de base a été entraîné sur des contenus audio, vidéo et image, accompagnés de légendes de différents niveaux de détail, avec des données filtrées et dédupliquées. Cela explique son objectif de génération conjointe de l’image et du son. Cela ne révèle pas un 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 fixe 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 prévoit 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 fournisseur, pas à une édition Veo sans rapport 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 également que la fonction de références multiples referenceImages et l’entrée vidéo pour l’extension sont indisponibles dans la colonne Lite. Une image initiale peut établir la première image ; le tableau prévoit une image lastFrame avec cette image initiale pour une transition. Distinguez ce contrôle par images de début et de fin du mélange de plusieurs références de style ou de sujet. Les réglages de génération de personnes du fournisseur dépendent du mode : le tableau Lite prévoit allow_all pour la génération à partir de texte et allow_adult pour la génération à partir d’une image et l’interpolation, tandis que les règles régionales peuvent encore restreindre ce profil documenté. Choisissez l’image de départ selon la première scène réellement souhaitée, en préparant le sujet, le cadrage et les détails visibles avant de demander du mouvement.
Pour la génération à partir de texte, décrivez le sujet, son action, l’environnement et le style voulu. Ajoutez la position et le mouvement de caméra, le cadrage, la mise au point et la lumière lorsque ces éléments comptent. Une scène originale de produit peut garder l’objet au centre pendant que la caméra se rapproche 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 clip court développe une idée cohérente. Une longue collection d’actions sans lien constitue une autre tâche qu’un plan ciblé.
Pour la génération à partir d’une image, 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 celui de la caméra. Si vous utilisez une contrainte d’image finale, préparez une composition d’arrivée compatible et décrivez la transition entre les deux. Inspectez le résultat sans supposer qu’une identité, une position ou une forme demandée reste identique tout au long du clip. La fiche référencée identifie la cohérence complète des scènes complexes et les mouvements complexes comme des difficultés persistantes.
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 relation 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 entièrement 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, le timing et la qualité sonore comme parties du même livrable que la vidéo, sans considérer l’audio comme une transcription nécessairement fidèle du prompt.
Le processus du fournisseur est asynchrone : une demande de génération renvoie une opération, et le résultat achevé est récupéré lorsque son statut indique la fin. Conservez l’identité de l’opération et inspectez le clip renvoyé. Le guide décrit une conservation de deux jours côté fournisseur 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 l’aboutissement prévu de la scène avant d’utiliser le clip dans un montage ; la fin du traitement seule ne prouve pas que les exigences créatives ont été satisfaites.
", "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 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 une diffusion latente sur des représentations audio temporelles et des représentations vidéo spatio-temporelles. Le modèle de base a été entraîné sur des contenus audio, vidéo et image, accompagnés de légendes de différents niveaux de détail, avec des données filtrées et dédupliquées. Cela explique son objectif de génération conjointe de l’image et du son. Cela ne révèle pas un 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 fixe 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 prévoit 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 fournisseur, pas à une édition Veo sans rapport 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 également que la fonction de références multiples referenceImages et l’entrée vidéo pour l’extension sont indisponibles dans la colonne Lite. Une image initiale peut établir la première image ; le tableau prévoit une image lastFrame avec cette image initiale pour une transition. Distinguez ce contrôle par images de début et de fin du mélange de plusieurs références de style ou de sujet. Les réglages de génération de personnes du fournisseur dépendent du mode : le tableau Lite prévoit allow_all pour la génération à partir de texte et allow_adult pour la génération à partir d’une image et l’interpolation, tandis que les règles régionales peuvent encore restreindre ce profil documenté. Choisissez l’image de départ selon la première scène réellement souhaitée, en préparant le sujet, le cadrage et les détails visibles avant de demander du mouvement.\n\nPour la génération à partir de texte, décrivez le sujet, son action, l’environnement et le style voulu. Ajoutez la position et le mouvement de caméra, le cadrage, la mise au point et la lumière lorsque ces éléments comptent. Une scène originale de produit peut garder l’objet au centre pendant que la caméra se rapproche 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 clip court développe une idée cohérente. Une longue collection d’actions sans lien constitue une autre tâche qu’un plan ciblé.\n\nPour la génération à partir d’une image, 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 celui de la caméra. Si vous utilisez une contrainte d’image finale, préparez une composition d’arrivée compatible et décrivez la transition entre les deux. Inspectez le résultat sans supposer qu’une identité, une position ou une forme demandée reste identique tout au long du clip. La fiche référencée identifie la cohérence complète des scènes complexes et les mouvements complexes comme des difficultés persistantes.\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 relation 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 entièrement 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, le timing et la qualité sonore comme parties du même livrable que la vidéo, sans considérer l’audio comme une transcription nécessairement fidèle du prompt.\n\nLe processus du fournisseur est asynchrone : une demande de génération renvoie une opération, et le résultat achevé est récupéré lorsque son statut indique la fin. Conservez l’identité de l’opération et inspectez le clip renvoyé. Le guide décrit une conservation de deux jours côté fournisseur 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 l’aboutissement prévu de la scène avant d’utiliser le clip dans un montage ; la fin du traitement seule ne prouve pas que les exigences créatives ont été satisfaites.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0a116e22ea8f4fa72fdf796b95550518d03ad1ff07dfe5f532aac70057cfefd1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr", "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 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 une diffusion latente sur des représentations audio temporelles et des représentations vidéo spatio-temporelles. Le modèle de base a été entraîné sur des contenus audio, vidéo et image, accompagnés de légendes de différents niveaux de détail, avec des données filtrées et dédupliquées. Cela explique son objectif de génération conjointe de l’image et du son. Cela ne révèle pas un 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 fixe 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 prévoit 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 fournisseur, pas à une édition Veo sans rapport 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 également que la fonction de références multiples referenceImages et l’entrée vidéo pour l’extension sont indisponibles dans la colonne Lite. Une image initiale peut établir la première image ; le tableau prévoit une image lastFrame avec cette image initiale pour une transition. Distinguez ce contrôle par images de début et de fin du mélange de plusieurs références de style ou de sujet. Les réglages de génération de personnes du fournisseur dépendent du mode : le tableau Lite prévoit allow_all pour la génération à partir de texte et allow_adult pour la génération à partir d’une image et l’interpolation, tandis que les règles régionales peuvent encore restreindre ce profil documenté. Choisissez l’image de départ selon la première scène réellement souhaitée, en préparant le sujet, le cadrage et les détails visibles avant de demander du mouvement.
Pour la génération à partir de texte, décrivez le sujet, son action, l’environnement et le style voulu. Ajoutez la position et le mouvement de caméra, le cadrage, la mise au point et la lumière lorsque ces éléments comptent. Une scène originale de produit peut garder l’objet au centre pendant que la caméra se rapproche 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 clip court développe une idée cohérente. Une longue collection d’actions sans lien constitue une autre tâche qu’un plan ciblé.
Pour la génération à partir d’une image, 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 celui de la caméra. Si vous utilisez une contrainte d’image finale, préparez une composition d’arrivée compatible et décrivez la transition entre les deux. Inspectez le résultat sans supposer qu’une identité, une position ou une forme demandée reste identique tout au long du clip. La fiche référencée identifie la cohérence complète des scènes complexes et les mouvements complexes comme des difficultés persistantes.
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 relation 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 entièrement 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, le timing et la qualité sonore comme parties du même livrable que la vidéo, sans considérer l’audio comme une transcription nécessairement fidèle du prompt.
Le processus du fournisseur est asynchrone : une demande de génération renvoie une opération, et le résultat achevé est récupéré lorsque son statut indique la fin. Conservez l’identité de l’opération et inspectez le clip renvoyé. Le guide décrit une conservation de deux jours côté fournisseur 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 l’aboutissement prévu de la scène avant d’utiliser le clip dans un montage ; la fin du traitement seule ne prouve pas que les exigences créatives ont été satisfaites.
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":"<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 pouvoir être analysée avec le schéma https, un nom d’hôte non vide, sans informations utilisateur ni caractère # littéral ; la 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. S’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 pouvoir être analysée avec le schéma https, un nom d’hôte non vide, sans informations utilisateur ni caractère # littéral ; la 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’identifiant renvoyé.
Interrogez le statut 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 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 |
| 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 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.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 signées de contenu vous appartenant. 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 en échec peut renvoyer charge_pending_check ; vérifiez cette même 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 à 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 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. |
| 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 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. |
Réponse422 · price_unavailable | ConditionUn objet frame_images fourni ou son profil conditionnel ne peut pas être analysé, ou le profil analysé complet 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 indiqué. 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