API MiniMax H3 Image : génération, édition et tarifs réels

Prix du même modèle selon les fournisseurs: Cheap MiniMax H3 Image API · 2026-11-13

Capacités de MiniMax H3 Image et limites de l'API hébergée

La raison la plus solide d'évaluer H3 Image est son workflow unifié de génération et d'édition : décrivez un nouvel élément, fournissez des références de produit ou de personnage, puis demandez une modification ciblée. MiniMax publie également les poids pour un déploiement local. Les capacités publiées ne garantissent pas une préservation exacte des logos, de la typographie ou de l'identité dans chaque sortie.

Fonctionnalité de l'API hébergée	Contrat documenté
Génération	POST /v1/images/generations
Édition	POST /v1/images/edits, 1 à 16 images de référence
Prompt	Jusqu'à 32 000 caractères ; sans amélioration, seuls environ les 4 096 premiers jetons prennent effet
Dimensions de sortie	655 360 à 20 000 000 pixels ; ratio d'aspect de 1:3 à 3:1
Nombre de sorties	n de 1 à 10
Formats	JPEG par défaut ; PNG ou WebP pris en charge
Réponses	URL ou Base64 non-streaming ; SSE natif pris en charge
Contrôles non pris en charge	Édition avec masque, arrière-plans transparents et images d'aperçu

Les fichiers de référence doivent respecter les limites d'entrée de MiniMax : JPG/JPEG, PNG, WebP, HEIC ou HEIF, chaque dimension entre 128 et 8 192 pixels, ratio long sur court d'au plus 4:1, et corps de requête total d'au plus 64 MiB. Le Base64 augmente la taille de la requête. Utilisez des URL d'images accessibles ou des uploads de taille appropriée ; la capacité du modèle à accepter 16 images ne supprime pas la limite de taille du corps.

« 4K » est un réglage de surface dans cette API. area: "4K" cible environ 4096 × 4096 pixels, avec des dimensions dérivées du ratio d'aspect. En 16:9, la sortie documentée est 5472 × 3072, et non 4096 × 2304. Pour des dimensions explicites, envoyez size: "WIDTHxHEIGHT" et omettez area et aspect_ratio. Pour un dimensionnement par surface, utilisez size: "auto", area et aspect_ratio. Vérifiez data[].size et les dimensions réelles de l'image téléchargée.

Combien coûte MiniMax H3 Image ?

Pour la route Standard actuelle d'APIMaster, le calcul au tarif standard est le suivant :

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

Utilisez des champs d'usage texte et image distincts ; ne facturez pas tous les jetons d'entrée comme du texte et n'ajoutez pas ensuite l'entrée image de nouveau. L'amélioration du prompt génère des jetons texte facturés, donc la résolution seule ne détermine pas le prix total. Les coefficients propres à chaque compte, le cas échéant, et l'arrondi de facturation peuvent affecter le débit final.

Les totaux Standard illustratifs officiels de MiniMax donnent l'ordre de grandeur de la facture. Ce sont des exemples, et non des tarifs fixes APIMaster ni notre moyenne mesurée :

Tâche	1K : 1024 × 1024	2K : 2048 × 2048	4K : 4096 × 4096, tarif standard
Texte-vers-image	0,02179 $	0,02333 $	0,06879 $
Édition avec une référence 1K	0,02654 $	0,02658 $	0,07312 $
Édition avec trois références 1K	0,03563 $	0,04177 $	0,07914 $

À titre de contexte, 1 000 requêtes texte-vers-image au premier exemple représenteraient environ 21,79 $ ; il s'agit d'un calcul illustratif de budget de jetons, et non d'un forfait prépayé. Les prompts et l'amélioration réels peuvent le modifier. Nano Banana 2.1 a un contrat APIMaster différent, basé sur la résolution, à partir de 15,12 $ pour 1 000 images 1K avant toute condition citée séparément.

La promotion officielle de 50 % sur la 4K s'applique-t-elle sur APIMaster ?

Ne le supposez pas. MiniMax annonce 50 % de réduction sur le coût total de la requête pour Standard et Highspeed jusqu'au 17 novembre 2026, 16:00 UTC exclu — soit le 18 novembre à 00:00 heure de Pékin — lorsque l'image finale livrée compte au moins 16 600 000 pixels. Son exemple carré 4K texte-vers-image passe de 0,06879 $ à 0,03439 $ pendant cette offre.

Une sortie 4096 × 4096 est éligible par sa surface ; 4096 × 2304 ne l'est pas. Une étiquette « 4K » seule ne suffit pas. La route publique actuelle d'APIMaster applique les tarifs de jetons standards, sans cette promotion temporaire. Comparez le contrat réel de paiement/usage, et non le titre de campagne de MiniMax. Après la date limite, les exemples promotionnels ne doivent pas être utilisés comme prix actuels.

Exemple d'API MiniMax H3 Image : texte-vers-image

Créez un compte APIMaster, ajoutez du solde pour les requêtes d'image payantes, puis créez une clé dans Clés API. Définissez APIMASTER_API_KEY dans votre environnement. Cet exemple utilise l'ID de modèle exact et sensible à la casse de la route Standard :

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

Ceci est un exemple de requête, et non un benchmark de qualité d'image. Téléchargez rapidement les URL de sortie réussies et stockez les fichiers vous-même. Vérifiez les erreurs par image : avec n > 1, un HTTP 200 peut inclure des images en échec. Un timeout ne prouve pas qu'une requête a été rejetée. La génération H3 n'est pas idempotente, donc une nouvelle tentative automatique peut créer une autre génération payante. Si vous utilisez le SDK OpenAI, définissez un timeout suffisamment long et max_retries=0.

Édition avec MiniMax H3 Image : images de référence et contrôle du prompt

Pour l'édition JSON, envoyez les URL de référence dans images[].image_url. Ne copiez pas le champ image_urls de Nano Banana dans cette requête H3. Remplacez les URL d'exemple par vos propres ressources accessibles :

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

Les contrôles d'acceptation de l'intégration APIMaster existante du 11 novembre couvraient les références HTTP, les URI de données, les uploads multipart, l'édition multi-références, le SSE et les sorties décodées 1K/2K/4K. Un test contrôlé à deux références a conservé quatre formes colorées et deux courtes étiquettes. Il s'agissait de contrôles d'interface et de facturation avec des ressources simples, et non d'une large évaluation photographique ou typographique ; ils n'établissent pas une supériorité sur un autre modèle.

La génération utilise l'amélioration du prompt par défaut ; vous pouvez la désactiver avec disable_prompt_enhanced: true tout en fournissant des dimensions fixes ou un ratio d'aspect fixe. Les éditions utilisent toujours l'amélioration. Inspectez revised_prompt lors du diagnostic de changements inattendus. Pour un travail produit, précisez ce qui doit rester fixe, identifiez le rôle de chaque référence et vérifiez l'étiquette rendue avant publication.

Standard vs Highspeed, et poids ouverts vs API hébergée

Highspeed utilise les mêmes paramètres d'API documentés, mais ses tarifs officiels d'entrée image et de sortie image sont le double de ceux de Standard ; l'entrée texte reste à 2,30 $/M. APIMaster ne liste actuellement que Standard. Les affirmations de vitesse au lancement de MiniMax dépendent de la variante du modèle, de la taille et du déploiement, et ne constituent pas une garantie de latence mesurée par APIMaster.

Le dépôt officiel Hugging Face fournit les poids et des intégrations incluant Diffusers, SGLang, vLLM-Omni et ComfyUI. Son checkpoint BF16 fait environ 68,65 Go, avec un encodeur texte séparé d'environ 66,7 Go. La taille de téléchargement n'est pas une estimation complète de la mémoire GPU. Les poids locaux utilisent la licence communautaire MiniMax H3 Image, alors examinez cette licence avant tout déploiement ; « poids ouverts » ne signifie pas un usage sans restriction sous MIT ou Apache.

Utilisez l'accès hébergé pour évaluer des prompts sans construire d'infrastructure d'inférence. Envisagez un déploiement local lorsque le contrôle sur l'inférence justifie le travail GPU, la maintenance et les licences. Les limites de pipeline local et les limites de l'API hébergée sont des contrats différents.

FAQ

MiniMax H3 Image est-il identique à MiniMax H3 vidéo ?

Non. H3 Image génère et édite des images fixes via MiniMax-H3-Image. La famille vidéo H3 a des ID de modèles, des endpoints et une facturation différents. Consultez le guide vidéo MiniMax H3 séparé.

MiniMax H3 Image est-il disponible sur APIMaster ?

Oui. La vérification du 13 novembre a trouvé une route publique Standard activée, facturée à 2,30 $/M en entrée texte, 1,50 $/M en entrée image et 3,80 $/M en sortie image. Highspeed n'avait aucune route publique. Vérifiez la fiche live du modèle avant d'envoyer des requêtes.

H3 Image est-il une API à 0,02 $ fixe par image ?

Non. Les exemples officiels par image sont des totaux illustratifs. L'usage réel des jetons, l'amélioration du prompt, les entrées de référence et les dimensions de sortie déterminent la facture. La route APIMaster actuelle utilise la formule standard par jetons.

H3 Image peut-il éditer avec 16 références ou un masque ?

Il documente jusqu'à 16 images de référence dans les limites de format et de taille de requête. L'édition avec masque et les arrière-plans transparents ne sont pas pris en charge. Les instructions basées sur des références ne garantissent pas une préservation exacte au pixel.

Lequel est le moins cher : H3 Image ou Nano Banana 2.1 ?

Pour la tâche illustrée texte-vers-image 1K, l'exemple officiel standard de H3 est de 0,02179 $, contre Nano Banana 2.1 sur APIMaster à partir de 0,01512 $ par image 1K. Cela compare un total de jetons illustratif à un devis par résolution ; mesurez le coût réel des sorties acceptées pour vos prompts. Consultez la comparaison dédiée.

Sources et prochaines étapes

Sources vérifiées le 13 novembre 2026 : annonce MiniMax, guide de l'API hébergée, tarifs et promotion officiels, poids et licence du modèle, tarifs d'image Google, et les fiches live du marketplace APIMaster. Les descriptions de capacités proviennent de leurs fournisseurs respectifs ; les vérifications de prix et les observations datées de l'intégration APIMaster sont identifiées séparément.

Ouvrez la fiche H3 Image, inscrivez-vous, créez une clé API et envoyez MiniMax-H3-Image à https://apimaster.ai/v1. Pour une alternative remisée avec un contrat de facturation différent, comparez les routes Nano Banana 2.1, actuellement jusqu'à 55 % en dessous de la référence de sortie image de Google.