L'API MiniMax H3 pour la génération vidéo

Choisir le modèle H3 adapté à vos entrées
hailuo_h3 : texte, première frame, ou première et dernière frame
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
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

Paramètres et limites de l'API MiniMax H3
Endpoint commun et réponse asynchrone
POST https://api.goenhance.ai/api/v1/videos/generations. La réponse renvoie un img_uuid ; la génération se poursuit de façon asynchrone.Durée et prompt de hailuo_h3
duration 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. prompt est obligatoire et accepte jusqu'à 7 000 caractères.Résolution et format d'image de hailuo_h3
ratio accepte 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Lorsque image_url 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
image_url pour la première frame et, en option, image_end_url 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
ref_imgs, 3 vidéos dans ref_videos et 3 extraits audio dans ref_audios. 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
Tarif de MiniMax H3 à la seconde
hailuo_h3 — 480p : $0.030 par seconde
hailuo_h3 — 720p : $0.060 par seconde
hailuo_h3 — 2K : $0.090 par seconde
hailuo_h3_refs — 768P : $0.099 par seconde
hailuo_h3_refs — 2K : $0.143 par seconde
Tokens, remboursements et concurrence
Intégrer l'API vidéo MiniMax H3
1. Créer et protéger une clé API
Authorization: Bearer <API key> et ne l'exposez jamais dans du code navigateur ni dans les logs.2. Choisir un modèle et valider la requête
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. Envoyer et conserver l'img_uuid
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. Interroger ou recevoir des callbacks
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. Gérer la validation, les échecs et la concurrence
Ce que les développeurs livrent avec H3
Variantes publicitaires programmatiques
Pipelines de clips produit
Spots vidéo localisés
Systèmes de production UGC
FAQ de l'API MiniMax H3
Quelle durée l'API MiniMax H3 accepte-t-elle ?
hailuo_h3 comme hailuo_h3_refs acceptent tout entier de 5 à 15 secondes, avec 5 par défaut. Les valeurs non entières ou hors limites sont rejetées avant tout débit de tokens.
Pourquoi y a-t-il deux identifiants de modèle H3 ?
MiniMax considère le contrôle de frames et les médias de référence comme mutuellement exclusifs. GoEnhance expose donc hailuo_h3 pour les workflows première/dernière frame et hailuo_h3_refs pour la génération pilotée par références, au lieu de combiner des paramètres qui entrent en conflit à l'exécution.
480p et 720p sont-ils des paliers de sortie officiels de MiniMax ?
Non. MiniMax ne produit officiellement que du 2K. Les paliers 480p et 720p de hailuo_h3 tournent sur le pipeline propre à GoEnhance. Ils permettent d'itérer à moindre coût, puis de n'utiliser le 2K que pour les prises retenues.
Pourquoi hailuo_h3_refs coûte-t-il plus cher ?
hailuo_h3_refs passe uniquement par le canal officiel de MiniMax. Ses résolutions disponibles sont 768P et 2K, aux tarifs à la seconde de $0.099 et $0.143 respectivement.
Comment fonctionne la facturation ?
La facturation se fait en tokens : $10 donnent 500 tokens, soit $0.02 par token. La vidéo est facturée à la seconde au tarif indiqué. Les points sont débités une seule fois à l'envoi de la tâche et intégralement remboursés si la génération échoue.
MiniMax H3 génère-t-il du son ?
Oui. H3 génère dialogues, effets sonores et ambiance de pièce en stéréo native dans la même passe que la vidéo, plutôt que d'ajouter un doublage après coup.
Comment savoir qu'une vidéo est prête ?
Conservez l'img_uuid renvoyé et interrogez l'endpoint de détail de tâche, ou enregistrez une URL de callback. Le callback de démarrage utilise status=0 ; le callback final transporte le résultat.
GoEnhance Open API est-elle affiliée à MiniMax ou Hailuo ?
Non. GoEnhance Open API est une plateforme d'API tierce indépendante. Elle n'est ni MiniMax ni Hailuo, n'est pas affiliée à MiniMax et n'est pas approuvée par MiniMax. Ces noms servent à désigner le modèle et appartiennent à leur titulaire.
Où se trouve l'éditeur MiniMax H3 sans code ?
Cette page porte sur l'intégration par API REST. Pour un éditeur grand public, rendez-vous sur la page du modèle vidéo MiniMax H3.
