MiniMax H3 Image API
MiniMax-H3-Image génère et édite des images jusqu'à 4096 par 4096 pixels à partir de textes ou d'images de référence, avec un fort contrôle créatif.
MiniMax-H3-Image est un modèle de génération et d'édition d'images de MiniMax. Il accepte des entrées texte et image et produit des images jusqu'à 4096 par 4096 pixels, soit 16 mégapixels, avec un coût computationnel qualifié de pratique. Il prend en charge la génération texte-image ainsi que l'édition multi-référence, avec jusqu'à 16 images de référence pour conserver la cohérence de certaines parties du cadre lors d'éditions ciblées. La documentation indique qu'il offre le meilleur suivi d'instructions parmi les modèles open source.
Le modèle fonctionne avec des paramètres d'inférence fixes : num_inference_steps à 6 et guidance_scale à 1. Le prompt est tronqué à 4096 tokens. Les prompts négatifs ne sont pas pris en charge et sont rejetés ; toute autre valeur pour num_inference_steps ou guidance_scale renvoie une erreur HTTP 400. Le paramètre min_generation_area va de 1024 à 16777216 pixels, avec une valeur par défaut de 4194304 (2048 par 2048) ; les tailles demandées plus petites sont générées sur un canevas plus grand au même rapport d'aspect puis redimensionnées par interpolation LANCZOS. Il est recommandé de régler le périphérique du générateur sur CPU pour la reproductibilité des graines, et de définir response_format sur b64_json.
Ce modèle convient aux tâches visuelles exigeantes en détail et en réalisme, comme la publicité et le branding, le commerce en ligne, le design produit, l'UI/UX, le jeu vidéo, le concept art, l'exploration de produits et les itérations de mise en page. Il est distribué sous la MiniMax-H3-Image Community License Agreement ; toute utilisation commerciale nécessitant une autorisation écrite distincte doit être demandée via platform.minimax.io/license.
Mis à jour:
ID DU MODÈLE
minimax-h3-image- Entrée
- text / image
- Sortie
- image
Points clés
- Sortie 16 mégapixels (4096 × 4096)
- Jusqu'à 16 images de référence
- Fort suivi d'instructions open source
- Paramètres d'inférence fixes
- Prompt tronqué à 4096 tokens
- Extension de prompts via H3-Image-Context-IR
Fournisseurs
Comparez les prix des API entre fournisseurs. Sélectionnez un fournisseur pour voir tous les tarifs et conditions.
| Disponibilité | |
|---|---|
Les statistiques historiques ne sont pas un contrôle en direct. Une donnée manquante ne signifie pas une panne.
Démarrage rapide
Envoyez une tâche image, consultez son état, puis enregistrez les images. Les exemples utilisent curl et la bibliothèque standard de Python 3.
POST https://openapi.felo.ai/api/v1/images/generations
1Configurer votre clé API
Créez une clé depuis votre compte Felo API Platform et définissez-la comme variable d'environnement.
export FELO_API_KEY="YOUR_API_KEY"2Effectuer votre première requête
Les valeurs facultatives dépendent du modèle et ne sont pas prédéfinies ici. Vérifiez-les dans Playground. Les champs sont au même niveau que model et prompt, sans enveloppe input.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "minimax-h3-image"
}'3Interroger la tâche
La soumission renvoie task_id. Interrogez toutes les 3 secondes pendant queued ou running ; arrêtez à succeeded, failed ou interrupted. Attente maximale : 30 minutes. Gardez created.json pour reprendre sans soumettre une nouvelle tâche.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4Télécharger la sortie
Après réussite, enregistrez outputs depuis task.json : URL HTTPS, objets URL ou b64_json. Téléchargez rapidement les URL signées. Le téléchargement des images ne nécessite pas de clé API.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
Pour modifier une image, remplacez l’URL par votre URL HTTPS ou une data URL d’image en base64. Soumettez une fois, puis suivez les mêmes étapes de consultation et d’enregistrement.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "minimax-h3-image",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'Paramètres pris en charge
- n
- size
- resolution
- aspect_ratio
- output_format
- input_references
Besoin de la référence complète ?
Référence API →Questions fréquentes
Qu'est-ce que MiniMax H3 Image?
MiniMax-H3-Image est un modèle de génération et d'édition d'images de MiniMax. Il accepte des entrées texte et image et produit des images jusqu'à 4096 par 4096 pixels, soit 16 mégapixels, avec un coût computationnel qualifié de pratique. Il prend en charge la génération texte-image ainsi que l'édition multi-référence, avec jusqu'à 16 images de référence pour conserver la cohérence de certaines parties du cadre lors d'éditions ciblées. La documentation indique qu'il offre le meilleur suivi d'instructions parmi les modèles open source. Le modèle fonctionne avec des paramètres d'inférence fixes : num_inference_steps à 6 et guidance_scale à 1. Le prompt est tronqué à 4096 tokens. Les prompts négatifs ne sont pas pris en charge et sont rejetés ; toute autre valeur pour num_inference_steps ou guidance_scale renvoie une erreur HTTP 400. Le paramètre min_generation_area va de 1024 à 16777216 pixels, avec une valeur par défaut de 4194304 (2048 par 2048) ; les tailles demandées plus petites sont générées sur un canevas plus grand au même rapport d'aspect puis redimensionnées par interpolation LANCZOS. Il est recommandé de régler le périphérique du générateur sur CPU pour la reproductibilité des graines, et de définir response_format sur b64_json. Ce modèle convient aux tâches visuelles exigeantes en détail et en réalisme, comme la publicité et le branding, le commerce en ligne, le design produit, l'UI/UX, le jeu vidéo, le concept art, l'exploration de produits et les itérations de mise en page. Il est distribué sous la MiniMax-H3-Image Community License Agreement ; toute utilisation commerciale nécessitant une autorisation écrite distincte doit être demandée via platform.minimax.io/license.
Comment l'usage est-il facturé ?
Votre facture dépend du fournisseur utilisé, de ses tarifs et de votre usage. Des entrées plus longues ou d'autres conditions peuvent avoir des tarifs différents. Facturé selon le coût réel de génération. Consultez votre facture pour le montant final.
Quels types d'entrées MiniMax-H3-Image accepte-t-il ?
Il accepte du texte et des images en entrée, et produit des images en sortie. Il prend en charge la génération texte-image et l'édition multi-référence avec jusqu'à 16 images de référence.
Quelle est la résolution maximale de sortie ?
Le modèle génère des images jusqu'à 4096 par 4096 pixels, soit 16 mégapixels.
Comment le prompt est-il traité ?
Le prompt est tronqué à 4096 tokens. Les prompts négatifs ne sont pas pris en charge et sont rejetés.
Peut-on modifier les paramètres d'inférence ?
Non, les paramètres sont fixes : num_inference_steps à 6 et guidance_scale à 1. Toute autre valeur renvoie une erreur HTTP 400.
Quelle est la différence avec MiniMax-H3-Image-PE ?
MiniMax-H3-Image-PE est une variante déployable localement, exécutable avec un serveur SGLang local.
Quelles sont les conditions de licence ?
Le modèle est publié sous la MiniMax-H3-Image Community License Agreement. Une utilisation commerciale nécessitant une autorisation écrite distincte doit être demandée via platform.minimax.io/license.