MiniMax H3-Image est un modèle d'image à poids ouverts de MiniMax, publié le 10 novembre 2026, qui génère et modifie des images à environ 16 mégapixels (4096 x 4096) sans upscaler. Selon MiniMax, une image 4K prend environ 10 secondes. Vous pouvez l'appeler via l'API MiniMax, l'utiliser dans Hailuo AI et MiniMax Code, ou télécharger les poids depuis Hugging Face.
Ce guide explique ce qu'est MiniMax H3-Image, ce que MiniMax affirme réellement, ce que signifie « poids ouverts » selon sa licence, ce qu'il coûte pendant la remise de la semaine de lancement, et comment tester l'API depuis votre agent de code.
Qu'est-ce que MiniMax H3-Image ?
MiniMax H3-Image est un modèle de texte vers image et d'édition d'image de la famille MiniMax H3. Un seul checkpoint gère les deux tâches : il crée des images à partir d'une invite et modifie jusqu'à 16 images de référence. Il produit environ 16 mégapixels dans n'importe quel format, du 4096 x 4096 (1:1) au 6272 x 2688 (21:9), et ses poids sont publiés sous une licence communautaire.
Dans le post de lancement de MiniMax sur X, l'argumentaire est bref : « génération d'images 4K en 10 secondes », 16 millions de pixels, réalisme, suivi précis des invites et édition, jusqu'à 16 images de référence, et poids ouverts.
H3-Image est distinct du modèle de code de MiniMax, présenté dans l'explication de MiniMax M3, et dispose de ses propres points de terminaison API.
Ce que MiniMax affirme à propos de H3-Image
Voici ce que MiniMax publie sur la fiche du modèle sur Hugging Face et dans l'annonce. Considérez les affirmations de vitesse et de qualité comme des déclarations de MiniMax ; à la date de rédaction, personne en dehors de l'entreprise n'avait publié de mesures indépendantes.
| Affirmation | Ce que dit MiniMax | Source |
|---|---|---|
| Résolution | Environ 16 MP, 4096 x 4096 en 1:1, jusqu'à 6272 x 2688 en 21:9, sans upscaler | Fiche du modèle |
| Vitesse | Une image 4K en environ 10 secondes | Post de lancement |
| Échantillonnage | Distillé en 6 étapes d'échantillonnage, sans classifier-free guidance | Fiche du modèle |
| Références | Jusqu'à 16 images de référence par édition | Fiche du modèle, guide API |
| Suivi des instructions | « Le meilleur suivi d'instructions parmi les modèles open source » | Fiche du modèle |
| Plage de fonctionnement | Environ 4 MP à 20 MP, meilleurs résultats autour de 16 MP | Fiche du modèle |
L'affirmation de vitesse repose sur 6 étapes distillées et l'absence de classifier-free guidance, qui double normalement le travail par étape. MiniMax ne précise pas le matériel derrière le chiffre de 10 secondes, donc ne le considérez pas comme une promesse pour votre propre GPU.
La fiche du modèle ne publie aucun tableau de référence à l'appui de l'affirmation sur le suivi des instructions. Notre article complémentaire, MiniMax H3-Image vs Nano Banana 2.1, compare les deux modèles côte à côte.
Ce qu'il y a dans le modèle
La fiche du modèle est étonnamment précise sur l'architecture :
- Transformer de diffusion : 33,1 milliards de paramètres, un transformer dense à flux unique de 50 couches, stocké en BF16 (68,65 Go).
- Encodeur de texte : l'encodeur de texte MiniMax-H3, inchangé, chargé depuis le dépôt séparé MiniMax-H3 (66,7 Go).
- VAE d'image : sous-échantillonnage spatial 16x et 24 canaux latents (2,34 Go).
- Expander d'invite optionnel : MiniMax-H3-Image-PE (17,9 Go, NVFP4), qui transforme une invite courte en description anglaise détaillée attendue par le modèle.
En additionnant, une installation locale complète télécharge environ 137 Go, sans compter l'expander optionnel.
Ce que « poids ouverts » signifie pour MiniMax H3-Image
MiniMax H3-Image est un modèle à poids ouverts, pas open-source au sens de l'OSI. Vous pouvez télécharger et exécuter les poids, mais la MiniMax-H3-Image Community License impose de réelles limites. Lisez-la avant de construire dessus. Les points qui concernent la plupart des équipes :
- Territoire. La licence accorde des droits dans le monde entier, sauf dans les « territoires exclus » : l'Union européenne, le Royaume-Uni, la République de Corée et les États-Unis. Les équipes basées là-bas doivent contacter MiniMax au sujet d'une licence distincte.
- Revenus et hébergement. Vous avez besoin d'une autorisation écrite préalable de MiniMax si vous et vos filiales réalisez plus d'un million de dollars de revenus annualisés, ou si vous proposez le modèle en tant que service hébergé à des tiers. Les demandes passent par la console de licences de MiniMax.
- Attribution. Les produits commerciaux doivent afficher « MiniMax-H3-Image » de manière bien visible dans l'interface utilisateur.
- Pas d'entraînement d'autres modèles. Vous ne pouvez pas utiliser le modèle ni ses sorties pour améliorer un autre modèle d'IA.
- Divulgation. La politique d'utilisation acceptable interdit de publier publiquement du contenu généré sans indiquer clairement qu'il est généré par une machine.
MiniMax ne revendique aucun droit sur les images que vous générez. Si vous utilisez uniquement l'API hébergée, lisez également les conditions de la plateforme de MiniMax pour cet usage.
Où utiliser MiniMax H3-Image
Vous disposez de quatre voies d'accès :
- API MiniMax. Texte vers image sur
POST https://api.minimax.io/v1/images/generationset édition sur/v1/images/edits, tous deux avec l'ID de modèleMiniMax-H3-Imageou le plus rapideMiniMax-H3-Image-Highspeed. Le guide complet se trouve dans notre guide de l'API MiniMax H3-Image. - Hailuo AI. L'application web de MiniMax, sans code nécessaire.
- MiniMax Code. L'application de bureau de MiniMax pour macOS et Windows, citée dans le post de lancement comme lieu d'utilisation de H3-Image.
- Auto-hébergement. MiniMax recommande SGLang, vLLM-Omni, diffusers ou ComfyUI, et cite les NVIDIA H200, RTX PRO 6000 Blackwell et AMD Instinct MI350X parmi les accélérateurs pris en charge. La fiche du modèle n'indique pas de VRAM minimale.
Si vous cherchez des accès gratuits, l'article MiniMax H3-Image gratuitement les présente.
Comment fonctionne l'API MiniMax H3-Image
L'API suit la structure d'images de type OpenAI, la requête est donc courte :
curl https://api.minimax.io/v1/images/generations \
-H "Authorization: Bearer $MINIMAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3-Image",
"prompt": "An orange cat on a sunny windowsill, film texture",
"aspect_ratio": "16:9",
"area": "4K",
"response_format": "url"
}'
Les paramètres à connaître, d'après la référence API :
sizeaccepteLARGExHAUTEUR(655 360 à 20 000 000 pixels, format entre 1:3 et 3:1) ouauto. Avecauto, vous définissez plutôtaspect_ratioetarea(1K,2Kou4K, valeur par défaut4K). Mélanger les deux formes renvoie une erreur 400.npermet de demander de 1 à 10 images par requête.output_formatvautjpegpar défaut, oupngouwebp.response_formatvauturl(téléchargez-la vous-même, car l'URL n'est pas garantie de persister) oub64_json.stream: truepousse chaque image via des événements envoyés par le serveur dès qu'elle est terminée.- L'amélioration d'invite est activée par défaut. Chaque résultat contient un
revised_promptmontrant ce que le modèle a réellement utilisé. Définissezdisable_prompt_enhanced: truepour envoyer votre invite telle quelle.
Un comportement piège beaucoup de monde : si au moins une image réussit, l'appel renvoie un HTTP 200 même si d'autres ont échoué au contrôle de sécurité du contenu. Vérifiez data[].error sur chaque élément. Seules les images réussies sont facturées.
Le guide liste aussi ce qui n'est pas pris en charge : les images d'aperçu, les éditions masquées et les fonds transparents.
Pour l'édition, vous fournissez 1 à 16 images de référence sous forme d'URL publiques, d'ID de fichiers téléversés ou d'URIs de données, jusqu'à 64 Mio au total par requête. Votre invite s'y réfère via <Picture 1>, <Picture 2>, etc., dans l'ordre de téléversement.
Tarification de MiniMax H3-Image et remise de la semaine de lancement
MiniMax facture H3-Image au million de jetons, répartis entre texte en entrée, image en entrée et image en sortie. D'après la page de tarification de MiniMax, consultée le 11 novembre 2026 :
| Modèle | Texte en entrée / M jetons | Image en entrée / M jetons | Image en sortie / M jetons |
|---|---|---|---|
| MiniMax-H3-Image | 2,30 $ | 1,50 $ | 3,80 $ |
| MiniMax-H3-Image-Highspeed | 2,30 $ | 3,00 $ | 7,60 $ |
Les exemples de coût par résultat de texte vers image sur le modèle standard donnés par MiniMax sont de 0,02179 $ en 1K, 0,02333 $ en 2K et 0,06879 $ en 4K. L'exemple Highspeed 4K coûte 0,13001 $.
La remise de lancement est de 50 % sur le coût total de la requête pour les deux modèles lorsque l'image livrée compte au moins 16 600 000 pixels. Elle court jusqu'au 17 novembre 2026 à 16 h 00 UTC. Pendant cette période, MiniMax affiche un résultat standard 4K de texte vers image à 0,03439 $ et une version Highspeed à 0,06501 $. Les images plus petites ne sont pas éligibles : un rendu 2K coûte donc le même prix qu'avant.
Tester l'API MiniMax H3-Image avec Apidog CLI
Avant d'intégrer H3-Image dans une application, vérifiez que la forme de votre requête, l'authentification et la gestion des erreurs fonctionnent, y compris le cas « 200 avec un élément en échec ». Laissez votre agent de code construire et exécuter cette vérification avec l'Apidog CLI plutôt que de cliquer manuellement sur les requêtes.
![Workflow diagram: a coding agent uses Apidog CLI to create an endpoint and test case, calls POST /v1/images/generations on MiniMax H3-Image, reads a test report checking status 200, data[0].url and no data[].error, then fixes and reruns](https://assets.apidog.com/blog-next/2026/11/minimax-h3-apidog-loop.png)
Configurez le CLI une seule fois :
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install
La skill apprend à votre agent (Claude Code, Codex, Cursor ou autre) les commandes du CLI. Donnez-lui ensuite une seule invite :
In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.
L'agent transforme cela en une courte série de commandes apidog. Tous les drapeaux ci-dessous proviennent de apidog <command> --help sur Apidog CLI 2.2.12 :
apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
--env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json
cli-schema get fournit à l'agent la forme JSON exacte, et cli-schema validate vérifie chaque fichier avant toute écriture. test-case category lui donne un ID de catégorie valide pour que le cas apparaisse dans l'application. L'exécution affiche un résumé des réussites et échecs dans votre terminal et écrit un rapport JSON que l'agent lit pour décider quoi corriger. Ajoutez --upload-report pour visualiser la même exécution dans Apidog.
L'utilisation de area: 1K maintient chaque appel de test au plus bas prix d'exemple listé par MiniMax. Pour en savoir plus sur ce modèle de travail, consultez le flux de travail de l'agent Apidog CLI et Apidog CLI dans Claude Code. Le plan Gratuit d'Apidog couvre jusqu'à 4 utilisateurs.
Faut-il essayer MiniMax H3-Image ?
Essayez-le si vous avez besoin d'images grandes et détaillées et souhaitez une option à poids ouverts, ou si l'édition multi-références (photos de produits, aménagements d'intérieur, fiches de personnages) correspond à votre cas d'usage. La remise de lancement rend les tests 4K bon marché jusqu'au 17 novembre.
Réfléchissez à deux fois avant l'auto-hébergement : environ 137 Go de poids, des GPU de datacenter et une licence qui exclut l'UE, le Royaume-Uni, la République de Corée et les États-Unis. Pour la plupart des équipes, l'API est la voie pratique. Si vous comparez les API d'images, nos guides sur l'API GPT Image 2.6, l'API Nano Banana 2.1 et Qwen-Image 2.1 couvrent les alternatives.
FAQ
MiniMax H3-Image est-il gratuit ? Les poids sont libres de redevances à télécharger et à exécuter dans les territoires couverts par la licence, sous ses limites de revenus et d'hébergement. L'API est payante au jeton. Consultez notre guide d'accès gratuit pour les accès sans coût.
MiniMax H3-Image est-il open-source ? MiniMax le qualifie d'open-source sur Hugging Face, mais il est distribué sous une licence communautaire personnalisée avec des restrictions de territoire, de revenus, d'attribution et d'entraînement. « Poids ouverts » est le terme le plus exact.
Quelle est la vitesse de MiniMax H3-Image ? MiniMax indique qu'une image 4K prend environ 10 secondes. C'est le chiffre de l'entreprise ; elle ne précise pas le matériel utilisé, et aucun benchmark indépendant n'existait à la date de rédaction.
Quelle est la différence entre MiniMax-H3-Image et MiniMax-H3-Image-Highspeed ? Les deux acceptent les mêmes paramètres et limites. Highspeed est le palier plus rapide et plus cher : 7,60 $ par million de jetons d'image en sortie contre 3,80 $.
Combien d'images de référence MiniMax H3-Image peut-il utiliser ? Jusqu'à 16 par requête d'édition, chacune de 128 à 8 192 pixels par côté, avec un corps de requête limité à 64 Mio au total.
Quand se termine la remise de lancement de MiniMax H3-Image ? Le 17 novembre 2026 à 16 h 00 UTC. Elle s'applique uniquement aux images d'au moins 16 600 000 pixels.