{ "aboutHtml": "

Une variante rapide de H3 affinée par post-entraînement

MiniMax H3 Max est une variante du modèle de base MiniMax H3 affinée par post-entraînement, optimisée pour accélérer la génération, respecter les prompts et améliorer la qualité audiovisuelle. La variante a été développée par post-entraînement chez fal Research. Elle conserve un contexte multimodal unifié ainsi qu’une image et un son synchronisés nativement. La vitesse est une priorité de conception, plutôt qu’un délai d’achèvement fixe pour tous les prompts, durées ou applications.

Distinguez Max du système H3 original et de la variante Max Turbo séparée. L’interface actuelle de MiniMax propose Max en 480P ou 768P, avec la 768P par défaut, à 24 images par seconde et pour une durée entière de 5 à 15 secondes. Son processus Max documenté ne propose ni le réglage 2K du système H3 original ni une sortie de quatre secondes.

Du prompt au plan

Chaque génération comprend un brief textuel non vide, jusqu’à 7 000 caractères par élément textuel. Décrivez le sujet, la composition initiale, l’action et le résultat, puis énoncez clairement les consignes de caméra et de son. Pour révéler brièvement un objet, identifiez ce que le spectateur doit voir en premier, la manière dont l’objet apparaît dans le champ et la façon dont le plan doit se terminer.

Un brief utile de cinq secondes peut décrire une tasse en céramique sur une table en bois, une main qui pose une soucoupe à côté, une légère avancée de caméra et le son de la céramique qui rencontre le bois. Gardez une action suffisamment réduite pour tenir dans la durée choisie et vérifiez que le mouvement et le son renvoyés suivent le même événement.

Création guidée par des images de début et de fin

Le producteur documente une image d’ouverture, une image de fin ou les deux. Une première image définit le début du clip ; une dernière image définit l’état visuel final. Expliquez le mouvement qui les relie, notamment les changements de pose, de position d’objet, de caméra ou d’éclairage. Pour une transition entre deux images, évitez un brief qui introduit une scène incompatible entre ses extrémités.

La sortie guidée par ces images déduit son rapport largeur/hauteur de l’image d’entrée. Pour un travail à partir de texte uniquement, choisissez un rapport précis parmi 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Le travail guidé par des références peut utiliser un rapport adaptatif ou l’un des choix explicites documentés. Composez la référence ou la scène écrite pour le format cible au lieu de supposer que la même disposition fonctionne aussi bien en portrait qu’en paysage.

Références multimodales

Le schéma de génération Max actuel de MiniMax documente aussi les images, vidéos et sons de référence. Précisez ce que chacun doit influencer : identité d’un personnage, environnement, motif de mouvement, trajectoire de caméra, timbre de voix ou caractéristique sonore. Les rôles de première/dernière image et les rôles de médias de référence s’excluent mutuellement dans cette interface.

Pour un plan de personnage, identifiez séparément la référence d’apparence et celle de mouvement, puis fournissez l’action cible et la réplique. Une référence vocale qui définit l’interprétation diffère de la copie de son signal audio complet. Précisez dans le brief les caractéristiques à préserver et les changements à apporter, puis comparez le clip audiovisuel réel à chaque rôle de référence.

Extension du prompt

Le réglage d’extension propre à Max propose les choix disabled, balanced et quality, avec balanced par défaut. Choisissez disabled lorsque le brief fourni doit être transmis sans extension ; utilisez un mode d’extension documenté lorsqu’une interprétation supplémentaire est souhaitée. Conservez le brief original afin de distinguer un changement introduit pendant l’extension du contenu demandé.

Décrivez le son comme une partie de la scène. Identifiez les sons physiques, l’ambiance et les mots prononcés, et distinguez-les d’une musique de fond destinée uniquement au public. Fournissez la réplique exacte et la personne qui doit la prononcer plutôt que de demander un dialogue indéfini. Écoutez le résultat autant que vous le regardez ; une image convaincante ne prouve pas que les mots prononcés ou leurs temps sont corrects.

Préparation des entrées et limites

Le schéma actuel du producteur accepte des images JPG, JPEG, PNG, WebP, HEIC ou HEIF, jusqu’à 30 Mo chacune, avec des côtés de 256 à 5 760 pixels et des rapports de 0.4 à 2.5. Les rôles d’ouverture et de fin autorisent chacun une image ; le mode de références accepte jusqu’à neuf images. Préservez une vue claire du sujet et des détails qui doivent rester identifiables.

Les vidéos de référence autorisent jusqu’à trois clips MP4 ou MOV, chacun de 2 à 15 secondes et ensemble de 15 secondes au maximum, avec une limite de 50 Mo par fichier. Le schéma documente la vidéo H.264 ou H.265, le son AAC ou MP3, des côtés de 256 à 5 760 pixels, des rapports de 0.4 à 2.5 et une fréquence d’images de 23.976 à 60. Le son de référence autorise jusqu’à trois clips WAV ou MP3, chacun de 15 Mo au maximum et de 2 à 15 secondes, avec un total de 15 secondes au maximum. Le corps de la requête a une limite distincte de 64 Mo.

N’utilisez que les références qui contribuent au plan et identifiez chaque contribution dans le texte. Un court clip de mouvement pertinent est plus facile à utiliser comme direction qu’une longue collection d’événements sans rapport. Gardez la durée souhaitée et la résolution de sortie explicites afin de comparer le résultat au même brief.

Le résultat terminé

Le processus asynchrone du producteur renvoie un identifiant de tâche avant que la vidéo terminée soit disponible. Son interface de consultation récupère les tâches des sept jours précédents. Sauvegardez le clip réellement renvoyé et sa spécification pour le montage ou une revue ultérieure ; un identifiant de tâche n’est pas le livrable audiovisuel. Les adresses de téléchargement sont limitées dans le temps : conservez donc le fichier lui-même lorsque vous retenez un résultat choisi.

Vérifiez la continuité du sujet, le mouvement, le texte visible, le dialogue et les temps sonores aux dimensions d’utilisation du clip. Utilisez des retours concrets pour un autre brief créatif : le geste qui a changé, la réplique omise ou le cadrage à ajuster. Le résultat utile est un court plan audiovisuel relié au contenu fourni et à ses relations explicites entre références.

", "aboutText": "Une variante rapide de H3 affinée par post-entraînement\n\nMiniMax H3 Max est une variante du modèle de base MiniMax H3 affinée par post-entraînement, optimisée pour accélérer la génération, respecter les prompts et améliorer la qualité audiovisuelle. La variante a été développée par post-entraînement chez fal Research. Elle conserve un contexte multimodal unifié ainsi qu’une image et un son synchronisés nativement. La vitesse est une priorité de conception, plutôt qu’un délai d’achèvement fixe pour tous les prompts, durées ou applications.\n\nDistinguez Max du système H3 original et de la variante Max Turbo séparée. L’interface actuelle de MiniMax propose Max en 480P ou 768P, avec la 768P par défaut, à 24 images par seconde et pour une durée entière de 5 à 15 secondes. Son processus Max documenté ne propose ni le réglage 2K du système H3 original ni une sortie de quatre secondes.\n\nDu prompt au plan\n\nChaque génération comprend un brief textuel non vide, jusqu’à 7 000 caractères par élément textuel. Décrivez le sujet, la composition initiale, l’action et le résultat, puis énoncez clairement les consignes de caméra et de son. Pour révéler brièvement un objet, identifiez ce que le spectateur doit voir en premier, la manière dont l’objet apparaît dans le champ et la façon dont le plan doit se terminer.\n\nUn brief utile de cinq secondes peut décrire une tasse en céramique sur une table en bois, une main qui pose une soucoupe à côté, une légère avancée de caméra et le son de la céramique qui rencontre le bois. Gardez une action suffisamment réduite pour tenir dans la durée choisie et vérifiez que le mouvement et le son renvoyés suivent le même événement.\n\nCréation guidée par des images de début et de fin\n\nLe producteur documente une image d’ouverture, une image de fin ou les deux. Une première image définit le début du clip ; une dernière image définit l’état visuel final. Expliquez le mouvement qui les relie, notamment les changements de pose, de position d’objet, de caméra ou d’éclairage. Pour une transition entre deux images, évitez un brief qui introduit une scène incompatible entre ses extrémités.\n\nLa sortie guidée par ces images déduit son rapport largeur/hauteur de l’image d’entrée. Pour un travail à partir de texte uniquement, choisissez un rapport précis parmi 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Le travail guidé par des références peut utiliser un rapport adaptatif ou l’un des choix explicites documentés. Composez la référence ou la scène écrite pour le format cible au lieu de supposer que la même disposition fonctionne aussi bien en portrait qu’en paysage.\n\nRéférences multimodales\n\nLe schéma de génération Max actuel de MiniMax documente aussi les images, vidéos et sons de référence. Précisez ce que chacun doit influencer : identité d’un personnage, environnement, motif de mouvement, trajectoire de caméra, timbre de voix ou caractéristique sonore. Les rôles de première/dernière image et les rôles de médias de référence s’excluent mutuellement dans cette interface.\n\nPour un plan de personnage, identifiez séparément la référence d’apparence et celle de mouvement, puis fournissez l’action cible et la réplique. Une référence vocale qui définit l’interprétation diffère de la copie de son signal audio complet. Précisez dans le brief les caractéristiques à préserver et les changements à apporter, puis comparez le clip audiovisuel réel à chaque rôle de référence.\n\nExtension du prompt\n\nLe réglage d’extension propre à Max propose les choix disabled, balanced et quality, avec balanced par défaut. Choisissez disabled lorsque le brief fourni doit être transmis sans extension ; utilisez un mode d’extension documenté lorsqu’une interprétation supplémentaire est souhaitée. Conservez le brief original afin de distinguer un changement introduit pendant l’extension du contenu demandé.\n\nDécrivez le son comme une partie de la scène. Identifiez les sons physiques, l’ambiance et les mots prononcés, et distinguez-les d’une musique de fond destinée uniquement au public. Fournissez la réplique exacte et la personne qui doit la prononcer plutôt que de demander un dialogue indéfini. Écoutez le résultat autant que vous le regardez ; une image convaincante ne prouve pas que les mots prononcés ou leurs temps sont corrects.\n\nPréparation des entrées et limites\n\nLe schéma actuel du producteur accepte des images JPG, JPEG, PNG, WebP, HEIC ou HEIF, jusqu’à 30 Mo chacune, avec des côtés de 256 à 5 760 pixels et des rapports de 0.4 à 2.5. Les rôles d’ouverture et de fin autorisent chacun une image ; le mode de références accepte jusqu’à neuf images. Préservez une vue claire du sujet et des détails qui doivent rester identifiables.\n\nLes vidéos de référence autorisent jusqu’à trois clips MP4 ou MOV, chacun de 2 à 15 secondes et ensemble de 15 secondes au maximum, avec une limite de 50 Mo par fichier. Le schéma documente la vidéo H.264 ou H.265, le son AAC ou MP3, des côtés de 256 à 5 760 pixels, des rapports de 0.4 à 2.5 et une fréquence d’images de 23.976 à 60. Le son de référence autorise jusqu’à trois clips WAV ou MP3, chacun de 15 Mo au maximum et de 2 à 15 secondes, avec un total de 15 secondes au maximum. Le corps de la requête a une limite distincte de 64 Mo.\n\nN’utilisez que les références qui contribuent au plan et identifiez chaque contribution dans le texte. Un court clip de mouvement pertinent est plus facile à utiliser comme direction qu’une longue collection d’événements sans rapport. Gardez la durée souhaitée et la résolution de sortie explicites afin de comparer le résultat au même brief.\n\nLe résultat terminé\n\nLe processus asynchrone du producteur renvoie un identifiant de tâche avant que la vidéo terminée soit disponible. Son interface de consultation récupère les tâches des sept jours précédents. Sauvegardez le clip réellement renvoyé et sa spécification pour le montage ou une revue ultérieure ; un identifiant de tâche n’est pas le livrable audiovisuel. Les adresses de téléchargement sont limitées dans le temps : conservez donc le fichier lui-même lorsque vous retenez un résultat choisi.\n\nVérifiez la continuité du sujet, le mouvement, le texte visible, le dialogue et les temps sonores aux dimensions d’utilisation du clip. Utilisez des retours concrets pour un autre brief créatif : le geste qui a changé, la réplique omise ou le cadrage à ajuster. Le résultat utile est un court plan audiovisuel relié au contenu fourni et à ses relations explicites entre références.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2cb3f22f5b69a88550290a3496492c97979d9956cb7f02080d28f2950be67eaa", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Premiers pas

MiniMax H3 Max est une variante rapide de H3 affinée par post-entraînement pour de courtes vidéos avec du son synchronisé. Le processus documenté de MiniMax prend en charge le texte, les images de début et de fin et les références multimodales, avec une sortie 480P ou 768P, une durée de 5 à 15 secondes et ses propres choix d’extension du prompt.

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.

Une variante rapide de H3 affinée par post-entraînement

MiniMax H3 Max est une variante du modèle de base MiniMax H3 affinée par post-entraînement, optimisée pour accélérer la génération, respecter les prompts et améliorer la qualité audiovisuelle. La variante a été développée par post-entraînement chez fal Research. Elle conserve un contexte multimodal unifié ainsi qu’une image et un son synchronisés nativement. La vitesse est une priorité de conception, plutôt qu’un délai d’achèvement fixe pour tous les prompts, durées ou applications.

Distinguez Max du système H3 original et de la variante Max Turbo séparée. L’interface actuelle de MiniMax propose Max en 480P ou 768P, avec la 768P par défaut, à 24 images par seconde et pour une durée entière de 5 à 15 secondes. Son processus Max documenté ne propose ni le réglage 2K du système H3 original ni une sortie de quatre secondes.

Du prompt au plan

Chaque génération comprend un brief textuel non vide, jusqu’à 7 000 caractères par élément textuel. Décrivez le sujet, la composition initiale, l’action et le résultat, puis énoncez clairement les consignes de caméra et de son. Pour révéler brièvement un objet, identifiez ce que le spectateur doit voir en premier, la manière dont l’objet apparaît dans le champ et la façon dont le plan doit se terminer.

Un brief utile de cinq secondes peut décrire une tasse en céramique sur une table en bois, une main qui pose une soucoupe à côté, une légère avancée de caméra et le son de la céramique qui rencontre le bois. Gardez une action suffisamment réduite pour tenir dans la durée choisie et vérifiez que le mouvement et le son renvoyés suivent le même événement.

Création guidée par des images de début et de fin

Le producteur documente une image d’ouverture, une image de fin ou les deux. Une première image définit le début du clip ; une dernière image définit l’état visuel final. Expliquez le mouvement qui les relie, notamment les changements de pose, de position d’objet, de caméra ou d’éclairage. Pour une transition entre deux images, évitez un brief qui introduit une scène incompatible entre ses extrémités.

La sortie guidée par ces images déduit son rapport largeur/hauteur de l’image d’entrée. Pour un travail à partir de texte uniquement, choisissez un rapport précis parmi 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Le travail guidé par des références peut utiliser un rapport adaptatif ou l’un des choix explicites documentés. Composez la référence ou la scène écrite pour le format cible au lieu de supposer que la même disposition fonctionne aussi bien en portrait qu’en paysage.

Références multimodales

Le schéma de génération Max actuel de MiniMax documente aussi les images, vidéos et sons de référence. Précisez ce que chacun doit influencer : identité d’un personnage, environnement, motif de mouvement, trajectoire de caméra, timbre de voix ou caractéristique sonore. Les rôles de première/dernière image et les rôles de médias de référence s’excluent mutuellement dans cette interface.

Pour un plan de personnage, identifiez séparément la référence d’apparence et celle de mouvement, puis fournissez l’action cible et la réplique. Une référence vocale qui définit l’interprétation diffère de la copie de son signal audio complet. Précisez dans le brief les caractéristiques à préserver et les changements à apporter, puis comparez le clip audiovisuel réel à chaque rôle de référence.

Extension du prompt

Le réglage d’extension propre à Max propose les choix disabled, balanced et quality, avec balanced par défaut. Choisissez disabled lorsque le brief fourni doit être transmis sans extension ; utilisez un mode d’extension documenté lorsqu’une interprétation supplémentaire est souhaitée. Conservez le brief original afin de distinguer un changement introduit pendant l’extension du contenu demandé.

Décrivez le son comme une partie de la scène. Identifiez les sons physiques, l’ambiance et les mots prononcés, et distinguez-les d’une musique de fond destinée uniquement au public. Fournissez la réplique exacte et la personne qui doit la prononcer plutôt que de demander un dialogue indéfini. Écoutez le résultat autant que vous le regardez ; une image convaincante ne prouve pas que les mots prononcés ou leurs temps sont corrects.

Préparation des entrées et limites

Le schéma actuel du producteur accepte des images JPG, JPEG, PNG, WebP, HEIC ou HEIF, jusqu’à 30 Mo chacune, avec des côtés de 256 à 5 760 pixels et des rapports de 0.4 à 2.5. Les rôles d’ouverture et de fin autorisent chacun une image ; le mode de références accepte jusqu’à neuf images. Préservez une vue claire du sujet et des détails qui doivent rester identifiables.

Les vidéos de référence autorisent jusqu’à trois clips MP4 ou MOV, chacun de 2 à 15 secondes et ensemble de 15 secondes au maximum, avec une limite de 50 Mo par fichier. Le schéma documente la vidéo H.264 ou H.265, le son AAC ou MP3, des côtés de 256 à 5 760 pixels, des rapports de 0.4 à 2.5 et une fréquence d’images de 23.976 à 60. Le son de référence autorise jusqu’à trois clips WAV ou MP3, chacun de 15 Mo au maximum et de 2 à 15 secondes, avec un total de 15 secondes au maximum. Le corps de la requête a une limite distincte de 64 Mo.

N’utilisez que les références qui contribuent au plan et identifiez chaque contribution dans le texte. Un court clip de mouvement pertinent est plus facile à utiliser comme direction qu’une longue collection d’événements sans rapport. Gardez la durée souhaitée et la résolution de sortie explicites afin de comparer le résultat au même brief.

Le résultat terminé

Le processus asynchrone du producteur renvoie un identifiant de tâche avant que la vidéo terminée soit disponible. Son interface de consultation récupère les tâches des sept jours précédents. Sauvegardez le clip réellement renvoyé et sa spécification pour le montage ou une revue ultérieure ; un identifiant de tâche n’est pas le livrable audiovisuel. Les adresses de téléchargement sont limitées dans le temps : conservez donc le fichier lui-même lorsque vous retenez un résultat choisi.

Vérifiez la continuité du sujet, le mouvement, le texte visible, le dialogue et les temps sonores aux dimensions d’utilisation du clip. Utilisez des retours concrets pour un autre brief créatif : le geste qui a changé, la réplique omise ou le cadrage à ajuster. Le résultat utile est un court plan audiovisuel relié au contenu fourni et à ses relations explicites entre références.

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Vidéo POST /v1/videos
Types d’entrée
text, image
Types de sortie
video
Format de sortie
Octets MP4 d’origine ; sans normalisation ni transcodage
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
minimax/hailuo-3-max
Par défaut—
ChamppromptTypestringExigenceObligatoireValeurs et limitesPar défaut—
ChampdurationTypeintegerExigenceObligatoireValeurs et limites
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Par défaut—
ChampresolutionTypestringExigenceFacultatifValeurs et limites
768p, 480p
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
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 d’image. Chaque objet comporte type=image_url, image_url contenant url et frame_type. Utilisez une URL HTTPS pour l’image 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 d’image ; 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—
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 d’image.

model: Type : string · minimax/hailuo-3-max

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 initiale. · Obligatoire : model, prompt, duration, frame_images

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

Clés exactes : type, image_url, frame_type

model: Type : string · minimax/hailuo-3-max

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, 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ûtUnité de facturationConditions de facturationCoût
ConfigurationTarifs de base par jetonBarème tarifaireTarif de baseQuantité prévisionnelle—Composant du coût—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
ConfigurationSortie vidéo · tarif de référenceBarème tarifaire—Quantité prévisionnelle—Composant du coûtreference_output_rateUnité 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.16 par seconde en sortie
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Composant du coût—Unité de facturationpar seconde de vidéoConditions de facturationresolution: 480pCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.1 par seconde de vidéo
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Composant du coût—Unité de facturationpar seconde de vidéoConditions de facturationresolution: 768pCoût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.16 par seconde de vidéo
ConfigurationCoût de génération estiméBarème tarifaire—Quantité prévisionnelleEstimation pour une générationComposant du coût—Unité de facturation—Conditions de facturation—Coût
Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.5 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.16 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

ConfigurationTarif vidéoConditions de facturationresolution: 480pCoût
Sortie · Tarif vidéo $0.1 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

ConfigurationTarif vidéoConditions de facturationresolution: 768pCoût
Sortie · Tarif vidéo $0.16 par seconde de vidéo

Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée.

Exemples de requêtes

Ailoot Ultra · Vidéo

set -eu\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":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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 signées de contenu vous appartenant

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 toutes les sorties réelles vous appartenant et les métadonnées mesurées renvoyées pour chacune.

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

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

Champs de la réponse
ChampTypeSignification
ChampindexTypeintegerSignificationPosition de cette vidéo dans la liste des sorties, en commençant à zéro.
Champcontent_urlTypestringSignificationURL HTTPS signée pour télécharger cette vidéo terminée.
Champsha256Typestring | nullSignificationEmpreinte SHA-256 des octets vidéo d’origine ; null si indisponible.
Champsize_bytesTypeinteger | nullSignificationTaille du fichier vidéo d’origine en octets ; null si indisponible.
Champduration_msTypeinteger | nullSignificationDurée vidéo mesurée en millisecondes ; null si indisponible.
ChampwidthTypeinteger | nullSignificationLargeur de la vidéo en pixels ; null si indisponible.
ChampheightTypeinteger | nullSignificationHauteur de la vidéo en pixels ; null si indisponible.
Champvideo_codecTypestring | nullSignificationIdentifiant du codec vidéo ; null s’il n’est pas 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’est enregistré.
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse404 · not_found_errorConditionL’accès vidéo n’est pas disponible, ou cet identifiant vidéo est introuvable.Étape suivanteVérifiez l’accès vidéo. Pour une vidéo existante, utilisez son identifiant 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 à votre compte avant de soumettre la demande.
Réponse400 · invalid_request_errorConditionLa requête n’a pas pu être lue ou l’index de téléchargement n’est pas valide.É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 demande corrigée.
Réponse422 · invalid_request_errorConditionUne entrée vidéo ou une tâche de continuation d’origine n’est pas valide.Étape suivanteUtilisez des entrées HTTPS valides. Pour une continuation, utilisez l’identifiant vidéo public de votre original terminé avec la même clé API.
Réponse402 · billing_errorConditionLe solde disponible ou les limites ne permettent pas de réserver les fonds nécessaires.Étape suivanteVérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle demande.
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 possédez déjà un identifiant vidéo, consultez 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 nécessitent une vérification.Étape suivanteConservez l’identifiant vidéo renvoyé et consultez cette tâche. N’envoyez pas de demande de génération de remplacement tant que sa vérification est en cours.
Réponse503 · owned_result_unavailableConditionLe téléchargement de la vidéo existante est temporairement indisponible.Étape suivanteConsultez cette même tâche vidéo ultérieurement et téléchargez sa sortie existante. 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 le statut de la tâche d’origine. Téléchargez après l’apparition de completed ; si elle indique failed, suivez son avis de vérification de la facturation.

Alias

Alias du modèle

Ailoot Ultra minimax/hailuo-3-max

Alias des chemins de méthode

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

ID d’appel associés

minimax/hailuo-3-max

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3-max", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3-max", "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 toutes les sorties réelles vous appartenant et les métadonnées mesurées renvoyées pour chacune.", "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 vidéo n’est pas disponible, ou cet identifiant vidéo est introuvable.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Vérifiez l’accès vidéo. Pour une vidéo existante, utilisez son identifiant 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 à votre compte avant de soumettre la demande.", "type": "authentication_error" }, { "condition": "La requête n’a pas pu être lue ou l’index de téléchargement n’est pas valide.", "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 demande corrigée.", "type": "price_unavailable" }, { "condition": "Une entrée vidéo ou une tâche de continuation d’origine n’est pas valide.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilisez des entrées HTTPS valides. Pour une continuation, utilisez l’identifiant vidéo public de votre original terminé avec la même clé API.", "type": "invalid_request_error" }, { "condition": "Le solde disponible ou les limites ne permettent pas de réserver les fonds nécessaires.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Vérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle demande.", "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 possédez déjà un identifiant vidéo, consultez 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 nécessitent une vérification.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conservez l’identifiant vidéo renvoyé et consultez cette tâche. N’envoyez pas de demande de génération de remplacement tant que sa vérification est en cours.", "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": "Consultez cette même tâche vidéo ultérieurement et téléchargez sa sortie existante. 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 le statut de la tâche d’origine. Téléchargez après l’apparition de completed ; si elle indique failed, suivez son avis de vérification de la 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 demande d’origine" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "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 d’image.", "required": [ "model", "prompt", "duration" ], "required_material": "Une consigne écrite." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images est un tableau. Chaque objet d’image comporte type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame avec, facultativement, last_frame. Chaque rôle d’image apparaît au plus une fois. Fournissez une URL HTTPS publique pour chaque image. Choisissez une résolution prise en charge et, si nécessaire, un rapport d’image.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Une consigne écrite et une image initiale." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "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 sorties, en 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 HTTPS signée pour télécharger 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 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 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 vidéo mesurée en millisecondes ; null si 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 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 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’est pas 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’est 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 signées de contenu vous appartenant", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "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 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "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 ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "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 d’image ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.", "content": "Tableau d’objets d’image. Chaque objet comporte type=image_url, image_url contenant url et frame_type. Utilisez une URL HTTPS pour l’image 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": "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 ], "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 ], "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": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "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." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "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", "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" ], "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", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Sortie vidéo · tarif de référence", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "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: 480p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "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: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "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 de génération estimé", "units": [ { "amount": "0.5", "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": "0.5", "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\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', 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", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "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: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "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: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "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": "0.5", "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": "0.5", "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": "minimax/hailuo-3-max", "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.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "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.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "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.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "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.5", "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": "0.5", "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": "minimax/hailuo-3-max", "nativeProvenance": { "input_facts_canonical_sha256": "67d1722b4968cc4320f3b343ba81aa539c2779fca49e615fe1d76bd2628eac94", "input_html_sha256": "102e48efd10643f43dbbdcf5251002a1bdbe1e57cba8128174d054ad70262214", "private_audit_sha256": "c10ee6836d39e4103a7530d39720232924ee792662dff8b50c3ab53597a80728", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fr/minimax-hailuo-3-max/", "description": "MiniMax H3 Max est une variante rapide de H3 affinée par post-entraînement pour de courtes vidéos avec du son synchronisé. Le processus documenté de MiniMax prend en charge le texte, les images de début et de fin et les références multimodales, avec une sortie 480P ou 768P, une durée de 5 à 15 secondes et ses propres choix d’extension du prompt.", "locale": "fr", "md_url": "https://ailoot.ai/models/fr/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/fr/minimax-hailuo-3-max/" }, "rawModel": { "about": "Une variante rapide de H3 affinée par post-entraînement\n\nMiniMax H3 Max est une variante du modèle de base MiniMax H3 affinée par post-entraînement, optimisée pour accélérer la génération, respecter les prompts et améliorer la qualité audiovisuelle. La variante a été développée par post-entraînement chez fal Research. Elle conserve un contexte multimodal unifié ainsi qu’une image et un son synchronisés nativement. La vitesse est une priorité de conception, plutôt qu’un délai d’achèvement fixe pour tous les prompts, durées ou applications.\n\nDistinguez Max du système H3 original et de la variante Max Turbo séparée. L’interface actuelle de MiniMax propose Max en 480P ou 768P, avec la 768P par défaut, à 24 images par seconde et pour une durée entière de 5 à 15 secondes. Son processus Max documenté ne propose ni le réglage 2K du système H3 original ni une sortie de quatre secondes.\n\nDu prompt au plan\n\nChaque génération comprend un brief textuel non vide, jusqu’à 7 000 caractères par élément textuel. Décrivez le sujet, la composition initiale, l’action et le résultat, puis énoncez clairement les consignes de caméra et de son. Pour révéler brièvement un objet, identifiez ce que le spectateur doit voir en premier, la manière dont l’objet apparaît dans le champ et la façon dont le plan doit se terminer.\n\nUn brief utile de cinq secondes peut décrire une tasse en céramique sur une table en bois, une main qui pose une soucoupe à côté, une légère avancée de caméra et le son de la céramique qui rencontre le bois. Gardez une action suffisamment réduite pour tenir dans la durée choisie et vérifiez que le mouvement et le son renvoyés suivent le même événement.\n\nCréation guidée par des images de début et de fin\n\nLe producteur documente une image d’ouverture, une image de fin ou les deux. Une première image définit le début du clip ; une dernière image définit l’état visuel final. Expliquez le mouvement qui les relie, notamment les changements de pose, de position d’objet, de caméra ou d’éclairage. Pour une transition entre deux images, évitez un brief qui introduit une scène incompatible entre ses extrémités.\n\nLa sortie guidée par ces images déduit son rapport largeur/hauteur de l’image d’entrée. Pour un travail à partir de texte uniquement, choisissez un rapport précis parmi 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Le travail guidé par des références peut utiliser un rapport adaptatif ou l’un des choix explicites documentés. Composez la référence ou la scène écrite pour le format cible au lieu de supposer que la même disposition fonctionne aussi bien en portrait qu’en paysage.\n\nRéférences multimodales\n\nLe schéma de génération Max actuel de MiniMax documente aussi les images, vidéos et sons de référence. Précisez ce que chacun doit influencer : identité d’un personnage, environnement, motif de mouvement, trajectoire de caméra, timbre de voix ou caractéristique sonore. Les rôles de première/dernière image et les rôles de médias de référence s’excluent mutuellement dans cette interface.\n\nPour un plan de personnage, identifiez séparément la référence d’apparence et celle de mouvement, puis fournissez l’action cible et la réplique. Une référence vocale qui définit l’interprétation diffère de la copie de son signal audio complet. Précisez dans le brief les caractéristiques à préserver et les changements à apporter, puis comparez le clip audiovisuel réel à chaque rôle de référence.\n\nExtension du prompt\n\nLe réglage d’extension propre à Max propose les choix disabled, balanced et quality, avec balanced par défaut. Choisissez disabled lorsque le brief fourni doit être transmis sans extension ; utilisez un mode d’extension documenté lorsqu’une interprétation supplémentaire est souhaitée. Conservez le brief original afin de distinguer un changement introduit pendant l’extension du contenu demandé.\n\nDécrivez le son comme une partie de la scène. Identifiez les sons physiques, l’ambiance et les mots prononcés, et distinguez-les d’une musique de fond destinée uniquement au public. Fournissez la réplique exacte et la personne qui doit la prononcer plutôt que de demander un dialogue indéfini. Écoutez le résultat autant que vous le regardez ; une image convaincante ne prouve pas que les mots prononcés ou leurs temps sont corrects.\n\nPréparation des entrées et limites\n\nLe schéma actuel du producteur accepte des images JPG, JPEG, PNG, WebP, HEIC ou HEIF, jusqu’à 30 Mo chacune, avec des côtés de 256 à 5 760 pixels et des rapports de 0.4 à 2.5. Les rôles d’ouverture et de fin autorisent chacun une image ; le mode de références accepte jusqu’à neuf images. Préservez une vue claire du sujet et des détails qui doivent rester identifiables.\n\nLes vidéos de référence autorisent jusqu’à trois clips MP4 ou MOV, chacun de 2 à 15 secondes et ensemble de 15 secondes au maximum, avec une limite de 50 Mo par fichier. Le schéma documente la vidéo H.264 ou H.265, le son AAC ou MP3, des côtés de 256 à 5 760 pixels, des rapports de 0.4 à 2.5 et une fréquence d’images de 23.976 à 60. Le son de référence autorise jusqu’à trois clips WAV ou MP3, chacun de 15 Mo au maximum et de 2 à 15 secondes, avec un total de 15 secondes au maximum. Le corps de la requête a une limite distincte de 64 Mo.\n\nN’utilisez que les références qui contribuent au plan et identifiez chaque contribution dans le texte. Un court clip de mouvement pertinent est plus facile à utiliser comme direction qu’une longue collection d’événements sans rapport. Gardez la durée souhaitée et la résolution de sortie explicites afin de comparer le résultat au même brief.\n\nLe résultat terminé\n\nLe processus asynchrone du producteur renvoie un identifiant de tâche avant que la vidéo terminée soit disponible. Son interface de consultation récupère les tâches des sept jours précédents. Sauvegardez le clip réellement renvoyé et sa spécification pour le montage ou une revue ultérieure ; un identifiant de tâche n’est pas le livrable audiovisuel. Les adresses de téléchargement sont limitées dans le temps : conservez donc le fichier lui-même lorsque vous retenez un résultat choisi.\n\nVérifiez la continuité du sujet, le mouvement, le texte visible, le dialogue et les temps sonores aux dimensions d’utilisation du clip. Utilisez des retours concrets pour un autre brief créatif : le geste qui a changé, la réplique omise ou le cadrage à ajuster. Le résultat utile est un court plan audiovisuel relié au contenu fourni et à ses relations explicites entre références.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3-max", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.5", "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": "0.5", "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": "c3ee132fc5b4cd02f24f5c4d", "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.16", "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: 480p" }, "label": "Tarif vidéo", "units": [ { "amount": "0.1", "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: 768p" }, "label": "Tarif vidéo", "units": [ { "amount": "0.16", "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": "minimax/hailuo-3-max", "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 toutes les sorties réelles vous appartenant et les métadonnées mesurées renvoyées pour chacune.", "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 vidéo n’est pas disponible, ou cet identifiant vidéo est introuvable.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Vérifiez l’accès vidéo. Pour une vidéo existante, utilisez son identifiant 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 à votre compte avant de soumettre la demande.", "type": "authentication_error" }, { "condition": "La requête n’a pas pu être lue ou l’index de téléchargement n’est pas valide.", "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 demande corrigée.", "type": "price_unavailable" }, { "condition": "Une entrée vidéo ou une tâche de continuation d’origine n’est pas valide.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Utilisez des entrées HTTPS valides. Pour une continuation, utilisez l’identifiant vidéo public de votre original terminé avec la même clé API.", "type": "invalid_request_error" }, { "condition": "Le solde disponible ou les limites ne permettent pas de réserver les fonds nécessaires.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Vérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle demande.", "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 possédez déjà un identifiant vidéo, consultez 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 nécessitent une vérification.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conservez l’identifiant vidéo renvoyé et consultez cette tâche. N’envoyez pas de demande de génération de remplacement tant que sa vérification est en cours.", "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": "Consultez cette même tâche vidéo ultérieurement et téléchargez sa sortie existante. 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 le statut de la tâche d’origine. Téléchargez après l’apparition de completed ; si elle indique failed, suivez son avis de vérification de la 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 demande d’origine" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "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 d’image.", "required": [ "model", "prompt", "duration" ], "required_material": "Une consigne écrite." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images est un tableau. Chaque objet d’image comporte type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame avec, facultativement, last_frame. Chaque rôle d’image apparaît au plus une fois. Fournissez une URL HTTPS publique pour chaque image. Choisissez une résolution prise en charge et, si nécessaire, un rapport d’image.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Une consigne écrite et une image initiale." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "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 sorties, en 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 HTTPS signée pour télécharger 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 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 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 vidéo mesurée en millisecondes ; null si 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 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 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’est pas 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’est 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 signées de contenu vous appartenant", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "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 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "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 ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "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 d’image ; image_url contient uniquement url. Omettez frame_images pour une requête contenant uniquement du texte.", "content": "Tableau d’objets d’image. Chaque objet comporte type=image_url, image_url contenant url et frame_type. Utilisez une URL HTTPS pour l’image 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": "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 ], "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 ], "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": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "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." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "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", "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" ], "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", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Sortie vidéo · tarif de référence", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "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: 480p", "quoted_unit": "per video second" }, "label": "Tarif vidéo", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "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: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "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 de génération estimé", "units": [ { "amount": "0.5", "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": "0.5", "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\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', 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", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "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: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "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: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "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": "0.5", "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": "0.5", "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": "minimax/hailuo-3-max", "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.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "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.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "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.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "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.5", "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": "0.5", "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": "minimax/hailuo-3-max", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" } ], "name": "MiniMax: H3 Max", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.5, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.5, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "480P" }, "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": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "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": { "adds_to_output": true, "output_resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.1106", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "480P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.286", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.148", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.10", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=480p", "billing_original_currency": "USD", "billing_original_rate": "0.10", "key": "duration_seconds_480p", "label": "output second", "native_amount_usd_per_unit": "0.10", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=768p", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds_768p", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "minimax/hailuo-3-max", "short": "MiniMax H3 Max est une variante rapide de H3 affinée par post-entraînement pour de courtes vidéos avec du son synchronisé. Le processus documenté de MiniMax prend en charge le texte, les images de début et de fin et les références multimodales, avec une sortie 480P ou 768P, une durée de 5 à 15 secondes et ses propres choix d’extension du prompt." }, "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": "MiniMax H3 Max est une variante rapide de H3 affinée par post-entraînement pour de courtes vidéos avec du son synchronisé. Le processus documenté de MiniMax prend en charge le texte, les images de début et de fin et les références multimodales, avec une sortie 480P ou 768P, une durée de 5 à 15 secondes et ses propres choix d’extension du prompt.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "4e282ba7ce106fd998dbfb1bb0eee44093ea5543df314ba0c79664e79428486f", "renderer_sha256": "44d2db1deadc475e1793597083716540bae7bbc53606f05f58780fec5f115dd4" }, "sourceRevision": "6a22289c9c91e1779871c6e657ecfb02be6d8b6cfef1775bb72585bea3968644" }