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
Réalisateur à côté d'une caméra de cinéma sur un plateau à l'éclairage professionnel

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.
Créateur dirigeant un tournage de vidéo produit avec caméra et éclairage professionnels

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.
hailuo_h3_refs : génération pilotée par références

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.
Accès API unifié et indépendant
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 à 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

Choisissez 480p, 720p ou 2K. Uniquement en texte-vers-vidéo, 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

Passez 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

Une seule requête accepte jusqu'à 9 images dans 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

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 paliers tarifaires et crédits.

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.
Créer une clé API
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.

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.

Démarrez votre intégration de l'API MiniMax H3