{ "aboutHtml": "

FLUX 3 Video est le modèle multimodal de Black Forest Labs destiné à générer des vidéos avec un son synchronisé. Il crée des scènes à partir d’un brief textuel, construit le mouvement autour d’images imposées ou prolonge un clip existant. La parole, les effets et l’ambiance sonore peuvent être générés en même temps que les images, pour produire une courte scène dont les mouvements de caméra, l’action et le son sont conçus comme une seule séquence.

Pour la génération de vidéo à partir de texte, décrivez le sujet, le décor, l’action visible, le comportement de la caméra et le son. Une scène de présentation de produit peut commencer par une vue large, se rapprocher d’un détail de matière et se terminer sur le produit en cours d’utilisation. Un brief comportant plusieurs plans peut préciser chaque plan et la transition entre les angles de caméra, tout en préservant la cohérence du sujet et du style visuel sur toute la séquence. Du texte peut apparaître dans la scène : fournissez donc les mots exacts et leur emplacement lorsqu’une enseigne ou un titre a de l’importance. Le modèle couvre les prises de vues réelles, l’animation, l’habillage graphique animé et les rendus stylisés.

La génération de vidéo à partir d’images utilise entre une et dix images clés. Une seule image définit l’image d’ouverture ; deux images fixent le début et la fin, tandis que des images ordonnées et horodatées guident des moments précis du clip. Ces images deviennent des images de la vidéo et ne servent pas uniquement de références générales de style. Avec au moins trois images sans horodatage, le producteur exige une durée explicite : la première et la dernière fixent les extrémités, et les autres sont réparties à intervalles réguliers entre elles. Les images horodatées doivent suivre l’ordre chronologique ; la durée automatique s’étend jusqu’au dernier horodatage, arrondi à la seconde supérieure, dans la limite de 20 secondes. Préparez des images clés dont les sujets, le cadrage et les détails visuels sont compatibles, puis décrivez le mouvement qui les relie. Pour révéler un produit, la première image peut montrer l’objet fermé et la dernière sa configuration ouverte, l’action intermédiaire étant définie dans le prompt.

Le prolongement vidéo reprend à partir des dernières images du clip fourni. Le processus de lancement utilise jusqu’à quatre secondes de vidéo et de son existants comme contexte pour l’action suivante, afin de conserver le comportement de la caméra, le mouvement et le son au raccord. Choisissez une fin de clip qui indique clairement la trajectoire du sujet et de la caméra, puis décrivez la suite. Prolonger une vidéo diffère de la réécriture d’un plan existant : FLUX Video Edit est un modèle de montage distinct et ne fait pas partie du modèle de génération du seul fait que les deux acceptent des vidéos.

La génération guidée par du texte ou des images prend en charge des clips de 5 à 20 secondes. La présentation propre au mode de prolongement vidéo indique une durée de sortie de 5 à 15 secondes. La durée et le rapport largeur/hauteur peuvent être choisis automatiquement, ou le brief peut préciser un format paysage, carré ou portrait pris en charge, notamment 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 et 9:21. La sortie est à 24 images par seconde. Adaptez la durée à un petit nombre d’actions visibles plutôt que d’essayer de faire tenir une histoire entière dans une courte génération.

La sortie HD provient directement de la génération ; les sorties FHD, QHD et UHD finalisent la même scène à l’aide d’un outil d’augmentation de résolution vidéo. En 16:9, les dimensions livrées sont respectivement de 1280 × 704, 1920 × 1088, 2560 × 1440 et 3840 × 2176. Les dimensions sont alignées sur des multiples de 32 : une classe de résolution donnée peut donc différer des dimensions de livraison habituelles. Recadrez l’image finale lorsqu’un canevas standard exact est nécessaire, en préservant les éléments importants sur ses bords. La résolution supérieure constitue une étape de finition, et non une nouvelle interprétation du plan.

Le son natif est activé par défaut et peut être désactivé pour obtenir un clip muet. Pour un dialogue, citez la réplique, identifiez la personne qui parle et décrivez son interprétation ; la parole multilingue, les accents et la synchronisation labiale font partie des capacités audiovisuelles du modèle. Reliez le dialogue et les indications sonores à l’événement visible, par exemple la fermeture d’un couvercle ou des pas qui s’éloignent. Examinez la voix, le rythme et les mots prononcés en même temps que l’image, au lieu de traiter le son comme une couche indépendante ajoutée après la génération.

Le mode brouillon produit un aperçu HD et un ensemble de données de brouillon. Améliorez l’ensemble sélectionné pour effectuer le rendu de cette génération en qualité maximale ; envoyer le même prompt dans une nouvelle demande de rendu complet constitue une nouvelle interprétation et peut produire une prise différente. Les brouillons utilisent uniquement la HD, tandis que l’amélioration permet de choisir parmi les quatre classes de résolution et utilise la FHD par défaut. Ce fonctionnement permet d’explorer d’abord l’action et la composition, puis de finaliser la prise retenue aux dimensions de livraison prévues.

Le processus du producteur renvoie un identifiant de tâche avant que le MP4 soit prêt, puis fournit le clip terminé une fois le traitement achevé. Les adresses signées des résultats expirent au bout d’environ deux heures : conservez donc le fichier lui-même dès que le plan est sélectionné. Vérifiez les transitions entre images clés, les coupes, le texte, les détails du sujet et le raccord sonore par rapport au brief. Pour une séquence plus longue, conservez les références du plan réussi et le contexte de sa fin pour les utiliser comme entrée du clip suivant, plutôt que de supposer qu’une courte requête contient toute la production.

", "aboutText": "FLUX 3 Video est le modèle multimodal de Black Forest Labs destiné à générer des vidéos avec un son synchronisé. Il crée des scènes à partir d’un brief textuel, construit le mouvement autour d’images imposées ou prolonge un clip existant. La parole, les effets et l’ambiance sonore peuvent être générés en même temps que les images, pour produire une courte scène dont les mouvements de caméra, l’action et le son sont conçus comme une seule séquence.\n\nPour la génération de vidéo à partir de texte, décrivez le sujet, le décor, l’action visible, le comportement de la caméra et le son. Une scène de présentation de produit peut commencer par une vue large, se rapprocher d’un détail de matière et se terminer sur le produit en cours d’utilisation. Un brief comportant plusieurs plans peut préciser chaque plan et la transition entre les angles de caméra, tout en préservant la cohérence du sujet et du style visuel sur toute la séquence. Du texte peut apparaître dans la scène : fournissez donc les mots exacts et leur emplacement lorsqu’une enseigne ou un titre a de l’importance. Le modèle couvre les prises de vues réelles, l’animation, l’habillage graphique animé et les rendus stylisés.\n\nLa génération de vidéo à partir d’images utilise entre une et dix images clés. Une seule image définit l’image d’ouverture ; deux images fixent le début et la fin, tandis que des images ordonnées et horodatées guident des moments précis du clip. Ces images deviennent des images de la vidéo et ne servent pas uniquement de références générales de style. Avec au moins trois images sans horodatage, le producteur exige une durée explicite : la première et la dernière fixent les extrémités, et les autres sont réparties à intervalles réguliers entre elles. Les images horodatées doivent suivre l’ordre chronologique ; la durée automatique s’étend jusqu’au dernier horodatage, arrondi à la seconde supérieure, dans la limite de 20 secondes. Préparez des images clés dont les sujets, le cadrage et les détails visuels sont compatibles, puis décrivez le mouvement qui les relie. Pour révéler un produit, la première image peut montrer l’objet fermé et la dernière sa configuration ouverte, l’action intermédiaire étant définie dans le prompt.\n\nLe prolongement vidéo reprend à partir des dernières images du clip fourni. Le processus de lancement utilise jusqu’à quatre secondes de vidéo et de son existants comme contexte pour l’action suivante, afin de conserver le comportement de la caméra, le mouvement et le son au raccord. Choisissez une fin de clip qui indique clairement la trajectoire du sujet et de la caméra, puis décrivez la suite. Prolonger une vidéo diffère de la réécriture d’un plan existant : FLUX Video Edit est un modèle de montage distinct et ne fait pas partie du modèle de génération du seul fait que les deux acceptent des vidéos.\n\nLa génération guidée par du texte ou des images prend en charge des clips de 5 à 20 secondes. La présentation propre au mode de prolongement vidéo indique une durée de sortie de 5 à 15 secondes. La durée et le rapport largeur/hauteur peuvent être choisis automatiquement, ou le brief peut préciser un format paysage, carré ou portrait pris en charge, notamment 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 et 9:21. La sortie est à 24 images par seconde. Adaptez la durée à un petit nombre d’actions visibles plutôt que d’essayer de faire tenir une histoire entière dans une courte génération.\n\nLa sortie HD provient directement de la génération ; les sorties FHD, QHD et UHD finalisent la même scène à l’aide d’un outil d’augmentation de résolution vidéo. En 16:9, les dimensions livrées sont respectivement de 1280 × 704, 1920 × 1088, 2560 × 1440 et 3840 × 2176. Les dimensions sont alignées sur des multiples de 32 : une classe de résolution donnée peut donc différer des dimensions de livraison habituelles. Recadrez l’image finale lorsqu’un canevas standard exact est nécessaire, en préservant les éléments importants sur ses bords. La résolution supérieure constitue une étape de finition, et non une nouvelle interprétation du plan.\n\nLe son natif est activé par défaut et peut être désactivé pour obtenir un clip muet. Pour un dialogue, citez la réplique, identifiez la personne qui parle et décrivez son interprétation ; la parole multilingue, les accents et la synchronisation labiale font partie des capacités audiovisuelles du modèle. Reliez le dialogue et les indications sonores à l’événement visible, par exemple la fermeture d’un couvercle ou des pas qui s’éloignent. Examinez la voix, le rythme et les mots prononcés en même temps que l’image, au lieu de traiter le son comme une couche indépendante ajoutée après la génération.\n\nLe mode brouillon produit un aperçu HD et un ensemble de données de brouillon. Améliorez l’ensemble sélectionné pour effectuer le rendu de cette génération en qualité maximale ; envoyer le même prompt dans une nouvelle demande de rendu complet constitue une nouvelle interprétation et peut produire une prise différente. Les brouillons utilisent uniquement la HD, tandis que l’amélioration permet de choisir parmi les quatre classes de résolution et utilise la FHD par défaut. Ce fonctionnement permet d’explorer d’abord l’action et la composition, puis de finaliser la prise retenue aux dimensions de livraison prévues.\n\nLe processus du producteur renvoie un identifiant de tâche avant que le MP4 soit prêt, puis fournit le clip terminé une fois le traitement achevé. Les adresses signées des résultats expirent au bout d’environ deux heures : conservez donc le fichier lui-même dès que le plan est sélectionné. Vérifiez les transitions entre images clés, les coupes, le texte, les détails du sujet et le raccord sonore par rapport au brief. Pour une séquence plus longue, conservez les références du plan réussi et le contexte de sa fin pour les utiliser comme entrée du clip suivant, plutôt que de supposer qu’une courte requête contient toute la production.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cd86d249f1d1b1f0ed82f8982e0fda61678be3fcf2f9f715cbd2284d97fe4ea0", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-be", "methods": [ { "html": "
•

Black Forest Labs: FLUX.3 Video

Black Forest Labs /black-forest-labs/flux-3-video

Premiers pas

FLUX 3 Video crée des clips aux dialogues, effets et ambiances synchronisés à partir d’un texte, d’images imposées ou d’un clip à prolonger. Les images clés, la composition en plusieurs plans et l’amélioration des brouillons permettent de construire une séquence maîtrisée et de conserver la prise retenue.

Entrées acceptées
Texte · Images
Résultats
Vidéo
À propos du modèle

Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.

FLUX 3 Video est le modèle multimodal de Black Forest Labs destiné à générer des vidéos avec un son synchronisé. Il crée des scènes à partir d’un brief textuel, construit le mouvement autour d’images imposées ou prolonge un clip existant. La parole, les effets et l’ambiance sonore peuvent être générés en même temps que les images, pour produire une courte scène dont les mouvements de caméra, l’action et le son sont conçus comme une seule séquence.

Pour la génération de vidéo à partir de texte, décrivez le sujet, le décor, l’action visible, le comportement de la caméra et le son. Une scène de présentation de produit peut commencer par une vue large, se rapprocher d’un détail de matière et se terminer sur le produit en cours d’utilisation. Un brief comportant plusieurs plans peut préciser chaque plan et la transition entre les angles de caméra, tout en préservant la cohérence du sujet et du style visuel sur toute la séquence. Du texte peut apparaître dans la scène : fournissez donc les mots exacts et leur emplacement lorsqu’une enseigne ou un titre a de l’importance. Le modèle couvre les prises de vues réelles, l’animation, l’habillage graphique animé et les rendus stylisés.

La génération de vidéo à partir d’images utilise entre une et dix images clés. Une seule image définit l’image d’ouverture ; deux images fixent le début et la fin, tandis que des images ordonnées et horodatées guident des moments précis du clip. Ces images deviennent des images de la vidéo et ne servent pas uniquement de références générales de style. Avec au moins trois images sans horodatage, le producteur exige une durée explicite : la première et la dernière fixent les extrémités, et les autres sont réparties à intervalles réguliers entre elles. Les images horodatées doivent suivre l’ordre chronologique ; la durée automatique s’étend jusqu’au dernier horodatage, arrondi à la seconde supérieure, dans la limite de 20 secondes. Préparez des images clés dont les sujets, le cadrage et les détails visuels sont compatibles, puis décrivez le mouvement qui les relie. Pour révéler un produit, la première image peut montrer l’objet fermé et la dernière sa configuration ouverte, l’action intermédiaire étant définie dans le prompt.

Le prolongement vidéo reprend à partir des dernières images du clip fourni. Le processus de lancement utilise jusqu’à quatre secondes de vidéo et de son existants comme contexte pour l’action suivante, afin de conserver le comportement de la caméra, le mouvement et le son au raccord. Choisissez une fin de clip qui indique clairement la trajectoire du sujet et de la caméra, puis décrivez la suite. Prolonger une vidéo diffère de la réécriture d’un plan existant : FLUX Video Edit est un modèle de montage distinct et ne fait pas partie du modèle de génération du seul fait que les deux acceptent des vidéos.

La génération guidée par du texte ou des images prend en charge des clips de 5 à 20 secondes. La présentation propre au mode de prolongement vidéo indique une durée de sortie de 5 à 15 secondes. La durée et le rapport largeur/hauteur peuvent être choisis automatiquement, ou le brief peut préciser un format paysage, carré ou portrait pris en charge, notamment 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 et 9:21. La sortie est à 24 images par seconde. Adaptez la durée à un petit nombre d’actions visibles plutôt que d’essayer de faire tenir une histoire entière dans une courte génération.

La sortie HD provient directement de la génération ; les sorties FHD, QHD et UHD finalisent la même scène à l’aide d’un outil d’augmentation de résolution vidéo. En 16:9, les dimensions livrées sont respectivement de 1280 × 704, 1920 × 1088, 2560 × 1440 et 3840 × 2176. Les dimensions sont alignées sur des multiples de 32 : une classe de résolution donnée peut donc différer des dimensions de livraison habituelles. Recadrez l’image finale lorsqu’un canevas standard exact est nécessaire, en préservant les éléments importants sur ses bords. La résolution supérieure constitue une étape de finition, et non une nouvelle interprétation du plan.

Le son natif est activé par défaut et peut être désactivé pour obtenir un clip muet. Pour un dialogue, citez la réplique, identifiez la personne qui parle et décrivez son interprétation ; la parole multilingue, les accents et la synchronisation labiale font partie des capacités audiovisuelles du modèle. Reliez le dialogue et les indications sonores à l’événement visible, par exemple la fermeture d’un couvercle ou des pas qui s’éloignent. Examinez la voix, le rythme et les mots prononcés en même temps que l’image, au lieu de traiter le son comme une couche indépendante ajoutée après la génération.

Le mode brouillon produit un aperçu HD et un ensemble de données de brouillon. Améliorez l’ensemble sélectionné pour effectuer le rendu de cette génération en qualité maximale ; envoyer le même prompt dans une nouvelle demande de rendu complet constitue une nouvelle interprétation et peut produire une prise différente. Les brouillons utilisent uniquement la HD, tandis que l’amélioration permet de choisir parmi les quatre classes de résolution et utilise la FHD par défaut. Ce fonctionnement permet d’explorer d’abord l’action et la composition, puis de finaliser la prise retenue aux dimensions de livraison prévues.

Le processus du producteur renvoie un identifiant de tâche avant que le MP4 soit prêt, puis fournit le clip terminé une fois le traitement achevé. Les adresses signées des résultats expirent au bout d’environ deux heures : conservez donc le fichier lui-même dès que le plan est sélectionné. Vérifiez les transitions entre images clés, les coupes, le texte, les détails du sujet et le raccord sonore par rapport au brief. Pour une séquence plus longue, conservez les références du plan réussi et le contexte de sa fin pour les utiliser comme entrée du clip suivant, plutôt que de supposer qu’une courte requête contient toute la production.

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Vidéo POST /v1/videos
Entrée
text, image
Sortie
video
Format de sortie
Octets MP4 d’origine ; sans normalisation ni transcodage
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
black-forest-labs/flux-3-video
Par défaut—
ChamppromptTypestringExigenceObligatoireValeurs et limitesPar défaut—
ChampdurationTypeintegerExigenceObligatoireValeurs et limites
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20
Minimum: 1
Maximum: 600
Par défaut—
ChampresolutionTypestringExigenceFacultatifValeurs et limites
720p, 1080p
Par défaut—
Champaspect_ratioTypestringExigenceFacultatifValeurs et limites
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Par défaut—
Champgenerate_audioTypebooleanExigenceFacultatifValeurs et limites
false, true
Par défaut—
Champframe_imagesTypearrayExigenceFacultatifValeurs et limites
Nombre minimal d’éléments: 1
Nombre maximal d’éléments: 2
Contenu en entrée: Tableau d’objets représentant les images de la séquence. Chaque objet comporte type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame ou last_frame. Chaque rôle d’image apparaît au plus une fois.
Clés exactes: type, image_url, frame_type
Conditions: Ces clés décrivent chaque objet représentant une image de la séquence ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.
Par défaut—
Champinput_referencesTypearrayExigenceFacultatifValeurs et limitesPar défaut—
Champprevious_job_idTypestringExigenceFacultatifValeurs et limites
Motif: ^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Par défaut—
Champcallback_urlTypestringExigenceFacultatifValeurs et limites
Motif: ^https://
Par défaut—
Champsession_idTypestringExigenceFacultatifValeurs et limitesPar défaut—
ChamptraceTypeobjectExigenceFacultatifValeurs et limitesPar défaut—
ChampuserTypestringExigenceFacultatifValeurs et limitesPar défaut—
Combinaisons d’éléments d’entrée

Texte vers vidéo · Une consigne écrite. · Obligatoire : model, prompt, duration

Fournissez prompt sous forme de texte et duration en secondes entières. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.

model: Type : string · black-forest-labs/flux-3-video

prompt: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui

Image vers vidéo · Une consigne écrite et une image de début de séquence. · Obligatoire : model, prompt, duration, frame_images

frame_images est un tableau. Chaque objet représentant une image de la séquence comporte type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame avec last_frame facultatif. Chaque rôle d’image apparaît au plus une fois. Fournissez une URL d’image HTTPS publique pour chaque image de la séquence. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.

Clés exactes : type, image_url, frame_type

model: Type : string · black-forest-labs/flux-3-video

prompt: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui

Continue a video · Une consigne écrite et votre vidéo d’origine terminée. · Obligatoire : model, prompt, duration, previous_job_id

Définissez previous_job_id sur l’ID vidéo public de votre résultat d’origine terminé. Utilisez le même modèle, le même compte et la même clé API. Conservez son identité de tâche existante ; cette requête crée une tâche de continuation distincte. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.

model: Type : string · black-forest-labs/flux-3-video

prompt: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui

Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, prompt, duration
Paramètrematerial_typesContrattext, image
Paramètreadditional_propertiesContratfalse
Paramètreoptional_controlsContratresolution, aspect_ratio, generate_audio, frame_images, input_references, previous_job_id, callback_url, session_id, trace, user

Cycle de vie : submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarifs

Calcul du coût final

Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs estimés à des fins de comparaison

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationBarème tarifaireQuantité prévisionnelleComposant du coûtMode de référenceUnité de facturationConditions de facturationCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseQuantité prévisionnelle—Composant du coût—Mode de référence—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
ConfigurationTexte vers vidéo · Image vers vidéo (images de la séquence) · tarif de référenceBarème tarifaire—Quantité prévisionnelle—Composant du coûtreference_output_rateMode de référenceTexte vers vidéo · Image vers vidéo (images clés)Unité de facturationpar seconde en sortieConditions de facturation—Coût
Sortie · Tarif de référence par seconde de vidéo en sortie · Estimation à des fins de comparaison uniquement $0.34 par seconde en sortie
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Composant du coût—Mode de référence—Unité de facturationpar seconde de vidéoConditions de facturationresolution: 1080pCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.58 par seconde de vidéo
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Composant du coût—Mode de référence—Unité de facturationpar seconde de vidéoConditions de facturationresolution: 720pCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.34 par seconde de vidéo
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Composant du coût—Mode de référence—Unité de facturationpar seconde de vidéoConditions de facturationentrée : video_continuation ; résolution : 1080pCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $1.06 par seconde de vidéo
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Composant du coût—Mode de référence—Unité de facturationpar seconde de vidéoConditions de facturationentrée : video_continuation ; résolution : 720pCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.82 par seconde de vidéo
ConfigurationCoût estimé de la générationBarème tarifaire—Quantité prévisionnelleEstimation pour une générationComposant du coût—Mode de référence—Unité de facturation—Conditions de facturation—Coût
Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $1.7 estimation avant génération

Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.

Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →

Détails du tarif de référence

Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.

Références tarifaires des configurations vidéo

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationConditions de facturationCoût
ConfigurationTarif vidéoConditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire.Coût
Sortie · Tarif vidéo $0.34 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éoConditions de facturationresolution: 720pCoût
Sortie · Tarif vidéo $0.34 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éoConditions de facturationresolution: 1080pCoût
Sortie · Tarif vidéo $0.58 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éoConditions de facturationentrée : video_continuation ; résolution : 720pCoût
Sortie · Tarif vidéo $0.82 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éoConditions de facturationentrée : video_continuation ; résolution : 1080pCoût
Sortie · Tarif vidéo $1.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.

Exemples de requêtes

Ailoot Ultra · Vidéo

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"black-forest-labs/flux-3-video","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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 and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Recevoir et enregistrer les résultats

Ailoot Ultra · Vidéo

URL de contenu signées dont vous êtes propriétaire

Vérifier l’état de la tâche
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Autres lectures de contenu
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);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 returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Conserver tous les résultats terminés

Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.

Conservez chaque résultat réel dont vous êtes propriétaire ainsi que les métadonnées mesurées renvoyées avec celui-ci.

Si la réponse d’origine doit être vérifiée

503 result_pending_check + originalid + X-Should-Retry:false ; ne rejouez jamais la requête d’origine

Champs de la réponse
ChampTypeSignification
ChampindexTypeintegerSignificationPosition de cette vidéo dans la liste des résultats, avec une numérotation commençant à zéro.
Champcontent_urlTypestringSignificationURL de téléchargement HTTPS signée pour cette vidéo terminée.
Champsha256Typestring | nullSignificationEmpreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible.
Champsize_bytesTypeinteger | nullSignificationTaille du fichier vidéo d’origine en octets ; null si elle est indisponible.
Champduration_msTypeinteger | nullSignificationDurée mesurée de la vidéo en millisecondes ; null si elle est indisponible.
ChampwidthTypeinteger | nullSignificationLargeur de la vidéo en pixels ; null si elle est indisponible.
ChampheightTypeinteger | nullSignificationHauteur de la vidéo en pixels ; null si elle est indisponible.
Champvideo_codecTypestring | nullSignificationIdentifiant du codec vidéo ; null s’il n’a pas été enregistré.
Champhas_audioTypeboolean | nullSignificationIndique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré.
Champaudio_codecTypestring | nullSignificationIdentifiant du codec audio ; null lorsqu’aucun identifiant n’a été enregistré.
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse404 · not_found_errorConditionL’accès à la vidéo est indisponible, ou cet ID vidéo est introuvable.Étape suivanteVérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son ID public d’origine et la même clé API.
Réponse401 · authentication_errorConditionLa clé API ne correspond pas au compte authentifié.Étape suivanteVérifiez votre clé API et l’accès au compte avant de soumettre la requête.
Réponse400 · invalid_request_errorConditionLa requête n’a pas pu être lue, ou l’index de téléchargement est invalide.Étape suivanteCorrigez le corps de la requête. Pour un téléchargement, choisissez un index de sortie renvoyé par la tâche d’origine.
Réponse422 · price_unavailableConditionLa configuration vidéo sélectionnée ne peut pas être tarifée.Étape suivanteChoisissez une configuration vidéo prise en charge et renseignez ses options obligatoires avant de soumettre une requête corrigée.
Réponse422 · invalid_request_errorConditionUne entrée vidéo ou la tâche de continuation d’origine est invalide.Étape suivanteUtilisez des entrées HTTPS valides. Pour une continuation, utilisez l’ID vidéo public de votre résultat d’origine terminé avec la même clé API.
Réponse402 · billing_errorConditionLe solde disponible ou les limites ne permettent pas de réserver le montant nécessaire.Étape suivanteVérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle requête.
Réponse503 · server_errorConditionLa vérification vidéo, le stockage ou l’accès au service est temporairement indisponible.Étape suivanteAttendez que le service soit disponible. Si vous disposez déjà d’un ID vidéo, vérifiez cette tâche d’origine au lieu de créer une autre génération.
Réponse503 · result_pending_checkConditionLe résultat vidéo d’origine et sa facturation doivent être vérifiés.Étape suivanteConservez l’ID vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de requête de génération de remplacement pendant sa vérification.
Réponse503 · owned_result_unavailableConditionLe téléchargement de la vidéo existante est temporairement indisponible.Étape suivanteVérifiez la même tâche vidéo plus tard et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte.
Réponse409 · video_not_readyConditionLe contenu vidéo n’a pas été publié.Étape suivanteVérifiez l’état de la tâche d’origine. Téléchargez lorsqu’il indique completed ; s’il indique failed, suivez son avis de vérification de facturation.

Alias

Alias du modèle

Ailoot Ultra black-forest-labs/flux-3-video

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

black-forest-labs/flux-3-video

", "method_identity": { "effective_request_model_id": "black-forest-labs/flux-3-video", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "black-forest-labs/flux-3-video", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|black-forest-labs%2Fflux-3-video", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conservez chaque résultat réel dont vous êtes propriétaire ainsi que les métadonnées mesurées renvoyées avec celui-ci.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "L’accès à la vidéo est indisponible, ou cet ID vidéo est introuvable.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Vérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son ID public d’origine et la même clé API.", "type": "not_found_error" }, { "condition": "La clé API ne correspond pas au compte authentifié.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Vérifiez votre clé API et l’accès au compte avant de soumettre la requête.", "type": "authentication_error" }, { "condition": "La requête n’a pas pu être lue, ou l’index de téléchargement est invalide.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigez le corps de la requête. Pour un téléchargement, choisissez un index de sortie renvoyé par la tâche d’origine.", "type": "invalid_request_error" }, { "condition": "La configuration vidéo sélectionnée ne peut pas être tarifée.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Choisissez une configuration vidéo prise en charge et renseignez ses options obligatoires avant de soumettre une requête corrigée.", "type": "price_unavailable" }, { "condition": "Une entrée vidéo ou la tâche de continuation d’origine est invalide.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilisez des entrées HTTPS valides. Pour une continuation, utilisez l’ID vidéo public de votre résultat d’origine terminé avec la même clé API.", "type": "invalid_request_error" }, { "condition": "Le solde disponible ou les limites ne permettent pas de réserver le montant nécessaire.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Vérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle requête.", "type": "billing_error" }, { "condition": "La vérification vidéo, le stockage ou l’accès au service est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Attendez que le service soit disponible. Si vous disposez déjà d’un ID vidéo, vérifiez cette tâche d’origine au lieu de créer une autre génération.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Le résultat vidéo d’origine et sa facturation doivent être vérifiés.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conservez l’ID vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de requête de génération de remplacement pendant sa vérification.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Le téléchargement de la vidéo existante est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Vérifiez la même tâche vidéo plus tard et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte.", "type": "server_error" }, { "condition": "Le contenu vidéo n’a pas été publié.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Vérifiez l’état de la tâche d’origine. Téléchargez lorsqu’il indique completed ; s’il indique failed, suivez son avis de vérification de facturation.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false ; ne rejouez jamais la requête d’origine" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Fournissez prompt sous forme de texte et duration en secondes entières. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.", "required": [ "model", "prompt", "duration" ], "required_material": "Une consigne écrite." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images est un tableau. Chaque objet représentant une image de la séquence comporte type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame avec last_frame facultatif. Chaque rôle d’image apparaît au plus une fois. Fournissez une URL d’image HTTPS publique pour chaque image de la séquence. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Une consigne écrite et une image de début de séquence." }, { "mode": "Continue a video", "model": { "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Définissez previous_job_id sur l’ID vidéo public de votre résultat d’origine terminé. Utilisez le même modèle, le même compte et la même clé API. Conservez son identité de tâche existante ; cette requête crée une tâche de continuation distincte. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.", "required": [ "model", "prompt", "duration", "previous_job_id" ], "required_material": "Une consigne écrite et votre vidéo d’origine terminée." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "video_extension_or_continuation" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Position de cette vidéo dans la liste des résultats, avec une numérotation commençant à zéro.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL de téléchargement HTTPS signée pour cette vidéo terminée.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Empreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Taille du fichier vidéo d’origine en octets ; null si elle est indisponible.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durée mesurée de la vidéo en millisecondes ; null si elle est indisponible.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Largeur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Hauteur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identifiant du codec vidéo ; null s’il n’a pas été enregistré.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identifiant du codec audio ; null lorsqu’aucun identifiant n’a été enregistré.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL de contenu signées dont vous êtes propriétaire", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "black-forest-labs/flux-3-video" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p", "1080p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p", "1080p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Ces clés décrivent chaque objet représentant une image de la séquence ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.", "content": "Tableau d’objets représentant les images de la séquence. Chaque objet comporte type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame ou last_frame. Chaque rôle d’image apparaît au plus une fois.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "previous_job_id", "pattern": "^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "required": false, "schema": { "pattern": "^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string", "x-source-rule": "real public original id, sameowner/account/proxy/model and published/completed" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "black-forest-labs/flux-3-video" }, "previous_job_id": { "pattern": "^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string", "x-source-rule": "real public original id, sameowner/account/proxy/model and published/completed" }, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p", "1080p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Continuation uses a real same-owner/account/proxy/model published completed public Ailoot video ID; constructible continuation is absent from current discovery profile projection." ] }, "unsupported": [ "size", "seed", "provider", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "previous_job_id", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "video_extension_or_continuation" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "rate_modes": [ "text_to_video", "image_to_video_frame_images" ], "selectable_request_branch": false, "selector_reference_only": true }, "label": "Texte vers vidéo · Image vers vidéo (images de la séquence) · tarif de référence", "units": [ { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "0.58", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_1080p", "label": "Video price", "native_amount_usd_per_unit": "0.58", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_720p", "label": "Video price", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "entrée : video_continuation ; résolution : 1080p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "1.06", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_1080p", "label": "Video price", "native_amount_usd_per_unit": "1.06", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "input: video_continuation; resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.82", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_720p", "label": "Video price", "native_amount_usd_per_unit": "0.82", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coût estimé de la génération", "units": [ { "amount": "1.7", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.7", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"black-forest-labs/flux-3-video\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', 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 and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);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 returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "rate_modes": [ "text_to_video", "image_to_video_frame_images" ], "selectable_request_branch": false, "selector_reference_only": true }, "label": "Text to video · Image to video (frame images) · reference rate", "units": [ { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.58", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_1080p", "label": "Video price", "native_amount_usd_per_unit": "0.58", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_720p", "label": "Video price", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "input: video_continuation; resolution: 1080p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.06", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_1080p", "label": "Video price", "native_amount_usd_per_unit": "1.06", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "input: video_continuation; resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.82", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_720p", "label": "Video price", "native_amount_usd_per_unit": "0.82", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.7", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.7", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "black-forest-labs/flux-3-video", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.58", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_1080p", "label": "Video price", "native_amount_usd_per_unit": "0.58", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_720p", "label": "Video price", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.06", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_1080p", "label": "Video price", "native_amount_usd_per_unit": "1.06", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.82", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_720p", "label": "Video price", "native_amount_usd_per_unit": "0.82", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.7", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.7", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "black-forest-labs/flux-3-video", "nativeProvenance": { "input_facts_canonical_sha256": "d7673bcaa422356281e8b50e74fe9d3e8cc64fed522954080f53e24d0f6b4d4b", "input_html_sha256": "ea25df333c0db5af2cefbf335b9b2129667189d533b8f844df0971e7fdec8754", "private_audit_sha256": "8e01c7f82b43108698f989b7949e197f214766ad2e2a7b6c97956628dc798601", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fr-be/black-forest-labs-flux-3-video/", "description": "FLUX 3 Video crée des clips aux dialogues, effets et ambiances synchronisés à partir d’un texte, d’images imposées ou d’un clip à prolonger. Les images clés, la composition en plusieurs plans et l’amélioration des brouillons permettent de construire une séquence maîtrisée et de conserver la prise retenue.", "locale": "fr-be", "md_url": "https://ailoot.ai/models/fr-be/black-forest-labs-flux-3-video/index.md", "title": "Black Forest Labs: FLUX.3 Video — Ailoot", "url": "https://ailoot.ai/models/fr-be/black-forest-labs-flux-3-video/" }, "rawModel": { "about": "FLUX 3 Video est le modèle multimodal de Black Forest Labs destiné à générer des vidéos avec un son synchronisé. Il crée des scènes à partir d’un brief textuel, construit le mouvement autour d’images imposées ou prolonge un clip existant. La parole, les effets et l’ambiance sonore peuvent être générés en même temps que les images, pour produire une courte scène dont les mouvements de caméra, l’action et le son sont conçus comme une seule séquence.\n\nPour la génération de vidéo à partir de texte, décrivez le sujet, le décor, l’action visible, le comportement de la caméra et le son. Une scène de présentation de produit peut commencer par une vue large, se rapprocher d’un détail de matière et se terminer sur le produit en cours d’utilisation. Un brief comportant plusieurs plans peut préciser chaque plan et la transition entre les angles de caméra, tout en préservant la cohérence du sujet et du style visuel sur toute la séquence. Du texte peut apparaître dans la scène : fournissez donc les mots exacts et leur emplacement lorsqu’une enseigne ou un titre a de l’importance. Le modèle couvre les prises de vues réelles, l’animation, l’habillage graphique animé et les rendus stylisés.\n\nLa génération de vidéo à partir d’images utilise entre une et dix images clés. Une seule image définit l’image d’ouverture ; deux images fixent le début et la fin, tandis que des images ordonnées et horodatées guident des moments précis du clip. Ces images deviennent des images de la vidéo et ne servent pas uniquement de références générales de style. Avec au moins trois images sans horodatage, le producteur exige une durée explicite : la première et la dernière fixent les extrémités, et les autres sont réparties à intervalles réguliers entre elles. Les images horodatées doivent suivre l’ordre chronologique ; la durée automatique s’étend jusqu’au dernier horodatage, arrondi à la seconde supérieure, dans la limite de 20 secondes. Préparez des images clés dont les sujets, le cadrage et les détails visuels sont compatibles, puis décrivez le mouvement qui les relie. Pour révéler un produit, la première image peut montrer l’objet fermé et la dernière sa configuration ouverte, l’action intermédiaire étant définie dans le prompt.\n\nLe prolongement vidéo reprend à partir des dernières images du clip fourni. Le processus de lancement utilise jusqu’à quatre secondes de vidéo et de son existants comme contexte pour l’action suivante, afin de conserver le comportement de la caméra, le mouvement et le son au raccord. Choisissez une fin de clip qui indique clairement la trajectoire du sujet et de la caméra, puis décrivez la suite. Prolonger une vidéo diffère de la réécriture d’un plan existant : FLUX Video Edit est un modèle de montage distinct et ne fait pas partie du modèle de génération du seul fait que les deux acceptent des vidéos.\n\nLa génération guidée par du texte ou des images prend en charge des clips de 5 à 20 secondes. La présentation propre au mode de prolongement vidéo indique une durée de sortie de 5 à 15 secondes. La durée et le rapport largeur/hauteur peuvent être choisis automatiquement, ou le brief peut préciser un format paysage, carré ou portrait pris en charge, notamment 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 et 9:21. La sortie est à 24 images par seconde. Adaptez la durée à un petit nombre d’actions visibles plutôt que d’essayer de faire tenir une histoire entière dans une courte génération.\n\nLa sortie HD provient directement de la génération ; les sorties FHD, QHD et UHD finalisent la même scène à l’aide d’un outil d’augmentation de résolution vidéo. En 16:9, les dimensions livrées sont respectivement de 1280 × 704, 1920 × 1088, 2560 × 1440 et 3840 × 2176. Les dimensions sont alignées sur des multiples de 32 : une classe de résolution donnée peut donc différer des dimensions de livraison habituelles. Recadrez l’image finale lorsqu’un canevas standard exact est nécessaire, en préservant les éléments importants sur ses bords. La résolution supérieure constitue une étape de finition, et non une nouvelle interprétation du plan.\n\nLe son natif est activé par défaut et peut être désactivé pour obtenir un clip muet. Pour un dialogue, citez la réplique, identifiez la personne qui parle et décrivez son interprétation ; la parole multilingue, les accents et la synchronisation labiale font partie des capacités audiovisuelles du modèle. Reliez le dialogue et les indications sonores à l’événement visible, par exemple la fermeture d’un couvercle ou des pas qui s’éloignent. Examinez la voix, le rythme et les mots prononcés en même temps que l’image, au lieu de traiter le son comme une couche indépendante ajoutée après la génération.\n\nLe mode brouillon produit un aperçu HD et un ensemble de données de brouillon. Améliorez l’ensemble sélectionné pour effectuer le rendu de cette génération en qualité maximale ; envoyer le même prompt dans une nouvelle demande de rendu complet constitue une nouvelle interprétation et peut produire une prise différente. Les brouillons utilisent uniquement la HD, tandis que l’amélioration permet de choisir parmi les quatre classes de résolution et utilise la FHD par défaut. Ce fonctionnement permet d’explorer d’abord l’action et la composition, puis de finaliser la prise retenue aux dimensions de livraison prévues.\n\nLe processus du producteur renvoie un identifiant de tâche avant que le MP4 soit prêt, puis fournit le clip terminé une fois le traitement achevé. Les adresses signées des résultats expirent au bout d’environ deux heures : conservez donc le fichier lui-même dès que le plan est sélectionné. Vérifiez les transitions entre images clés, les coupes, le texte, les détails du sujet et le raccord sonore par rapport au brief. Pour une séquence plus longue, conservez les références du plan réussi et le contexte de sa fin pour les utiliser comme entrée du clip suivant, plutôt que de supposer qu’une courte requête contient toute la production.", "alias_of": null, "aliases": [], "author": "Black Forest Labs", "available": null, "canonical_model": "black-forest-labs/flux-3-video", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.7", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.7", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "La tarification complète de la configuration figure dans les détails." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "b4dc879135bc0b33150a530a", "label": "Références tarifaires des configurations vidéo", "profiles": [ { "basis": "Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.", "dimensions": { "conditions": "Cette clé de tarification ne déclare aucune condition supplémentaire." }, "label": "Tarif vidéo", "units": [ { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.", "dimensions": { "conditions": "resolution: 720p" }, "label": "Tarif vidéo", "units": [ { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.", "dimensions": { "conditions": "resolution: 1080p" }, "label": "Tarif vidéo", "units": [ { "amount": "0.58", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.", "dimensions": { "conditions": "entrée : video_continuation ; résolution : 720p" }, "label": "Tarif vidéo", "units": [ { "amount": "0.82", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.", "dimensions": { "conditions": "entrée : video_continuation ; résolution : 1080p" }, "label": "Tarif vidéo", "units": [ { "amount": "1.06", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "black-forest-labs/flux-3-video", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conservez chaque résultat réel dont vous êtes propriétaire ainsi que les métadonnées mesurées renvoyées avec celui-ci.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "L’accès à la vidéo est indisponible, ou cet ID vidéo est introuvable.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Vérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son ID public d’origine et la même clé API.", "type": "not_found_error" }, { "condition": "La clé API ne correspond pas au compte authentifié.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Vérifiez votre clé API et l’accès au compte avant de soumettre la requête.", "type": "authentication_error" }, { "condition": "La requête n’a pas pu être lue, ou l’index de téléchargement est invalide.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrigez le corps de la requête. Pour un téléchargement, choisissez un index de sortie renvoyé par la tâche d’origine.", "type": "invalid_request_error" }, { "condition": "La configuration vidéo sélectionnée ne peut pas être tarifée.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Choisissez une configuration vidéo prise en charge et renseignez ses options obligatoires avant de soumettre une requête corrigée.", "type": "price_unavailable" }, { "condition": "Une entrée vidéo ou la tâche de continuation d’origine est invalide.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilisez des entrées HTTPS valides. Pour une continuation, utilisez l’ID vidéo public de votre résultat d’origine terminé avec la même clé API.", "type": "invalid_request_error" }, { "condition": "Le solde disponible ou les limites ne permettent pas de réserver le montant nécessaire.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Vérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle requête.", "type": "billing_error" }, { "condition": "La vérification vidéo, le stockage ou l’accès au service est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Attendez que le service soit disponible. Si vous disposez déjà d’un ID vidéo, vérifiez cette tâche d’origine au lieu de créer une autre génération.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Le résultat vidéo d’origine et sa facturation doivent être vérifiés.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conservez l’ID vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de requête de génération de remplacement pendant sa vérification.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Le téléchargement de la vidéo existante est temporairement indisponible.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Vérifiez la même tâche vidéo plus tard et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte.", "type": "server_error" }, { "condition": "Le contenu vidéo n’a pas été publié.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Vérifiez l’état de la tâche d’origine. Téléchargez lorsqu’il indique completed ; s’il indique failed, suivez son avis de vérification de facturation.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false ; ne rejouez jamais la requête d’origine" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Fournissez prompt sous forme de texte et duration en secondes entières. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.", "required": [ "model", "prompt", "duration" ], "required_material": "Une consigne écrite." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images est un tableau. Chaque objet représentant une image de la séquence comporte type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame avec last_frame facultatif. Chaque rôle d’image apparaît au plus une fois. Fournissez une URL d’image HTTPS publique pour chaque image de la séquence. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Une consigne écrite et une image de début de séquence." }, { "mode": "Continue a video", "model": { "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Définissez previous_job_id sur l’ID vidéo public de votre résultat d’origine terminé. Utilisez le même modèle, le même compte et la même clé API. Conservez son identité de tâche existante ; cette requête crée une tâche de continuation distincte. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.", "required": [ "model", "prompt", "duration", "previous_job_id" ], "required_material": "Une consigne écrite et votre vidéo d’origine terminée." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "video_extension_or_continuation" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Position de cette vidéo dans la liste des résultats, avec une numérotation commençant à zéro.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL de téléchargement HTTPS signée pour cette vidéo terminée.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Empreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Taille du fichier vidéo d’origine en octets ; null si elle est indisponible.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durée mesurée de la vidéo en millisecondes ; null si elle est indisponible.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Largeur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Hauteur de la vidéo en pixels ; null si elle est indisponible.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identifiant du codec vidéo ; null s’il n’a pas été enregistré.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identifiant du codec audio ; null lorsqu’aucun identifiant n’a été enregistré.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL de contenu signées dont vous êtes propriétaire", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "black-forest-labs/flux-3-video" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "black-forest-labs/flux-3-video" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p", "1080p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p", "1080p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Ces clés décrivent chaque objet représentant une image de la séquence ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.", "content": "Tableau d’objets représentant les images de la séquence. Chaque objet comporte type=image_url, image_url contenant url et frame_type. Utilisez une URL d’image HTTPS et définissez frame_type sur first_frame ou last_frame. Chaque rôle d’image apparaît au plus une fois.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "previous_job_id", "pattern": "^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "required": false, "schema": { "pattern": "^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string", "x-source-rule": "real public original id, sameowner/account/proxy/model and published/completed" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "black-forest-labs/flux-3-video" }, "previous_job_id": { "pattern": "^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string", "x-source-rule": "real public original id, sameowner/account/proxy/model and published/completed" }, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p", "1080p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Continuation uses a real same-owner/account/proxy/model published completed public Ailoot video ID; constructible continuation is absent from current discovery profile projection." ] }, "unsupported": [ "size", "seed", "provider", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "previous_job_id", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "video_extension_or_continuation" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "rate_modes": [ "text_to_video", "image_to_video_frame_images" ], "selectable_request_branch": false, "selector_reference_only": true }, "label": "Texte vers vidéo · Image vers vidéo (images de la séquence) · tarif de référence", "units": [ { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "0.58", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_1080p", "label": "Video price", "native_amount_usd_per_unit": "0.58", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_720p", "label": "Video price", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "entrée : video_continuation ; résolution : 1080p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "1.06", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_1080p", "label": "Video price", "native_amount_usd_per_unit": "1.06", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "input: video_continuation; resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.82", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_720p", "label": "Video price", "native_amount_usd_per_unit": "0.82", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coût estimé de la génération", "units": [ { "amount": "1.7", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.7", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"black-forest-labs/flux-3-video\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', 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 and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);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 returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "rate_modes": [ "text_to_video", "image_to_video_frame_images" ], "selectable_request_branch": false, "selector_reference_only": true }, "label": "Text to video · Image to video (frame images) · reference rate", "units": [ { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.58", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_1080p", "label": "Video price", "native_amount_usd_per_unit": "0.58", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_720p", "label": "Video price", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "input: video_continuation; resolution: 1080p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.06", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_1080p", "label": "Video price", "native_amount_usd_per_unit": "1.06", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "input: video_continuation; resolution: 720p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.82", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_720p", "label": "Video price", "native_amount_usd_per_unit": "0.82", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.7", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.7", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "black-forest-labs/flux-3-video", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.58", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_1080p", "label": "Video price", "native_amount_usd_per_unit": "0.58", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.34", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output_720p", "label": "Video price", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.06", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_1080p", "label": "Video price", "native_amount_usd_per_unit": "1.06", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.82", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_video_continuation_720p", "label": "Video price", "native_amount_usd_per_unit": "0.82", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.7", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.7", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "black-forest-labs/flux-3-video", "request_model_id": "black-forest-labs/flux-3-video", "route_label": "Ultra" } ], "name": "Black Forest Labs: FLUX.3 Video", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.7, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.7, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "hd" }, "label": "Ultra", "units": [ { "amount": "0.34", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "hd" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "fhd" }, "label": "Ultra", "units": [ { "amount": "0.58", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "fhd" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "qhd" }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "qhd" }, "key": "base", "label": "base", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "uhd" }, "label": "Ultra", "units": [ { "amount": "1.60", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "uhd" }, "key": "base", "label": "base", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": true, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "draft_hd" }, "label": "Ultra", "units": [ { "amount": "0.12", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": true, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "draft_hd" }, "key": "base", "label": "base", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "hd" }, "label": "Ultra", "units": [ { "amount": "0.34", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "hd" }, "key": "base", "label": "base", "profile_index": 5, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "fhd" }, "label": "Ultra", "units": [ { "amount": "0.58", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "fhd" }, "key": "base", "label": "base", "profile_index": 6, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "qhd" }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "qhd" }, "key": "base", "label": "base", "profile_index": 7, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "uhd" }, "label": "Ultra", "units": [ { "amount": "1.60", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "uhd" }, "key": "base", "label": "base", "profile_index": 8, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": true, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "draft_hd" }, "label": "Ultra", "units": [ { "amount": "0.12", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": true, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "draft_hd" }, "key": "base", "label": "base", "profile_index": 9, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "hd" }, "label": "Ultra", "units": [ { "amount": "0.82", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "hd" }, "key": "base", "label": "base", "profile_index": 10, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "fhd" }, "label": "Ultra", "units": [ { "amount": "1.06", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "fhd" }, "key": "base", "label": "base", "profile_index": 11, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "qhd" }, "label": "Ultra", "units": [ { "amount": "1.30", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "qhd" }, "key": "base", "label": "base", "profile_index": 12, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "uhd" }, "label": "Ultra", "units": [ { "amount": "1.90", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": false, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "uhd" }, "key": "base", "label": "base", "profile_index": 13, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": true, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "draft_hd" }, "label": "Ultra", "units": [ { "amount": "0.24", "amount_unit": "usd_per_output_video_second", "conditions": { "audio": "synchronized_audio", "billing_quantity": "output_duration_seconds", "draft": true, "duration_limit_source": "Not on pricing page; retained supplier declared capabilities in operation inventory; maker duration limits not claimed", "resolution_class": "draft_hd" }, "key": "base", "label": "base", "profile_index": 14, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second Source-only tariff component.", "billing_original_currency": "USD_cent", "billing_original_rate": "34", "key": "cents_per_second_output", "label": "output second", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.34", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=720p", "billing_original_currency": "USD_cent", "billing_original_rate": "34", "key": "cents_per_second_output_720p", "label": "output second", "native_amount_usd_per_unit": "0.34", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.58", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=1080p", "billing_original_currency": "USD_cent", "billing_original_rate": "58", "key": "cents_per_second_output_1080p", "label": "output second", "native_amount_usd_per_unit": "0.58", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.82", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=720p · video_continuation", "billing_original_currency": "USD_cent", "billing_original_rate": "82", "key": "cents_per_second_video_continuation_720p", "label": "output second", "native_amount_usd_per_unit": "0.82", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "1.06", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=1080p · video_continuation", "billing_original_currency": "USD_cent", "billing_original_rate": "106", "key": "cents_per_second_video_continuation_1080p", "label": "output second", "native_amount_usd_per_unit": "1.06", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "black-forest-labs/flux-3-video", "short": "FLUX 3 Video crée des clips aux dialogues, effets et ambiances synchronisés à partir d’un texte, d’images imposées ou d’un clip à prolonger. Les images clés, la composition en plusieurs plans et l’amélioration des brouillons permettent de construire une séquence maîtrisée et de conserver la prise retenue." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "FLUX 3 Video crée des clips aux dialogues, effets et ambiances synchronisés à partir d’un texte, d’images imposées ou d’un clip à prolonger. Les images clés, la composition en plusieurs plans et l’amélioration des brouillons permettent de construire une séquence maîtrisée et de conserver la prise retenue.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "3a29cd2b9abb574c957c96c2f28ba5938ec818e521d48b1b611eba97808d7fe1", "renderer_sha256": "9d578ff8df69ef70403308c9943a1179a11b94114c10b333bf1c012005d4a7f4" }, "sourceRevision": "8941fb8feb6fd73f2bc52fac278e27a5d927e82a2e0c880d397f8beef002ab3d" }