MiniMax Hailuo 2.3 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il s’appuie sur Hailuo 02 en mettant l’accent sur l’action physique, le style visuel, les micro-expressions des personnages et la réponse aux consignes de mouvement. Fournissez une scène écrite pour créer un plan de toutes pièces, ou utilisez une image de départ pour définir la vue d’ouverture et décrire le mouvement qui suit.
L’interprétation physique est l’un des principaux domaines d’amélioration de cette édition. Hailuo 2.3 vise à rendre les mouvements du corps plus fluides et maîtrisés, y compris dans les scènes où la caméra se déplace. Préparez l’action importante avant d’ajouter des détails décoratifs. Un personnage qui soulève un objet, se tourne vers une autre personne ou traverse une pièce donne au plan un événement visible à évaluer. Déterminez le mouvement qui porte l’histoire, puis gardez les consignes environnantes cohérentes avec lui.
La stylisation est un autre axe. Le modèle permet de travailler dans les styles anime et illustration, ainsi que dans des styles tels que la peinture au lavis et les images de synthèse de jeux vidéo. Décrivez le traitement visuel souhaité et gardez une apparence cohérente avec la scène. Si une image de départ définit déjà un style de dessin, utilisez le texte pour guider l’animation au lieu d’introduire une description concurrente du dessin du personnage. Examinez tout le clip pour vérifier que ce traitement reste lisible pendant le mouvement.
Le modèle se concentre aussi sur le jeu du visage et les changements d’expression subtils. Préparez un plan de personnage autour de la réaction importante : remarquer un objet, devenir curieux ou répondre par un petit sourire. Une vue rapprochée peut faciliter l’évaluation de ce changement, tandis qu’une grande suite de gestes peut en détourner l’attention. Vérifiez le visage avant, pendant et après la réaction au lieu de juger uniquement une image fixe représentative.
Le mouvement des objets est utile pour les scènes centrées sur un produit. Un brief peut montrer un petit vase en céramique qui tourne sous une lumière latérale chaude pendant que la caméra s’en approche progressivement. Identifiez les propriétés qui doivent rester reconnaissables, telles que la silhouette, le bord et la finition de surface. Vérifiez ces détails pendant le mouvement, car une atmosphère convaincante ne suffit pas à établir une vue fidèle du produit.
Pour la génération à partir de texte, la description obligatoire peut contenir jusqu’à 2 000 caractères. Énoncez le sujet, l’action, le décor et le style visuel dans un ordre cohérent. La génération à partir d’une image exige une image initiale, avec une description facultative de 2 000 caractères au maximum. L’image fixe la composition d’ouverture : préparez donc le sujet et le cadrage avant de demander le mouvement. Laissez de l’espace visible là où un bras, un objet ou un personnage doivent se déplacer.
L’image de départ accepte JPG, JPEG, PNG ou WebP, doit être inférieure à 20 Mo, avoir un côté court supérieur à 300 pixels et un rapport largeur/hauteur compris entre 2:5 et 5:2. Elle peut être fournie sous forme d’URL d’image publique ou d’URL de données Base64. Choisissez une image d’ouverture claire au lieu de compter sur l’animation pour réparer un visage masqué ou une action déjà recadrée.
Hailuo 2.3 génère à 24 images par seconde. Un plan de six secondes peut utiliser la 768P ou la 1080P ; un plan de dix secondes utilise la 768P. Les réglages par défaut sont six secondes et la 768P. Choisissez la durée en fonction de l’action à voir : une brève réaction peut tenir dans un plan court, tandis qu’un mouvement plus lent demande davantage de place. Consultez la largeur et la hauteur réelles du résultat terminé lorsque vous placez le clip dans un montage, car une étiquette de résolution ne définit pas à elle seule tout le cadrage.
Les consignes de caméra peuvent utiliser des commandes entre crochets. Les contrôles disponibles couvrent le travelling latéral, le panoramique horizontal, l’avancée de caméra, le déplacement vertical de caméra, le panoramique vertical, le zoom, les secousses, le suivi et le plan fixe. Une commande telle que [Push in] dirige l’approche ; les commandes regroupées dans les mêmes crochets agissent ensemble, tandis que les commandes placées dans l’ordre décrivent une séquence. MiniMax recommande au maximum trois commandes simultanées. Gardez le mouvement de caméra compatible avec l’action du sujet pour que l’événement principal reste facile à suivre.
L’optimisation automatique du prompt est activée par défaut et peut être désactivée pour mieux contrôler la formulation fournie. Le prétraitement rapide facultatif réduit le temps d’optimisation lorsque celle-ci est activée ; il s’agit d’un réglage distinct du choix du modèle Hailuo 2.3 Fast. Hailuo 2.3 standard prend en charge les deux modes de création, tandis que Fast est l’édition distincte de génération à partir d’une image. Choisissez l’édition selon que le projet commence par du texte seul ou par une image existante.
Le processus de génération renvoie un identifiant de tâche asynchrone, puis indique les étapes de préparation, de mise en file d’attente, de traitement, de réussite ou d’échec. En cas de réussite, le résultat fournit un identifiant de fichier et les dimensions réelles de la vidéo, puis la vidéo terminée est récupérée pour téléchargement. Sauvegardez le clip pendant que son adresse de téléchargement est valide. La référence actuelle de téléchargement vidéo du producteur donne à l’URL renvoyée une durée de vie d’une heure. Pour une séquence montée, conservez chaque plan avec son prompt et son image de départ afin que la direction créative choisie reste traçable lors des révisions.
Vérifiez l’action, la continuité physique, les détails du visage ou du produit, le style visuel et le comportement de la caméra dans le clip sauvegardé. Regardez tout le plan, puis examinez son début et sa fin, là où il sera raccordé à d’autres séquences. Si la requête contient trop de mouvements concurrents, simplifiez l’action principale ; si la conception d’ouverture manque de clarté, améliorez l’image de départ. Sélectionnez un plan qui communique l’événement souhaité, puis ajoutez la narration, les titres et les transitions dans le processus de montage.
", "aboutText": "MiniMax Hailuo 2.3 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il s’appuie sur Hailuo 02 en mettant l’accent sur l’action physique, le style visuel, les micro-expressions des personnages et la réponse aux consignes de mouvement. Fournissez une scène écrite pour créer un plan de toutes pièces, ou utilisez une image de départ pour définir la vue d’ouverture et décrire le mouvement qui suit.\n\nL’interprétation physique est l’un des principaux domaines d’amélioration de cette édition. Hailuo 2.3 vise à rendre les mouvements du corps plus fluides et maîtrisés, y compris dans les scènes où la caméra se déplace. Préparez l’action importante avant d’ajouter des détails décoratifs. Un personnage qui soulève un objet, se tourne vers une autre personne ou traverse une pièce donne au plan un événement visible à évaluer. Déterminez le mouvement qui porte l’histoire, puis gardez les consignes environnantes cohérentes avec lui.\n\nLa stylisation est un autre axe. Le modèle permet de travailler dans les styles anime et illustration, ainsi que dans des styles tels que la peinture au lavis et les images de synthèse de jeux vidéo. Décrivez le traitement visuel souhaité et gardez une apparence cohérente avec la scène. Si une image de départ définit déjà un style de dessin, utilisez le texte pour guider l’animation au lieu d’introduire une description concurrente du dessin du personnage. Examinez tout le clip pour vérifier que ce traitement reste lisible pendant le mouvement.\n\nLe modèle se concentre aussi sur le jeu du visage et les changements d’expression subtils. Préparez un plan de personnage autour de la réaction importante : remarquer un objet, devenir curieux ou répondre par un petit sourire. Une vue rapprochée peut faciliter l’évaluation de ce changement, tandis qu’une grande suite de gestes peut en détourner l’attention. Vérifiez le visage avant, pendant et après la réaction au lieu de juger uniquement une image fixe représentative.\n\nLe mouvement des objets est utile pour les scènes centrées sur un produit. Un brief peut montrer un petit vase en céramique qui tourne sous une lumière latérale chaude pendant que la caméra s’en approche progressivement. Identifiez les propriétés qui doivent rester reconnaissables, telles que la silhouette, le bord et la finition de surface. Vérifiez ces détails pendant le mouvement, car une atmosphère convaincante ne suffit pas à établir une vue fidèle du produit.\n\nPour la génération à partir de texte, la description obligatoire peut contenir jusqu’à 2 000 caractères. Énoncez le sujet, l’action, le décor et le style visuel dans un ordre cohérent. La génération à partir d’une image exige une image initiale, avec une description facultative de 2 000 caractères au maximum. L’image fixe la composition d’ouverture : préparez donc le sujet et le cadrage avant de demander le mouvement. Laissez de l’espace visible là où un bras, un objet ou un personnage doivent se déplacer.\n\nL’image de départ accepte JPG, JPEG, PNG ou WebP, doit être inférieure à 20 Mo, avoir un côté court supérieur à 300 pixels et un rapport largeur/hauteur compris entre 2:5 et 5:2. Elle peut être fournie sous forme d’URL d’image publique ou d’URL de données Base64. Choisissez une image d’ouverture claire au lieu de compter sur l’animation pour réparer un visage masqué ou une action déjà recadrée.\n\nHailuo 2.3 génère à 24 images par seconde. Un plan de six secondes peut utiliser la 768P ou la 1080P ; un plan de dix secondes utilise la 768P. Les réglages par défaut sont six secondes et la 768P. Choisissez la durée en fonction de l’action à voir : une brève réaction peut tenir dans un plan court, tandis qu’un mouvement plus lent demande davantage de place. Consultez la largeur et la hauteur réelles du résultat terminé lorsque vous placez le clip dans un montage, car une étiquette de résolution ne définit pas à elle seule tout le cadrage.\n\nLes consignes de caméra peuvent utiliser des commandes entre crochets. Les contrôles disponibles couvrent le travelling latéral, le panoramique horizontal, l’avancée de caméra, le déplacement vertical de caméra, le panoramique vertical, le zoom, les secousses, le suivi et le plan fixe. Une commande telle que [Push in] dirige l’approche ; les commandes regroupées dans les mêmes crochets agissent ensemble, tandis que les commandes placées dans l’ordre décrivent une séquence. MiniMax recommande au maximum trois commandes simultanées. Gardez le mouvement de caméra compatible avec l’action du sujet pour que l’événement principal reste facile à suivre.\n\nL’optimisation automatique du prompt est activée par défaut et peut être désactivée pour mieux contrôler la formulation fournie. Le prétraitement rapide facultatif réduit le temps d’optimisation lorsque celle-ci est activée ; il s’agit d’un réglage distinct du choix du modèle Hailuo 2.3 Fast. Hailuo 2.3 standard prend en charge les deux modes de création, tandis que Fast est l’édition distincte de génération à partir d’une image. Choisissez l’édition selon que le projet commence par du texte seul ou par une image existante.\n\nLe processus de génération renvoie un identifiant de tâche asynchrone, puis indique les étapes de préparation, de mise en file d’attente, de traitement, de réussite ou d’échec. En cas de réussite, le résultat fournit un identifiant de fichier et les dimensions réelles de la vidéo, puis la vidéo terminée est récupérée pour téléchargement. Sauvegardez le clip pendant que son adresse de téléchargement est valide. La référence actuelle de téléchargement vidéo du producteur donne à l’URL renvoyée une durée de vie d’une heure. Pour une séquence montée, conservez chaque plan avec son prompt et son image de départ afin que la direction créative choisie reste traçable lors des révisions.\n\nVérifiez l’action, la continuité physique, les détails du visage ou du produit, le style visuel et le comportement de la caméra dans le clip sauvegardé. Regardez tout le plan, puis examinez son début et sa fin, là où il sera raccordé à d’autres séquences. Si la requête contient trop de mouvements concurrents, simplifiez l’action principale ; si la conception d’ouverture manque de clarté, améliorez l’image de départ. Sélectionnez un plan qui communique l’événement souhaité, puis ajoutez la narration, les titres et les transitions dans le processus de montage.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ff455c56e64d3f8f21bb429035029c015898c28cf614acc174a4b8dced628fdd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr", "methods": [ { "html": "MiniMax-Hailuo-2.3MiniMax Hailuo 2.3 crée des vidéos à partir de texte ou d’une image de départ, avec des contrôles de mouvement et de direction de caméra. Choisissez six secondes en 768P ou 1080P, ou dix secondes en 768P, pour des interprétations de personnages, des scènes stylisées et des plans de produits à examiner et à monter.
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.
MiniMax Hailuo 2.3 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il s’appuie sur Hailuo 02 en mettant l’accent sur l’action physique, le style visuel, les micro-expressions des personnages et la réponse aux consignes de mouvement. Fournissez une scène écrite pour créer un plan de toutes pièces, ou utilisez une image de départ pour définir la vue d’ouverture et décrire le mouvement qui suit.
L’interprétation physique est l’un des principaux domaines d’amélioration de cette édition. Hailuo 2.3 vise à rendre les mouvements du corps plus fluides et maîtrisés, y compris dans les scènes où la caméra se déplace. Préparez l’action importante avant d’ajouter des détails décoratifs. Un personnage qui soulève un objet, se tourne vers une autre personne ou traverse une pièce donne au plan un événement visible à évaluer. Déterminez le mouvement qui porte l’histoire, puis gardez les consignes environnantes cohérentes avec lui.
La stylisation est un autre axe. Le modèle permet de travailler dans les styles anime et illustration, ainsi que dans des styles tels que la peinture au lavis et les images de synthèse de jeux vidéo. Décrivez le traitement visuel souhaité et gardez une apparence cohérente avec la scène. Si une image de départ définit déjà un style de dessin, utilisez le texte pour guider l’animation au lieu d’introduire une description concurrente du dessin du personnage. Examinez tout le clip pour vérifier que ce traitement reste lisible pendant le mouvement.
Le modèle se concentre aussi sur le jeu du visage et les changements d’expression subtils. Préparez un plan de personnage autour de la réaction importante : remarquer un objet, devenir curieux ou répondre par un petit sourire. Une vue rapprochée peut faciliter l’évaluation de ce changement, tandis qu’une grande suite de gestes peut en détourner l’attention. Vérifiez le visage avant, pendant et après la réaction au lieu de juger uniquement une image fixe représentative.
Le mouvement des objets est utile pour les scènes centrées sur un produit. Un brief peut montrer un petit vase en céramique qui tourne sous une lumière latérale chaude pendant que la caméra s’en approche progressivement. Identifiez les propriétés qui doivent rester reconnaissables, telles que la silhouette, le bord et la finition de surface. Vérifiez ces détails pendant le mouvement, car une atmosphère convaincante ne suffit pas à établir une vue fidèle du produit.
Pour la génération à partir de texte, la description obligatoire peut contenir jusqu’à 2 000 caractères. Énoncez le sujet, l’action, le décor et le style visuel dans un ordre cohérent. La génération à partir d’une image exige une image initiale, avec une description facultative de 2 000 caractères au maximum. L’image fixe la composition d’ouverture : préparez donc le sujet et le cadrage avant de demander le mouvement. Laissez de l’espace visible là où un bras, un objet ou un personnage doivent se déplacer.
L’image de départ accepte JPG, JPEG, PNG ou WebP, doit être inférieure à 20 Mo, avoir un côté court supérieur à 300 pixels et un rapport largeur/hauteur compris entre 2:5 et 5:2. Elle peut être fournie sous forme d’URL d’image publique ou d’URL de données Base64. Choisissez une image d’ouverture claire au lieu de compter sur l’animation pour réparer un visage masqué ou une action déjà recadrée.
Hailuo 2.3 génère à 24 images par seconde. Un plan de six secondes peut utiliser la 768P ou la 1080P ; un plan de dix secondes utilise la 768P. Les réglages par défaut sont six secondes et la 768P. Choisissez la durée en fonction de l’action à voir : une brève réaction peut tenir dans un plan court, tandis qu’un mouvement plus lent demande davantage de place. Consultez la largeur et la hauteur réelles du résultat terminé lorsque vous placez le clip dans un montage, car une étiquette de résolution ne définit pas à elle seule tout le cadrage.
Les consignes de caméra peuvent utiliser des commandes entre crochets. Les contrôles disponibles couvrent le travelling latéral, le panoramique horizontal, l’avancée de caméra, le déplacement vertical de caméra, le panoramique vertical, le zoom, les secousses, le suivi et le plan fixe. Une commande telle que [Push in] dirige l’approche ; les commandes regroupées dans les mêmes crochets agissent ensemble, tandis que les commandes placées dans l’ordre décrivent une séquence. MiniMax recommande au maximum trois commandes simultanées. Gardez le mouvement de caméra compatible avec l’action du sujet pour que l’événement principal reste facile à suivre.
L’optimisation automatique du prompt est activée par défaut et peut être désactivée pour mieux contrôler la formulation fournie. Le prétraitement rapide facultatif réduit le temps d’optimisation lorsque celle-ci est activée ; il s’agit d’un réglage distinct du choix du modèle Hailuo 2.3 Fast. Hailuo 2.3 standard prend en charge les deux modes de création, tandis que Fast est l’édition distincte de génération à partir d’une image. Choisissez l’édition selon que le projet commence par du texte seul ou par une image existante.
Le processus de génération renvoie un identifiant de tâche asynchrone, puis indique les étapes de préparation, de mise en file d’attente, de traitement, de réussite ou d’échec. En cas de réussite, le résultat fournit un identifiant de fichier et les dimensions réelles de la vidéo, puis la vidéo terminée est récupérée pour téléchargement. Sauvegardez le clip pendant que son adresse de téléchargement est valide. La référence actuelle de téléchargement vidéo du producteur donne à l’URL renvoyée une durée de vie d’une heure. Pour une séquence montée, conservez chaque plan avec son prompt et son image de départ afin que la direction créative choisie reste traçable lors des révisions.
Vérifiez l’action, la continuité physique, les détails du visage ou du produit, le style visuel et le comportement de la caméra dans le clip sauvegardé. Regardez tout le plan, puis examinez son début et sa fin, là où il sera raccordé à d’autres séquences. Si la requête contient trop de mouvements concurrents, simplifiez l’action principale ; si la conception d’ouverture manque de clarté, améliorez l’image de départ. Sélectionnez un plan qui communique l’événement souhaité, puis ajoutez la narration, les titres et les transitions dans le processus de montage.
POST /v1/videos/generationstext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites MiniMax-Hailuo-2.3 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 Longueur maximale: 2 000 Unité: caractères Unicode | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites 6, 10 Conditions: 10 secondes nécessitent une résolution de 768P Unité: secondes | Par défaut6 |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 768P, 1080P Conditions: 1080P nécessite 6 secondes | Par défaut768P |
Champfirst_frame_image | Typehttps_url|data_image_url | ExigenceFacultatif | Valeurs et limites Nombre maximal d’octets décodés: 20 971 520 Types MIME: image/jpeg, image/png, image/webp Dimension minimale (exclue): 300 Plage des rapports d’aspect: 2:5, 5:2 | Par défaut— |
Champprompt_optimizer | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champfast_pretreatment | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Image vers vidéo · Obligatoire : prompt, first_frame_image
Texte vers vidéo · Obligatoire : prompt
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext, image |
Paramètrerequired | Contratnull |
Paramètreoptional_controls | Contratnull |
Cycle de vie : submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
POST /v1/videos/generationsAiloot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationMiniMax-Hailuo-2.3 · Configuration par défaut | Conditions de facturationConfiguration par défaut | Coût Entrée · Entrée 0,00 USD par appel Sortie · Sortie 0,60 USD par appel |
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationMiniMax-Hailuo-2.3 · Configuration par défaut | Conditions de facturationConfiguration par défaut | Coût Entrée · Entrée 0,00 USD par appel Sortie · Sortie 1,20 USD par appel |
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationMiniMax-Hailuo-2.3 · Configuration par défaut | Conditions de facturationConfiguration par défaut | Coût Entrée · Entrée 0,00 USD par appel Sortie · Sortie 1,20 USD par appel |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" \\\n -H "Content-Type: application/json" \\\n -d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY"set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" \\\n --output video.mp4Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Conservez chaque élément de data et chaque index de sortie renvoyés. content_url correspond uniquement au premier ; récupérez chaque chemin de contenu et chaque ressource réels. GET sur le contenu sans index ne renvoie pas toutes les sorties.
Consultez la tâche d’origine existante ; ne soumettez jamais à nouveau un envoi dont l’issue est inconnue.
| Champ | Type |
|---|---|
Champid | Typestring |
Champobject | Typestring |
Champmodel | Typestring |
Champstatus | Typestring |
Champcontent_url | Typesigned URL |
Champdata[] | Typesigned URL |
Champusage | Typeobject |
Champresult_pending_check | Typeboolean |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteInterrogez l’identifiant d’origine renvoyé et respectez Retry-After. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
/v1/videos/generations, /videos, /videos/generations
MiniMax-Hailuo-2.3MiniMax Hailuo 2.3 crée des vidéos à partir de texte ou d’une image de départ, avec des contrôles de mouvement et de direction de caméra. Choisissez six secondes en 768P ou 1080P, ou dix secondes en 768P, pour des interprétations de personnages, des scènes stylisées et des plans de produits à examiner et à monter.
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.
MiniMax Hailuo 2.3 est un modèle de génération vidéo doté de modes à partir de texte ou d’une image. Il s’appuie sur Hailuo 02 en mettant l’accent sur l’action physique, le style visuel, les micro-expressions des personnages et la réponse aux consignes de mouvement. Fournissez une scène écrite pour créer un plan de toutes pièces, ou utilisez une image de départ pour définir la vue d’ouverture et décrire le mouvement qui suit.
L’interprétation physique est l’un des principaux domaines d’amélioration de cette édition. Hailuo 2.3 vise à rendre les mouvements du corps plus fluides et maîtrisés, y compris dans les scènes où la caméra se déplace. Préparez l’action importante avant d’ajouter des détails décoratifs. Un personnage qui soulève un objet, se tourne vers une autre personne ou traverse une pièce donne au plan un événement visible à évaluer. Déterminez le mouvement qui porte l’histoire, puis gardez les consignes environnantes cohérentes avec lui.
La stylisation est un autre axe. Le modèle permet de travailler dans les styles anime et illustration, ainsi que dans des styles tels que la peinture au lavis et les images de synthèse de jeux vidéo. Décrivez le traitement visuel souhaité et gardez une apparence cohérente avec la scène. Si une image de départ définit déjà un style de dessin, utilisez le texte pour guider l’animation au lieu d’introduire une description concurrente du dessin du personnage. Examinez tout le clip pour vérifier que ce traitement reste lisible pendant le mouvement.
Le modèle se concentre aussi sur le jeu du visage et les changements d’expression subtils. Préparez un plan de personnage autour de la réaction importante : remarquer un objet, devenir curieux ou répondre par un petit sourire. Une vue rapprochée peut faciliter l’évaluation de ce changement, tandis qu’une grande suite de gestes peut en détourner l’attention. Vérifiez le visage avant, pendant et après la réaction au lieu de juger uniquement une image fixe représentative.
Le mouvement des objets est utile pour les scènes centrées sur un produit. Un brief peut montrer un petit vase en céramique qui tourne sous une lumière latérale chaude pendant que la caméra s’en approche progressivement. Identifiez les propriétés qui doivent rester reconnaissables, telles que la silhouette, le bord et la finition de surface. Vérifiez ces détails pendant le mouvement, car une atmosphère convaincante ne suffit pas à établir une vue fidèle du produit.
Pour la génération à partir de texte, la description obligatoire peut contenir jusqu’à 2 000 caractères. Énoncez le sujet, l’action, le décor et le style visuel dans un ordre cohérent. La génération à partir d’une image exige une image initiale, avec une description facultative de 2 000 caractères au maximum. L’image fixe la composition d’ouverture : préparez donc le sujet et le cadrage avant de demander le mouvement. Laissez de l’espace visible là où un bras, un objet ou un personnage doivent se déplacer.
L’image de départ accepte JPG, JPEG, PNG ou WebP, doit être inférieure à 20 Mo, avoir un côté court supérieur à 300 pixels et un rapport largeur/hauteur compris entre 2:5 et 5:2. Elle peut être fournie sous forme d’URL d’image publique ou d’URL de données Base64. Choisissez une image d’ouverture claire au lieu de compter sur l’animation pour réparer un visage masqué ou une action déjà recadrée.
Hailuo 2.3 génère à 24 images par seconde. Un plan de six secondes peut utiliser la 768P ou la 1080P ; un plan de dix secondes utilise la 768P. Les réglages par défaut sont six secondes et la 768P. Choisissez la durée en fonction de l’action à voir : une brève réaction peut tenir dans un plan court, tandis qu’un mouvement plus lent demande davantage de place. Consultez la largeur et la hauteur réelles du résultat terminé lorsque vous placez le clip dans un montage, car une étiquette de résolution ne définit pas à elle seule tout le cadrage.
Les consignes de caméra peuvent utiliser des commandes entre crochets. Les contrôles disponibles couvrent le travelling latéral, le panoramique horizontal, l’avancée de caméra, le déplacement vertical de caméra, le panoramique vertical, le zoom, les secousses, le suivi et le plan fixe. Une commande telle que [Push in] dirige l’approche ; les commandes regroupées dans les mêmes crochets agissent ensemble, tandis que les commandes placées dans l’ordre décrivent une séquence. MiniMax recommande au maximum trois commandes simultanées. Gardez le mouvement de caméra compatible avec l’action du sujet pour que l’événement principal reste facile à suivre.
L’optimisation automatique du prompt est activée par défaut et peut être désactivée pour mieux contrôler la formulation fournie. Le prétraitement rapide facultatif réduit le temps d’optimisation lorsque celle-ci est activée ; il s’agit d’un réglage distinct du choix du modèle Hailuo 2.3 Fast. Hailuo 2.3 standard prend en charge les deux modes de création, tandis que Fast est l’édition distincte de génération à partir d’une image. Choisissez l’édition selon que le projet commence par du texte seul ou par une image existante.
Le processus de génération renvoie un identifiant de tâche asynchrone, puis indique les étapes de préparation, de mise en file d’attente, de traitement, de réussite ou d’échec. En cas de réussite, le résultat fournit un identifiant de fichier et les dimensions réelles de la vidéo, puis la vidéo terminée est récupérée pour téléchargement. Sauvegardez le clip pendant que son adresse de téléchargement est valide. La référence actuelle de téléchargement vidéo du producteur donne à l’URL renvoyée une durée de vie d’une heure. Pour une séquence montée, conservez chaque plan avec son prompt et son image de départ afin que la direction créative choisie reste traçable lors des révisions.
Vérifiez l’action, la continuité physique, les détails du visage ou du produit, le style visuel et le comportement de la caméra dans le clip sauvegardé. Regardez tout le plan, puis examinez son début et sa fin, là où il sera raccordé à d’autres séquences. Si la requête contient trop de mouvements concurrents, simplifiez l’action principale ; si la conception d’ouverture manque de clarté, améliorez l’image de départ. Sélectionnez un plan qui communique l’événement souhaité, puis ajoutez la narration, les titres et les transitions dans le processus de montage.
POST /v1/videostextvideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites MiniMax-Hailuo-2.3 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 Longueur maximale: 2 000 Conditions: Pour 768P : au plus 2000 points de code Unicode. Pour 1080P : moins de 200 points de code Unicode (maximum 199). La consigne doit contenir au moins un caractère qui ne soit pas un caractère d’espacement. Unité: caractères Unicode | Par défaut— |
Champduration | Typeinteger | ExigenceObligatoire | Valeurs et limites 6 Unité: secondes | Par défaut— |
Champresolution | Typestring | ExigenceObligatoire | Valeurs et limites 768P, 1080P | Par défaut— |
Texte vers vidéo · Obligatoire : prompt
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, duration, resolution |
Paramètreother_options | Contratfalse |
Paramètreduration | Contrat6 |
Paramètreresolution | Contrat768P, 1080P |
Paramètreprompt_max_characters | Contrat2000 |
Paramètrematerial_types | Contrattext |
Paramètreprompt_max_characters_by_resolution | Contrat{"768P":2000,"1080P":199} |
Alias de méthode : /v1/videos/generations, /videos, /videos/generations
Cycle de vie : submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Créez une seule fois et enregistrez l’identifiant renvoyé.
Interrogez le statut d’origine ; conservez chaque ressource terminée et sa durée.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Durée nominale du clip, en secondes | Résolution | Unité de facturation | Coût |
|---|---|---|---|---|---|
| ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | Durée nominale du clip, en secondes— | Résolution— | Unité de facturation— | Coût Entrée · Tokens en entrée — / 1K tokens Sortie · Tokens en sortie — / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
| ConfigurationUltra | Barème tarifaire— | Durée nominale du clip, en secondes6 | Résolution1080P | Unité de facturationpar clip de sortie d’une durée nominale de 6s | Coût Sortie · clip de sortie d’une durée nominale de 6s $1.2 par clip de sortie d’une durée nominale de 6s |
| ConfigurationUltra | Barème tarifaire— | Durée nominale du clip, en secondes6 | Résolution768P | Unité de facturationpar clip de sortie d’une durée nominale de 6s | Coût Sortie · clip de sortie d’une durée nominale de 6s $0.6 par clip de sortie d’une durée nominale de 6s |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationMiniMax-Hailuo-2.3 · Configuration par défaut | Conditions de facturationConfiguration par défaut | Coût Entrée · Entrée 0,00 USD par appel Sortie · Sortie 0,60 USD par appel |
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationMiniMax-Hailuo-2.3 · Configuration par défaut | Conditions de facturationConfiguration par défaut | Coût Entrée · Entrée 0,00 USD par appel Sortie · Sortie 1,20 USD par appel |
| Configuration | Conditions de facturation | Coût |
|---|---|---|
| ConfigurationMiniMax-Hailuo-2.3 · Configuration par défaut | Conditions de facturationConfiguration par défaut | Coût Entrée · Entrée 0,00 USD par appel Sortie · Sortie 1,20 USD par appel |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nEnregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Une fois la tâche terminée, data[] contient toutes les URL signées de contenu vous appartenant. Récupérez chaque URL renvoyée, ou utilisez le point de terminaison de contenu avec index défini sur un index de sortie réel. Une tâche d’origine en échec peut renvoyer charge_pending_check ; vérifiez cette même tâche d’origine au lieu de la créer à nouveau.
Consultez la tâche d’origine existante ; ne soumettez jamais à nouveau un envoi dont l’issue est inconnue.
Nombre maximal de sorties : 1.
| Champ | Type |
|---|---|
Champid | Typestring |
Champobject | Typestring |
Champmodel | Typestring |
Champstatus | Typestring |
Champdata[] | Typesigned content URL |
Champcharge_pending_check | Typeboolean |
Champerror.code | Typestring |
Champerror.message | Typestring |
Champrequested_nominal_duration_seconds | Typeinteger |
Champmeasured_duration_seconds | Typenumber |
Champwidth | Typeinteger |
Champheight | Typeinteger |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteInterrogez l’identifiant d’origine renvoyé et respectez Retry-After. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
/v1/videos/generations, /videos, /videos/generations