# MiniMax H3 Image

> 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

- Page du modèle: https://yir.ai/fr/models/minimax-h3-image
- ID du modèle: `minimax/minimax-h3-image`
- Facturation : selon le fournisseur qui a exécuté la tâche ; les tentatives non facturées en amont sont gratuites.

## 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

## Prix

Prix publics actuels par fournisseur pour la même spécification de sortie ; les prix officiels servent de référence. Vous êtes facturé par le fournisseur qui exécute réellement la tâche, qui peut changer en cas de basculement.

| Spécification de sortie | Fournisseur | Prix public |
|---|---|---|
| 1K | MiniMax (officiel) (Entrée texte) | ≈0,0218 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0312 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0406 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0501 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0595 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0689 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0783 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0877 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,0972 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,1066 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,116 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,1254 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,1348 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,1443 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,1537 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,1631 $ / image |
| 1K | MiniMax (officiel) (Entrée image) | ≈0,1725 $ / image |
| 1K | KIE | 0,009 $ ~ 0,0115 $ / image |
| 2K | MiniMax (officiel) (Entrée texte) | ≈0,0233 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,0328 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,0422 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,0516 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,061 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,0704 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,0799 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,0893 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,0987 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,1081 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,1175 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,127 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,1364 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,1458 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,1552 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,1646 $ / image |
| 2K | MiniMax (officiel) (Entrée image) | ≈0,1741 $ / image |
| 2K | KIE | 0,009 $ ~ 0,0115 $ / image |
| 4K | MiniMax (officiel) (Entrée texte) | ≈0,0688 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,0782 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,0876 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,0971 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1065 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1159 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1253 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1347 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1442 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1536 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,163 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1724 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1818 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,1913 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,2007 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,2101 $ / image |
| 4K | MiniMax (officiel) (Entrée image) | ≈0,2195 $ / image |
| 4K | KIE | 0,0275 $ ~ 0,03 $ / image |

## Paramètres

- Opération: `generate_image`

| Paramètre | Valeurs | Par défaut |
|---|---|---|
| `input` | text / image | text |
| `resolution` | 1K / 2K / 4K | 4K |
| `aspect_ratio` | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 | 1:1 |

## Intégration

Au choix : le SDK officiel pour du nouveau code, ou le changement de Base URL dans les projets qui utilisent déjà le protocole OpenAI.

### SDK officiel (TypeScript)

Le SDK appelle la Standard API (https://gateway.yir.ai) pour envoyer les tâches, attendre leur fin et récupérer les résultats ; un SDK Go est aussi disponible. https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit an image generation job
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. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### API compatible OpenAI

Protocoles OpenAI Images et Sora Videos pour les SDK OpenAI et les passerelles comme new-api ; pas de chat. https://yir.ai/docs/integrations/openai-compatibility

- base_url du SDK OpenAI: `https://gateway.yir.ai/openai/v1`
- Base URL du canal new-api (type de canal OpenAI): `https://gateway.yir.ai/openai`
- ID du modèle: `minimax/minimax-h3-image`

```bash
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"
  }'
```

## FAQ

### MiniMax H3 Image a-t-il une API officielle ?

Oui. MiniMax vend MiniMax H3 Image via sa propre API officielle, et son prix catalogue figure comme référence officielle dans le tableau ci-dessus. Avec Yir, une seule clé API suffit pour appeler MiniMax H3 Image et le comparer au prix public de chaque fournisseur.

### MiniMax H3 Image ou Nano Banana 2.1 : lequel choisir ?

Choisissez MiniMax H3 Image si vous voulez des poids ouverts à héberger ou affiner vous-même plus tard. Choisissez Nano Banana 2.1 si le prix passe d’abord : son canal 4K le moins cher sur Yir coûte moins que celui de H3 Image, avec plus de fournisseurs de secours.

### Combien de pixels fait une image 4K MiniMax H3 Image ?

Environ 16 à 17 mégapixels. Sur KIE, le 4K fait 4096 × 4096 en 1:1, 5472 × 3072 en 16:9 et 6272 × 2688 en 21:9 ; la route officielle va jusqu’à 5440 × 3072 en 16:9.

### MiniMax H3 Image est-il rapide en 4K ?

MiniMax annonce moins de 10 secondes pour une image 4K sur sa propre plateforme. Lors de notre test de six images 4K à partir de texte sur KIE, le traitement a pris de 23 à 39 secondes, avec une médiane d’environ 28 (novembre 2026).

### MiniMax H3 Image peut-il écrire du texte dans les images ?

Oui. Sur la carte de randonnée de cette page, le titre, les noms et la légende sont sortis exactement comme écrits, même si le modèle a ajouté une ligne « EST. 1925 » non demandée. Mettez le texte exact entre guillemets et indiquez son emplacement.

### MiniMax H3 Image est-il open source ?

Les poids sont publics sur Hugging Face sous MiniMaxAI/MiniMax-H3-Image : vous pourrez l’héberger ou l’affiner vous-même plus tard. Via Yir, vous appelez l’API officielle de MiniMax ou KIE, sans rien déployer.

## Règles

- Authentifiez-vous avec Authorization: Bearer $YIR_API_KEY ; gardez la clé dans une variable d’environnement côté serveur, jamais dans le code navigateur, le contrôle de version, les prompts ou les journaux.
- Les tâches sont asynchrones : conservez l’ID de la tâche, attendez un état final, puis lisez le résultat ; gérez l’échec et l’annulation.
- Pour réessayer sans risque, réutilisez la même clé d’idempotence et la même requête ; ne renvoyez pas à l’aveugle quand le résultat est inconnu.
- Les URL de résultat sont temporaires ; copiez les fichiers ailleurs si vous devez les conserver.

## Liens

- [Démarrage rapide](https://yir.ai/docs/getting-started/quickstart)
- [Référence de l’API](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)