MiniMax H3-Image promet de générer des images de classe 4096 × 4096 en 10,3 secondes P50 avec Highspeed, ou 16,0 secondes avec Standard, d’après le graphique de latence de MiniMax. Pour du text-to-image 4K pur, son exemple tarifaire Standard ($0.06879) est moins cher que le tarif hébergé tiers cité ici (WaveSpeed : $0.03 par image en 1K/2K, $0.09 en 4K). Highspeed ($0.13001), lui, coûte davantage. En revanche, pour l’édition à partir de plusieurs références avec conservation fidèle de l’identité, les retours d’utilisateurs liés invitent à regarder ailleurs.
Environ 10 secondes en 4K, mais des retouches encore décevantes
H3-Image est un nouveau modèle d’image à poids ouverts dérivé de MiniMax H3 vidéo. Il couvre le text-to-image, la génération à partir de références et l’édition, accepte jusqu’à 16 images de référence et peut renvoyer jusqu’à 10 images par requête. Ses paliers de surface 1K/2K/4K visent respectivement 1,048,576 / 4,194,304 / 16,777,216 pixels. Le serveur calcule la largeur et la hauteur exactes depuis le ratio, puis les renvoie dans data[].size : la 4K désigne donc une surface cible, pas nécessairement un carré strict de 4096×4096.
Les chiffres P50 annoncés par MiniMax sont solides, même si la comparaison en 4K reste limitée. Le graphique de latence P50 de MiniMax indique 7,7 s en 1K et 10,3 s en 4K pour le text-to-image Highspeed, contre 10,6 s et 16,0 s avec Standard. En 4K, le graphique ne le confronte qu’à Nano Banana 2.1, à 50–51 s : l’affirmation « 5x faster than mainstream » repose donc sur un échantillon étroit.
Dans les fils Reddit liés, les commentateurs confirment la rapidité en T2I, mais relèvent deux faiblesses récurrentes : la perte de ressemblance avec les références et un rendu peu détaillé malgré la haute résolution annoncée.
« Malheureusement, il est très mauvais comme modèle ref2i comparé au véritable modèle H3 vidéo pour le ref2i » — u/Omegapepper sur r/StableDiffusion
« Certains vont peut-être m’en vouloir, mais d’après mes tests, il est nettement inférieur à QI 2.1 [...] pour l’édition à partir de plusieurs références. » — u/Crazy-Repeat-2006 sur r/StableDiffusion
Dans le fil consacré aux tailles recommandées, des testeurs signalent un manque de piqué et du flou à basse résolution, y compris sur des sorties censées être nettes. Ils débattent aussi de la présence réelle de détails à haute fréquence dans la résolution revendiquée. Ce sont des retours anecdotiques précoces, pas un benchmark contrôlé, mais ils vont tous dans le même sens.
Ce que l’API propose réellement : deux modèles, deux endpoints et une étape d’expansion
La documentation API de MiniMax présente deux identifiants de modèle, deux endpoints d’image, ainsi qu’une étape d’expansion de prompt.
| Élément | MiniMax-H3-Image (Standard) | MiniMax-H3-Image-Highspeed |
|---|---|---|
| Objectif | Coût minimal par image | Latence minimale |
| Entrée texte | $2.30 / 1M tokens | $2.30 / 1M tokens |
| Entrée image | $1.50 / 1M tokens | $3.00 / 1M tokens |
| Sortie image | $3.80 / 1M tokens | $7.60 / 1M tokens |
Endpoints (hôte Global ci-dessous ; les comptes chinois utilisent l’endpoint Chine indiqué dans la même documentation) :
POST https://api.minimax.io/v1/images/generations— text-to-image ; les paramètres vérifiés comprennentmodel,prompt(32 000 caractères max.),disable_prompt_enhanced(false par défaut),n(1–10),size(autoouWIDTHxHEIGHT),aspect_ratio,area(1K/2K/4K,4Kpar défaut),output_format(jpeg par défaut),response_format(url/b64_json),stream,output_compression.POST /v1/images/edits— édition avec 1 à 16 références ; les références acceptent les formats JPG/PNG/WebP/HEIC/HEIF, avec 128 à 8192 px par côté.H3-Image-Context-IR— étape d’expansion de prompt (et non endpoint d’image), qui reformule un prompt court et sélectionne un ratio.
Exemple directement copiable (hôte Global) :
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":"...","size":"auto","aspect_ratio":"16:9","area":"2K","disable_prompt_enhanced":false,"response_format":"url"}'La documentation précise que les requêtes ne sont pas idempotentes, que le serveur peut prendre jusqu’à 600 secondes, que la génération continue après un timeout ou une déconnexion côté client, qu’une image terminée reste facturée et que seules les images réussies sont facturées (usage compte les succès). MiniMax recommande max_retries=0 avec le SDK OpenAI. Un succès partiel renvoie un HTTP 200 avec des entrées data[].error par image, notamment pour les échecs liés à la sûreté du contenu : inspectez donc chaque élément. Seuls les lots entièrement échoués renvoient un 4xx/5xx. Considérez la plupart des 4xx comme des erreurs de configuration définitives, ne renvoyez jamais une requête après un timeout ambigu et, chez les fournisseurs asynchrones, interrogez le job existant au lieu d’en soumettre un autre.
L’amélioration de prompt est activée par défaut. Elle peut être désactivée pour le text-to-image, mais pas pour les retouches, et l’API renvoie le prompt réécrit dans data[].revised_prompt. Journalisez-le et comparez-le au prompt envoyé avant de modifier quoi que ce soit d’autre. Attention aux limites lorsque l’améliorateur est désactivé : le modèle ne lit alors qu’environ les 4 096 premiers tokens, et vous devez fournir une taille exacte ou un ratio explicite.
L’auto-hébergement ne se résume pas à 10 secondes : poids, VRAM et licence
Les poids sont disponibles sur Hugging Face MiniMaxAI/MiniMax-H3-Image et GitHub MiniMax-AI/MiniMax-H3-Image, avec des poids convertis pour ComfyUI et un modèle de workflow image_minimax_h3_image_t2i.json. La fiche du modèle indique un transformeur de diffusion de 33.1B paramètres, un checkpoint BF16 de 68.65 Go et un encodeur de texte H3 séparé de 66.7 Go, soit environ 135 Go avant même l’expanseur de prompt optionnel de 17.9 Go. Elle fixe le serveur local à 6 étapes d’inférence avec une guidance scale de 1 ; toute autre valeur y renvoie une erreur HTTP 400. Les prompts négatifs ne sont pas pris en charge.
Ne prévoyez pas 10 secondes sur une carte gaming. Dans les discussions ComfyUI, certains se demandent si le modèle tient sur une 5090, même en quantification 4 bits. Dans le fil sur les poids ouverts lié, un utilisateur de RTX 5090 annonce environ 21 secondes pour 16 MP en INT8, avec un rendu granuleux, et indique qu’il faut passer en BF16 pour obtenir de la netteté, au prix d’un temps plus long. Dans le fil ComfyUI, un utilisateur de RTX 3070 Ti juge le T2I rapide pour des sorties 16 MP, mais explique que l’édition avec référence ignorait le prompt. Cela reste un retour isolé, pas la preuve qu’une quantification agressive convient au travail sur références.
Pour de nombreuses équipes, la licence compte davantage que la VRAM. La fiche du modèle applique le MiniMax-H3-Image Community License Agreement daté du November 10, 2026 : la licence par défaut exclut les États-Unis, l’Union européenne, le Royaume-Uni et la République de Corée ; elle requiert une autorisation écrite préalable au-delà de $1M de revenus annualisés ou pour les services hébergés destinés à des tiers ; les interfaces commerciales doivent afficher « MiniMax-H3-Image ». Les équipes basées aux États-Unis ou dans l’UE doivent clarifier la licence avant tout auto-hébergement.
Combien coûte une image en 1K, 2K ou 4K : les exemples MiniMax
Tous les montants ci-dessous sont des exemples de coûts fournis par MiniMax, et non des prix fixes : la facturation repose sur les tokens, donc la longueur du prompt et le nombre de références font varier le total. Les exemples supposent des images de référence en 1K lorsqu’il y en a.
| Tâche | Exemple Standard | Exemple Highspeed |
|---|---|---|
| T2I, surface 1K | $0.02179 | $0.03529 |
| T2I, surface 2K | $0.02333 | $0.03622 |
| T2I, surface 4K | $0.06879 ($0.03439 promo) | $0.13001 ($0.06501 promo) |
| Édition 4K + 1 réf. | $0.07312 ($0.03656 promo) | $0.13673 ($0.06837 promo) |
| Édition 4K + 3 réf. | $0.07914 ($0.03957 promo) | $0.15407 ($0.07703 promo) |
Trois points permettent de réduire la facture. D’abord, la 2K coûte presque autant que la 1K ($0.02333 contre $0.02179) pour 4x plus de pixels cibles : choisissez la 2K plutôt que la 1K lorsque les deux conviennent. Ensuite, la 4K représente 16x les pixels de la 1K pour environ 3,2x son prix d’exemple ; la 4K native est donc efficace si vous avez besoin de détails pour l’impression. Enfin, la promotion de lancement divise par deux la 4K éligible, à $0.03439 en Standard jusqu’au November 17, 2026 à 16:00 UTC, pour les sorties d’au moins 16,600,000 pixels.
Highspeed double à peu près les tarifs de tokens image pour gagner 3 à 7 secondes. En T2I 4K, cela donne $0.13001 contre $0.06879, soit 1.89x. Sauf si vous générez des catalogues en lot avec un SLO de latence, Standard est le meilleur choix. Chaque référence supplémentaire ajoute des tokens d’entrée image : une édition 4K avec 3 références coûte donc environ 8 % de plus qu’avec une seule référence, avant même de tenir compte de la qualité.
Faut-il appeler cette API, ou choisir Qwen, Krea ou H3 vidéo ?
Pour de la génération text-to-image en volume et en haute résolution, H3-Image est attractif au regard des exemples publiés par MiniMax en matière de prix et de latence. Si votre priorité est la préservation de l’identité, évaluez les alternatives ci-dessous avant de vous engager.
| Cas d’usage | Choix | Pourquoi |
|---|---|---|
| Affiches, arrière-plans et paysages 4K T2I en volume | H3-Image Standard | Exemples à $0.023 en 2K et $0.069 en 4K ; 4K la plus rapide dans le graphique MiniMax |
| Lot sensible à la latence (publicités, aperçus en direct) | H3-Image Highspeed | 7,7 s en 1K à 10,3 s en 4K ; payez 1,9x pour gagner ~6 s |
| Cohérence d’un personnage ou produit sur plusieurs références | Qwen Image via Alibaba Cloud ou H3 vidéo ref2i | Les fils liés jugent H3-Image moins bon que QI 2.1 pour les retouches multi-références ; plusieurs utilisateurs conservent H3 vidéo pour le ref2i |
| Interface d’édition managée plutôt qu’API/auto-hébergement | Krea | Pas d’empreinte locale d’environ 135 Go ; une alternative d’interface, pas l’équivalent d’une API |
| Auto-hébergement avec 24GB ou moins | Attendre des builds prunés/INT4 | Le BF16 requiert aujourd’hui une VRAM de classe datacenter |
Lorsque la ressemblance est essentielle, l’avantage d’un coût par image inférieur disparaît vite dans les nouvelles tentatives.
Checklist de déploiement pour éviter les images floues et les factures inutiles
- Partez des préréglages 1K/2K et ne montez en 4K que pour les images retenues ; les testeurs signalent une 4K par défaut peu nette, vérifiez donc d’abord le piqué en 2K.
- Journalisez
revised_promptà chaque exécution et comparez-le à votre prompt envoyé avant tout autre changement. - Prévoyez des timeouts client supérieurs à 600 s, car le serveur peut prendre jusqu’à 600 s, désactivez les retries automatiques du SDK, conservez une clé de déduplication côté client uniquement pour la réconciliation et, chez les fournisseurs asynchrones, interrogez le job au lieu de refaire un POST.
- Gérez les entrées
data[].errorpar image dans les lots multi-sorties en HTTP 200 ; consultez la référence des edits pour l’enveloppe d’erreur avant de coder la boucle. - Validez la licence,
response_formatet le téléchargement des prompts : selon la documentation API, les réponsesurlne garantissent pas un stockage durable.
FAQ sur l’API MiniMax H3-Image
Quelle différence entre MiniMax H3-Image et MiniMax H3 ?
H3 est le modèle vidéo ; H3-Image est le modèle d’image fixe qui en dérive, conçu pour le text-to-image et l’édition sur des surfaces de classe 4K. Pour la cohérence entre référence et image, plusieurs utilisateurs des fils liés préfèrent encore H3 vidéo.
Quel est l’endpoint officiel et quel model ID utiliser ?
POST https://api.minimax.io/v1/images/generations avec model: MiniMax-H3-Image ou MiniMax-H3-Image-Highspeed, auxquels s’ajoutent /v1/images/edits et H3-Image-Context-IR pour l’expansion de prompt.
Peut-on désactiver l’amélioration de prompt ?
Oui pour le text-to-image, avec disable_prompt_enhanced: true, mais pas pour l’édition. L’API renvoie le prompt réécrit qu’elle a utilisé.
Puis-je exécuter H3-Image localement sur un GPU grand public ?
Seulement avec de la quantification et de la patience : comptez ~135 Go en BF16 avant l’expanseur de prompt. La fiche du modèle cite des accélérateurs de classe H200, RTX PRO 6000 et MI350X pour les recettes serveur.
Est-il utilisable commercialement ?
Uniquement après validation de la MiniMax-H3-Image Community License : la licence par défaut exclut les États-Unis, l’UE, le Royaume-Uni et la Corée, et exige une autorisation au-delà de $1M de revenus ou pour des services hébergés destinés à des tiers.