MiniMax H3 Image API
MiniMax H3 Image est le modèle de génération et d'édition d'images de MiniMax, sorti le 11 novembre 2026. Sur APIMart, vous l'appelez avec l'ID de modèle minimax-h3-image pour le texte vers image et l'édition à partir d'images de référence, en 1K, 2K ou 4K.
Points forts du service
- Remises officielles
- Paiement à l'usage
- Rapide et faible latence
Image link valid for 72 hours
Tarifs MiniMax H3 Image API
Tarification transparente sans frais cachés. Ne payez que ce que vous utilisez.
| Variante | Niveau | Prix OrPrix actuel | Prix Platine | Prix Diamant | Prix officiel | Votre économie |
|---|---|---|---|---|---|---|
minimax-h3-imageLes prix sont des estimations ; le coût réel est facturé selon les tokens. | 1K/2K | 0.1891Credits/img~$0.0189/img | 0.1797Credits/img~$0.018/img | 0.1702Credits/img~$0.017/img | 0.2364Credits/img~$0.0236/img | 20% |
| 4K | 0.628Credits/img~$0.0628/img | 0.5966Credits/img~$0.0597/img | 0.5652Credits/img~$0.0565/img | 0.785Credits/img~$0.0785/img | 20% |
* Les coûts réels dépendent du résultat final.
* Facturation au token. Les lignes sont des estimations texte vers image pour une seule image : la sortie image plus environ 2 000 tokens d'entrée texte pour l'enrichissement du prompt. Les images de référence ajoutent des tokens d'entrée image. Le champ cost de chaque tâche indique le montant réellement débité.
MiniMax H3 Image API : texte vers image et édition d'image jusqu'en 4K
Générez des images à partir d'un prompt, ou éditez avec jusqu'à 16 images de référence. Choisissez 1K, 2K ou 4K avec n'importe quel format de 1:3 à 3:1, ou indiquez des dimensions exactes en pixels jusqu'à 20 millions. Une requête renvoie jusqu'à 10 images, et l'amélioration de prompt intégrée développe les prompts courts à votre place.
MiniMax H3 Image API : exemple de texte vers image et d'édition d'image
Appelez MiniMax H3 Image sur APIMart avec une seule requête POST. La génération est asynchrone : soumettez une tâche, puis interrogez l'endpoint de tâche pour obtenir les URL des images.
- 1
Authentifier les requêtes à l'API MiniMax H3 Image
Enregistrez votre clé APIMart dans la variable d'environnement APIMART_API_KEY et envoyez-la dans Authorization: Bearer <key> à chaque requête.
- 2
Soumettre une tâche MiniMax H3 Image
Envoyez POST /v1/images/generations avec model minimax-h3-image, votre prompt, size et resolution. Ajoutez image_urls pour éditer avec des images de référence. L'ID de tâche se trouve dans data[0].task_id.
- 3
Récupérer les images générées
Interrogez GET /v1/tasks/{task_id} toutes les 3 à 5 secondes jusqu'à ce que status soit completed, puis lisez les URL des images dans data.result.images[0].url. Les résultats sont conservés 72 heures, téléchargez-les donc à temps.
Consultez la documentation de l'API MiniMax H3 Image pour tous les paramètres, les règles de taille et les champs de réponse.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Un café chaleureux en bord de mer au coucher du soleil, photoréaliste, tons chauds",
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "minimax-h3-image",
"prompt": "Un café chaleureux en bord de mer au coucher du soleil, photoréaliste, tons chauds",
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Mets la veste de la deuxième image sur la personne de la première image, sans modifier l'\''arrière-plan",
"image_urls": [
"https://example.com/person.jpg",
"https://example.com/jacket.png"
],
"resolution": "2K"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Paramètres de l'API MiniMax H3 Image
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
model | string | Oui | Par défaut: minimax-h3-image | Utilisez minimax-h3-image. |
prompt | string | Oui | Par défaut: — | Description de l'image, 1 à 32 000 caractères une fois les espaces de début et de fin supprimés. |
size | string | Facultatif | Par défaut: auto | auto, un format d'image comme 16:9 (1:3 à 3:1), ou des pixels comme 2048x1152 (655 360 à 20 000 000 pixels au total). |
aspect_ratio | string | Facultatif | Par défaut: — | Autre façon de passer le format d'image, par exemple 16:9. S'il est défini, il remplace size. |
resolution | string | Facultatif | Par défaut: 4K | 1K, 2K ou 4K. Inutilisable quand size est en pixels. |
n | integer | Facultatif | Par défaut: 1 | Nombre d'images, de 1 à 10. |
image_urls | string[] | Facultatif | Par défaut: — | Jusqu'à 16 images de référence, sous forme d'URL ou de data URI en Base64. Leur ajout fait passer en mode édition. |
prompt_optimizer | boolean | Facultatif | Par défaut: true | Développe le prompt avant la génération. false ne fonctionne qu'en texte vers image avec une taille explicite. |
output_format | string | Facultatif | Par défaut: jpeg | jpeg, png ou webp. |
output_compression | integer | Facultatif | Par défaut: 95 | Qualité de compression de 0 à 100. Ignorée pour png. |
watermark | boolean | Facultatif | Par défaut: false | Ajoute à l'image un filigrane visible signalant un contenu généré par IA. |
