Passer au contenu principal
POST

Authentification

string
requis
Tous les endpoints utilisent un Bearer Token. Obtenez votre clé sur la page des clés API.

Présentation des modèles

MiniMax H3 Image excelle en photo réaliste, affiches, visuels produit et images avec texte. Par défaut, il commence par enrichir automatiquement le prompt en une description détaillée de la scène, puis génère l’image. Le texte enrichi est disponible dans revised_prompt du résultat de la tâche. Pour générer strictement à partir du texte d’origine, voir Désactiver la réécriture du prompt.
Sans resolution, la sortie est en 4K par défaut (environ 16 mégapixels), pour un prix environ 3,6 fois supérieur à 1K / 2K. Si vous n’avez pas besoin de 4K, passez explicitement "resolution": "2K".

Paramètres de requête

string
requis
Nom du modèle de génération d’images, toujours minimax-h3-image-highspeed.
string
requis
Description textuelle de l’image à générer ou à retoucher.Prend en charge le chinois et l’anglais. Longueur de 1 à 32,000 caractères après suppression des espaces de début et de fin.
string[]
Tableau d’images de référence, 16 au maximum. Sa présence active automatiquement le mode retouche.Chaque élément peut être un lien direct http(s):// accessible publiquement ou du Base64 intégré au format data:image/png;base64,... (la plateforme le convertit d’abord en lien avant de le transmettre au modèle).Voir Exigences pour les images de référence.
string
défaut:"auto"
Format ou dimensions exactes en pixels de l’image de sortie.Valeurs prises en charge :
  • auto : le modèle choisit la composition et le format selon le prompt
  • Format : X:Y, avec X et Y entiers de 1 à 300 et un rapport compris entre 1:3 et 3:1 (bornes incluses), par exemple 1:1, 4:3, 16:9, 9:16, 3:1
  • Pixels exacts : largeurxhauteur, par exemple 2048x1152 (les séparateurs X, × et * sont aussi acceptés)
Voir Règles de dimensions.
string
défaut:"4K"
Niveau de résolution ; combiné au format, il détermine le nombre réel de pixels en sortie.
  • 1K : environ 1 mégapixel
  • 2K : environ 4,2 mégapixels
  • 4K (par défaut) : environ 16 mégapixels
Les minuscules sont acceptées.
Lorsque size est en pixels exacts, resolution ne doit pas être passé, sinon une erreur 400 est renvoyée.
integer
défaut:"1"
Nombre d’images à générer, de 1 à 10.
boolean
défaut:"true"
Active ou non l’enrichissement automatique du prompt.false ne s’applique qu’au texte vers image et exige des dimensions explicites ; voir Désactiver la réécriture du prompt.
string
défaut:"jpeg"
Format du fichier de sortie.
  • jpeg (par défaut, jpg est aussi accepté)
  • png
  • webp
integer
défaut:"95"
Qualité de compression de 0 à 100 ; sans effet sur png.
boolean
défaut:"false"
Ajoute ou non un filigrane visible indiquant une génération par IA. N’affecte pas le marquage invisible dans les métadonnées de l’image.
Les paramètres suivants ne sont pas pris en charge et sont ignorés : quality, style, seed, negative_prompt, background, mask_url.Les résultats sont toujours renvoyés sous forme d’URL ; passer response_format: "b64_json" renvoie une erreur 400.

Règles de dimensions

Niveau + format

Le niveau détermine la surface totale, le format détermine la forme : Le modèle arrondit le nombre réel de pixels selon le format et le niveau ; seul le résultat renvoyé fait foi. Pour des dimensions exactes, utilisez la notation en pixels.

Pixels exacts

Avec size: "largeurxhauteur", les conditions suivantes s’appliquent :
  • ✅ 1024x1024, 2048x1152, 1536x1536, 4000x5000
  • ❌ 512x512 (surface trop petite), 4000x1000 (format au-delà de 3:1), 5000x5000 (plus de 20 mégapixels)

Exigences pour les images de référence

Avec des URL, assurez-vous que le lien est accessible publiquement. Si le lien est inaccessible, la tâche échoue pendant la génération (status vaut failed, le montant est intégralement remboursé).En mode retouche, l’optimisation du prompt est toujours active et ne peut pas être désactivée.

Désactiver la réécriture du prompt

Par défaut, le modèle enrichit d’abord le prompt, puis génère l’image. Pour générer strictement à partir du texte d’origine, passez "prompt_optimizer": false, à condition que :
  • La requête soit en texte vers image uniquement ; avec image_urls, une erreur 400 est renvoyée
  • Les dimensions soient explicites : size doit être un format (par exemple 1:1) ou des pixels (par exemple 1024x1024), ni auto ni omis
Une fois l’optimisation désactivée, le modèle ne lit qu’environ les 4096 premiers tokens du prompt.

Response

integer
Code de réponse ; 200 lorsque l’envoi réussit.
array
Données de la réponse d’envoi.

Réponse d’envoi

Une fois l’envoi réussi, l’ID de la tâche asynchrone est renvoyé immédiatement :

Consulter le résultat de la tâche

Utilisez le task_id de la réponse d’envoi avec l’endpoint de consultation des tâches :
La version rapide génère plus vite que la version standard (mesuré sur la version standard : environ 10 ~ 20 secondes pour une image 1K / 2K, environ 20 secondes en 4K). Interrogez l’état toutes les 3 ~ 5 secondes jusqu’à obtenir completed ou failed. Une tâche peut durer jusqu’à 600 secondes ; fixez donc le délai d’attente du polling côté client à 10 minutes.

Tâche réussie

Les URL des images se trouvent dans data.result.images[0].url[] ; les n images sont toutes dans ce même tableau. Téléchargez-les et conservez-les avant expires_at. En cas d’échec, status vaut failed, la cause figure dans error.message et le montant est automatiquement remboursé en totalité.

Exemples d’utilisation

Texte vers image (4K par défaut)

Texte vers image (1K + format, 4 images)

Pixels exacts + PNG

Retouche avec images de référence

Désactiver la réécriture du prompt