Passer au contenu

API Mage · Modèle d'image

API MiniMax H3 Image

Images natives de 16 mégapixels, poids ouverts

POST https://api.mage.space/v1/minimax_h3_image/generate

En un coup d’œil

L'API MiniMax H3 Image exécute MiniMax H3 Image via Mage sur POST https://api.mage.space/v1/minimax_h3_image/generate. Une requête avec les réglages par défaut coûte 15 Gems (environ 0,015 $), sans abonnement. MiniMax H3 Image accepte les personnages enregistrés et les références via @handle dans le prompt.

  • ImageSortie
  • 1Variante
  • 15Gems par image, par défaut
  • $0.015Environ, en USD

Présentation

Ce que fait l'API MiniMax H3 Image

Un modèle d'image à poids ouverts qui génère jusqu'en 4K (environ 16 mégapixels) avec beaucoup de détails et un suivi précis des instructions. Retouche ou combine jusqu'à 16 images de référence, avec des LoRA.

Un modèle d'image à poids ouverts pour le texte vers image et les retouches à partir de 16 images de référence maximum, en 2K (environ 4 mégapixels) ou en 4K natif (environ 16 mégapixels), avec des LoRA. Distillé en six étapes, il n'accepte ni prompt négatif, ni nombre d'étapes, ni échelle de guidage. Écris toute l'image en anglais ; pour une retouche, indique ce qu'il faut garder de chaque image, ce qui change, puis décris le résultat.

Il accepte image et additional_images en entrée.

Démarrage rapide

Appeler l'API MiniMax H3 Image

Définis MAGE_API_KEY, envoie ta requête à /minimax_h3_image/generate, puis interroge status_url jusqu'à la fin de la requête.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3_image/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "minimax-h3-image"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('minimax_h3_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'minimax-h3-image',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_h3_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "minimax-h3-image",
})

print(request["result"]["url"])

Modèles

Valeurs de model_id pour MiniMax H3 Image

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

model_idNomPar défaut
minimax-h3-imageMiniMax H3 ImageOui

Options

Paramètres de MiniMax H3 Image

Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.

ChampValeurs
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution2k, 4k

Entrées

Médias acceptés par MiniMax H3 Image

Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.

ChampRôle
imageL'image de référence.
additional_imagesImages de référence supplémentaires.

Règles

Ce que l'API MiniMax H3 Image impose

  • Envoie jusqu'à 16 images de référence réparties entre image et additional_images, plus les personnages et références mentionnés ; le prompt les nomme image 1, image 2, ... dans cet ordre.

Autres modèles d'image

Autres API de génération d'images sur Mage

FAQ

Questions fréquentes

Combien coûte l'API MiniMax H3 Image ?
Une requête MiniMax H3 Image avec les réglages par défaut (MiniMax H3 Image) coûte 15 Gems, soit environ 0,015 $. D'autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; celle que bloque la politique de contenu de Mage ne l'est pas.
Quel est l'endpoint de l'API MiniMax H3 Image ?
POST https://api.mage.space/v1/minimax_h3_image/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut une status_url à interroger pour obtenir le résultat.
Quels modèles MiniMax H3 Image puis-je appeler ?
minimax-h3-image (MiniMax H3 Image). Le modèle par défaut est MiniMax H3 Image.
MiniMax H3 Image prend-il en charge les images de référence ou les personnages ?
MiniMax H3 Image accepte image, additional_images. MiniMax H3 Image accepte les personnages enregistrés et les références via @handle dans le prompt.
Puis-je utiliser MiniMax H3 Image depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande MiniMax H3 Image par son nom. Ton assistant lit ses options avec get_model et annonce le prix avant de générer.
Combien de temps les résultats MiniMax H3 Image sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

Lance-toi avec Mage

Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.