Créer une image

POST/v1/images/generations

Générer des images à partir d’un prompt textuel.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez une clé API de la plateforme au format Authorization: Bearer your-api-key.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID du modèle de la plateforme.

prompt*string

Prompt de génération ou de modification ; compté en caractères Unicode sans les espaces de début et de fin ; ne peut pas être vide.

Longueur1 <= length <= 32000

n?integer

Nombre d’images à générer.

Plage1 <= value <= 10

Valeur par défaut1

size?string

auto ou WIDTHxHEIGHT, auto par défaut. Surface personnalisée : 655,360–20,000,000 pixels ; rapport : 1:3–3:1. Omettre aspect_ratio et area si les dimensions sont précisées.

Valeur par défaut"auto"

aspect_ratio?string

auto par défaut, déterminé par le prompt enrichi et les images de référence lors d’une modification. Accepte aussi X:Y, avec X et Y entiers de 1–300 et un rapport de 1:3–3:1. Uniquement si size est omis ou vaut auto.

area?string

Palier de surface, 4K par défaut. Uniquement si size est omis ou vaut auto ; dimensions réelles dans data[].size.

Valeurs autorisées

"1K"
"2K"
"4K"

output_format?string

Format d’image. jpg et jpeg sont équivalents ; la réponse utilise jpeg.

Valeur par défaut"jpeg"

Valeurs autorisées

"jpeg"
"jpg"
"png"
"webp"

response_format?string

Les liens url expirent après 24 heures ; b64_json renvoie du Base64 sans streaming. La surface totale de sortie Base64 est limitée à 20,000,000 pixels pour PNG et 80,000,000 pixels pour JPEG/WebP, toutes images confondues.

Valeur par défaut"url"

Valeurs autorisées

"url"
"b64_json"

output_compression?integer

Qualité de compression JPEG/WebP ; une valeur élevée augmente la taille du fichier. Ignorée pour PNG.

Plage0 <= value <= 100

Valeur par défaut95

stream?boolean

Renvoyer chaque image via SSE ; uniquement avec response_format à url.

Valeur par défautfalse

aigc_watermark?boolean

Ajouter un filigrane AIGC visible ; sans effet sur l’identifiant implicite des métadonnées du fichier.

Valeur par défautfalse

disable_prompt_enhanced?boolean

Désactiver l’enrichissement du prompt. Seuls environ les 4,096 premiers tokens sont alors pris en compte ; préciser size ou un aspect_ratio fixe.

Valeur par défautfalse

Corps de réponse

`application/json`

type*string

created?integer

Horodatage Unix de l’événement.

model?string

ID du modèle réellement utilisé.

image_index*integer

Indice d’image commençant à 0.

Plage0 <= value

url*string

Lien temporaire de l’image générée.

size?string

Dimensions réelles WIDTHxHEIGHT.

output_format?string

Format réel de sortie.

Valeurs autorisées

"jpeg"
"png"
"webp"

revised_prompt?string

Prompt utilisé pour cette image.

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Génère une photo d’une lampe de bureau verte sur une table en bois, devant un mur clair, avec une lumière naturelle douce.",
    "size": "2048x2048",
    "n": 1,
    "response_format": "url"
  }'

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "Une lampe de bureau verte repose sur une table en bois devant un mur clair ; une lumière naturelle douce éclaire l’abat-jour et le plateau."
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

Définissez un délai client d’au moins 600 secondes. La génération peut continuer après un délai dépassé ou une déconnexion ; un nouvel envoi crée une nouvelle requête.

API de génération d’images MiniMaxConsulter les paramètres et la structure des réponses.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

Événements de réponse en streaming

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`