L'API MiniMax H3 pour la génération vidéo
Accédez à MiniMax H3 via GoEnhance Open API, une plateforme indépendante. Envoyez du texte, des images de frame ou des médias de référence à un workflow REST asynchrone, récupérez un img_uuid, puis interrogez le résultat ou enregistrez un callback. H3 génère un audio stéréo natif — dialogues, effets sonores et ambiance de pièce — dans la même passe que l'image.
Créer une clé API
Choisir le modèle H3 adapté à vos entrées
hailuo_h3 : texte, première frame, ou première et dernière frame
Utilisez hailuo_h3 pour le texte-vers-vidéo, l'image-vers-vidéo avec image_url, ou le contrôle première/dernière frame en ajoutant l'option image_end_url. Le prompt est obligatoire et accepte jusqu'à 7 000 caractères. Voir le playground et la référence complète des paramètres.
hailuo_h3_refs : génération pilotée par références
Utilisez hailuo_h3_refs lorsqu'une seule requête a besoin de jusqu'à 9 images, 3 vidéos et 3 extraits audio de référence. Cette route passe par le canal officiel de MiniMax et propose une sortie en 768P et 2K. Voir l'endpoint référence-vers-vidéo.
Accès API unifié et indépendant
GoEnhance Open API est une plateforme tierce indépendante qui offre un accès unifié à des modèles vidéo et image. Elle n'est ni MiniMax ni Hailuo, n'est pas affiliée à MiniMax et n'est pas approuvée par MiniMax. MiniMax et Hailuo sont des marques de leur titulaire et ne sont utilisées ici que pour désigner le modèle.
Validez ces champs avant l'envoi pour que les requêtes invalides soient rejetées avant tout débit de tokens.
Paramètres et limites de l'API MiniMax H3
Endpoint commun et réponse asynchrone
Les deux modèles s'envoient à <code>POST https://api.goenhance.ai/api/v1/videos/generations</code>. La réponse renvoie un <code>img_uuid</code> ; la génération se poursuit de façon asynchrone.
Durée et prompt de hailuo_h3
<code>duration</code> doit être un entier compris entre 5 et 15 secondes, la valeur par défaut étant 5. Les valeurs non entières ou hors limites sont rejetées avant tout débit de tokens. <code>prompt</code> est obligatoire et accepte jusqu'à 7 000 caractères.
Résolution et format d'image de hailuo_h3
Choisissez 480p, 720p ou 2K. Uniquement en texte-vers-vidéo, <code>ratio</code> accepte 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Lorsque <code>image_url</code> fournit une première frame, la sortie suit cette image et le paramètre ratio n'est pas utilisé.
Entrées de frame de hailuo_h3
Passez <code>image_url</code> pour la première frame et, en option, <code>image_end_url</code> pour la dernière. Cet identifiant de modèle couvre à lui seul le texte-vers-vidéo, l'image-vers-vidéo et la génération première/dernière frame.
Entrées de référence de hailuo_h3_refs
Une seule requête accepte jusqu'à 9 images dans <code>ref_imgs</code>, 3 vidéos dans <code>ref_videos</code> et 3 extraits audio dans <code>ref_audios</code>. La durée est un entier de 5 à 15 secondes, par défaut 5 ; la résolution est 768P ou 2K.
Audio stéréo natif
H3 génère les dialogues, les effets sonores et l'ambiance de pièce en audio stéréo natif dans la même passe que l'image, plutôt que de doubler le son après coup.
Le coût par appel correspond au tarif à la seconde du palier choisi multiplié par la durée de sortie demandée. Les modèles vidéo sont facturés à la seconde produite.
Tarif de MiniMax H3 à la seconde
hailuo_h3 — 480p : $0.030 par seconde
Un palier du pipeline propre à GoEnhance pour itérer sur les prompts à moindre coût. Ce n'est pas un palier de sortie officiellement pris en charge par MiniMax.
hailuo_h3 — 720p : $0.060 par seconde
Un palier du pipeline propre à GoEnhance pour itérer moins cher avant de choisir les prises finales. Ce n'est pas un palier de sortie officiellement pris en charge par MiniMax.
hailuo_h3 — 2K : $0.090 par seconde
Utilisez le palier 2K pour les prises retenues qui nécessitent la résolution de sortie officielle de MiniMax.
hailuo_h3_refs — 768P : $0.099 par seconde
La génération pilotée par références passe par le canal officiel de MiniMax et utilise donc des paliers et des tarifs différents.
hailuo_h3_refs — 2K : $0.143 par seconde
Le palier 2K du canal officiel pour les requêtes pilotées par références.
Tokens, remboursements et concurrence
L'usage est facturé en tokens : $10 donnent 500 tokens, soit $0.02 par token. Les points sont débités une seule fois à l'envoi et intégralement remboursés si la génération échoue. La concurrence dépend du Build Tier du compte et démarre à 3 tâches en cours simultanées. Consultez les <a href="/billing">paliers tarifaires et crédits</a>.
Intégrer l'API vidéo MiniMax H3
1
1. Créer et protéger une clé API
Créez une clé sur /keys. Envoyez-la sous la forme
Authorization: Bearer <API key> et ne l'exposez jamais dans du code navigateur ni dans les logs. 2
2. Choisir un modèle et valider la requête
Choisissez
hailuo_h3 pour le texte ou le contrôle de frames, ou hailuo_h3_refs pour les médias de référence. Avant l'envoi, validez la durée, la résolution, l'applicabilité de ratio, la longueur du prompt et le nombre d'entrées. 3
3. Envoyer et conserver l'img_uuid
Envoyez la requête en POST vers
https://api.goenhance.ai/api/v1/videos/generations. Conservez l'img_uuid renvoyé dans votre propre enregistrement de tâche, car le traitement est asynchrone. 4
4. Interroger ou recevoir des callbacks
Interrogez
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., ou enregistrez une URL de callback. Un callback avec status=0 est déclenché au démarrage de la tâche ; le callback final transporte le résultat. 5
5. Gérer la validation, les échecs et la concurrence
Ne relancez pas telles quelles une durée invalide ou une combinaison d'entrées incompatible. Les générations échouées sont intégralement remboursées. Mettez les envois en file d'attente dès que les tâches en cours atteignent la concurrence autorisée par votre Build Tier.
Construisez des pipelines média reproductibles autour de tâches asynchrones, d'un audio natif et d'entrées de frame ou de référence explicites.
Ce que les développeurs livrent avec H3
Variantes publicitaires programmatiques
Générez par lots des concepts de campagne courts à partir de prompts structurés, puis ne gardez que les résultats validés.
Pipelines de clips produit
Utilisez une photo produit comme première frame et générez des clips courts dont le format suit l'image fournie.
Spots vidéo localisés
Générez image, dialogues, effets sonores et ambiance de pièce en une seule passe, puis faites passer chaque résultat dans votre workflow de localisation et de relecture.
Systèmes de production UGC
Reliez soumissions, suivi des tâches, callbacks, modération et stockage des assets dans un pipeline automatisé de contenus courts.
Limites, choix du modèle, facturation, audio et relation avec la plateforme.