MiniMax H3 Image API
Le modèle d’image à poids ouverts de MiniMax : 4K natif jusqu’à 17 mégapixels, et retouches à partir de 16 images de référence
- 1K
- KIE 0,0115 $ / image
- Officiel
≈0,0312 $63 %–72 % de moins - 2K
- KIE 0,0115 $ / image
- Officiel
≈0,0328 $65 %–72 % de moins - 4K
- KIE 0,03 $ / image
- Officiel
≈0,0782 $62 %–69 % de moins
Tarifs de l’API MiniMax H3 Image par image
KIE facture un prix fixe par niveau, environ 40 % du tarif public de MiniMax, plus $0.0025 par image de référence. Le prix officiel est une estimation au token et n’inclut pas la remise de 50 % sur le 4K de la semaine de lancement
Routage automatique et basculement
Appelez MiniMax H3 Image avec un seul ID de modèle : Yir choisit le canal de chaque tâche parmi MiniMax et KIE. La tâche part vers le canal éligible au prix estimé le plus bas et est facturée au prix public de ce canal, sans majoration. Si une tentative échoue, elle est relancée sur un autre canal sans dépasser votre max_cost. Aucun paramètre de routage n'est nécessaire dans votre requête. Documentation du routage et du basculement
Notes sur les prix
Facturé par le fournisseur qui exécute réellement la tâche. Un basculement peut changer de fournisseur, ce qui peut modifier le coût et la durée.
Du 4K natif, poids ouverts à l’appui
Des poids ouverts qui tiennent sur une carte de 16 Go
Les poids sont sur Hugging Face ; un testeur a généré des images de 16 MP sur une seule RTX 5080 de 16 Go, le reste étant chargé depuis la mémoire système
Meilleure note en texte et design
Un test indépendant de 600 prompts à 16 MP a obtenu 3,94 sur 5 en moyenne avec un correcteur IA
- Texte et design
- 4.36
- Personnes
- 4.22
- Commercial
- 3.56
- Infographie
- 3.56
Exemples de générations
Chaque image ici a été générée par MiniMax H3 Image. Ouvrez-en une pour essayer son prompt d’origine dans le playground
Recadrée à 100 %, l’image tient toujours
Chaque vignette est un recadrage 1:1 d’un original 4K ci-dessus, soit environ 7 % de l’image
Étiquettes d’épices manuscrites
Mains burinées sur le filet
Gouttes de rosée sur la toile
Sur l’échelle de la bibliothèque
Utiliser l’API
Confiez le code à un agent, générez directement dans la conversation avec MCP ou la Skill, ou intégrez vous-même avec le SDK ou l’API compatible OpenAI.
Confiez l’intégration à un agent de code
Copiez le prompt d’intégration, ou ouvrez-le directement dans Codex ou Claude. L’agent lit cette page et le contrat du modèle, puis écrit dans votre projet l’envoi, l’attente et la gestion des résultats.
Ajouter le serveur MCP Yir
Connectez-le à ChatGPT, Claude ou Cursor, mentionnez @Yir et demandez MiniMax H3 Image par son nom. Il annonce d’abord le prix et ne génère qu’après votre confirmation.
https://gateway.yir.ai/mcpUne commande pour Claude Code
Créez une clé API dans la console, définissez-la comme YIR_API_KEY, puis lancez :
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Installer la Skill Yir
Définissez YIR_API_KEY là où tourne votre agent, ajoutez la Skill à Claude Code, Codex ou un autre agent de code, puis dites « utilise MiniMax H3 Image sur Yir pour créer… ».
npx skills add yir-ai/skillsInstallez le SDK officiel avec votre gestionnaire de paquets, ou copiez l’extrait de code ci-dessous pour commencer
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lit YIR_API_KEY depuis l’environnement par défaut: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Soumettre une tâche de génération d’image |
| const job = await client.submitImage({ |
| model: "minimax/minimax-h3-image", |
| input: { |
| type: "text", |
| prompt: "Crée une affiche produit pour une eau pétillante aux agrumes : une bouteille en verre transparent et des oranges fraîches, fond crème, lumière naturelle douce et étiquette produit nette", |
| }, |
| parameters: { |
| resolution: "4K", |
| aspect_ratio: "1:1", |
| n: 1, |
| }, |
| }); |
| // 2. Attendre la fin de la tâche et la livraison du résultat |
| const result = await client.waitForJob(job.id); |
| console.log("Fichiers livrés :", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Les projets qui utilisent déjà le protocole OpenAI, ou les passerelles comme new-api, n’ont besoin que d’une nouvelle Base URL et d’une nouvelle clé. Guide de compatibilité OpenAI
- base_url du SDK OpenAI
https://gateway.yir.ai/openai/v1- Base URL du canal new-api
https://gateway.yir.ai/openai- Clé
- API Key Yir
- ID du modèle
minimax/minimax-h3-image
curl https://gateway.yir.ai/openai/v1/images/generations \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax/minimax-h3-image",
"prompt": "Crée une affiche produit pour une eau pétillante aux agrumes : une bouteille en verre transparent et des oranges fraîches, fond crème, lumière naturelle douce et étiquette produit nette",
"resolution": "4K",
"aspect_ratio": "1:1"
}'Aperçu des paramètres
Paramètres courants ; les limites dépendent du modèle actuel et du fournisseur sélectionné
- Résolution resolution
- 1K
- 2K
- 4K
Niveau de résolution de sortie. Plus la résolution est élevée, plus l’image est nette et plus le prix augmente
- Format d’image aspect_ratio
- 1:1
- 2:3
- 3:2
- 3:4
- 4:3
- 4:5
- 5:4
- 9:16
- 16:9
- 21:9
Rapport largeur/hauteur. Choisissez-le selon le support visé (portrait, bannière ou carré)
- Mode d’entrée input_mode
- Entrée texte
- Entrée image
Les limites et formats des références dépendent du modèle et du fournisseur sélectionné
- Références references
- reference_image ≤ 16
Les limites par mode dépendent du fournisseur choisi. Les quantités du tableau sont des exemples de prix, pas des limites ni des quotas gratuits.
