curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "minimax-h3-image",
  "prompt": "Un magnifique coucher de soleil coloré sur l'océan"
}
EOF

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax

MiniMax H3 Image Génération d’images

MiniMax H3 Image (minimax-h3-image) prend en charge la génération d’images à partir de texte et l’édition d’images, avec jusqu’à 16 images de référence
Sortie jusqu’à 20 millions de pixels : combinez un rapport d’aspect avec un niveau de résolution 1K / 2K / 4K, ou indiquez la largeur et la hauteur en pixels
Traitement asynchrone : utilisez l’ID de tâche renvoyé pour consulter la tâche
Les liens des images générées sont valables 24 heures. Enregistrez rapidement les résultats

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "minimax-h3-image",
  "prompt": "Un magnifique coucher de soleil coloré sur l'océan"
}
EOF

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "minimax-h3-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-image",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorisations

Authorization

string

header

requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

défaut:minimax-h3-image

requis

Nom du modèle de génération d’images. Le canal officiel offre une meilleure stabilité et un meilleur contrôle pour un usage commercial

Options disponibles:

minimax-h3-image

Exemple:

"minimax-h3-image"

prompt

string

requis

Prompt décrivant l’image à générer ou les modifications à apporter aux images fournies

Limites de longueur :

Jusqu’à 32,000 caractères (comptés en points de code Unicode)
Lorsque prompt_extend vaut false, seuls les quelque 4096 premiers tokens du prompt sont pris en compte

Maximum string length: 32000

Exemple:

"Un magnifique coucher de soleil coloré sur l'océan"

image_urls

string<uri>[]

Liste des URL d’images de référence pour la génération image vers image et l’édition d’images

Remarques :

Nombre d’images fournies par requête : 1~16
Taille maximale par image : 64MB
Largeur et hauteur de chaque image : de 128 à 8192 px
Rapport d’aspect de chaque image : côté le plus long / côté le plus court ne dépassant pas 4:1
Formats pris en charge : .jpeg, .jpg, .png, .webp, .heic, .heif
Les URL doivent être directement accessibles au serveur ou déclencher un téléchargement direct (ces URL se terminent généralement par une extension d’image telle que .png ou .jpg)
Les images de référence entraînent une consommation supplémentaire de tokens d’image en entrée pour la génération image vers image et l’édition

Exemple:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

size

string

défaut:auto

Dimensions de l’image générée. Accepte un rapport d’aspect ou des dimensions explicites en pixels. Par défaut : auto

① Rapport d’aspect (recommandé) : X:Y. Rapports courants :

1:1 : carré
1:2 / 2:1 : très vertical / très horizontal
1:3 / 3:1 : extra vertical / extra horizontal (à la limite de 3:1)
2:3 / 3:2 : portrait / paysage standard
3:4 / 4:3 : portrait / paysage traditionnel
4:5 / 5:4 : formats courants des réseaux sociaux
9:16 / 16:9 : écran large mobile / ordinateur
9:21 / 21:9 : formats ultra-larges

D’autres valeurs X:Y sont acceptées : X et Y doivent être des entiers de 1 à 300, avec un rapport d’aspect ≤ 3:1

② Dimensions explicites en pixels : WxH (ou W×H), par exemple 1024x1024, 2720x1536, 5472x3072

Budget de pixels : 655,360 ≤ width × height ≤ 20,000,000 (environ 0,65 MP à 20 MP)
Rapport d’aspect : ≤ 3:1

③ auto : le modèle choisit automatiquement le rapport d’aspect ; la surface de sortie suit toujours le niveau resolution

Dimensions hors limites :

Les dimensions hors de ces limites renvoient 400, sans redimensionnement ni arrondi automatique

Exemple:

"auto"

resolution

enum<string>

défaut:2K

Paramètre simplifié du niveau de résolution. S’applique lorsque size vaut auto ou un rapport d’aspect ; ignoré avec des dimensions explicites en pixels

Budget de pixels (largeur et hauteur calculées à partir du nombre total de pixels cible et du rapport size) :

1K : ~1 MP (1024² = 1,048,576 pixels)
2K : ~4 MP (2048² = 4,194,304 pixels)
4K : ~16,8 MP (4096² = 16,777,216 pixels)

Dimensions réelles en paysage / carré (en portrait, largeur et hauteur sont inversées ; par exemple, 3:4 inverse 4:3) :

Rapport d’aspect	2K	4K
`1:1`	2048×2048	4096×4096
`4:3`	2368×1760	4736×3552
`16:9`	2720×1536	5472×3072
`3:1`	3552×1184	7104×2368

Remarques :

1K et 2K utilisent le même nombre de tokens d’image en sortie (environ 4,096 par image) ; 4K utilise environ 16,384 par image. La valeur usage renvoyée fait foi
Les valeurs ne sont pas sensibles à la casse

Options disponibles:

1K,

2K,

4K

Exemple:

"2K"

output_format

enum<string>

défaut:jpeg

Format du fichier image généré. Par défaut : jpeg

jpeg : compression avec perte, fichiers plus petits
png : sans perte
webp : équilibre entre taille et qualité

Remarque :

Les arrière-plans transparents ne sont pas pris en charge

Options disponibles:

jpeg,

png,

webp

Exemple:

"jpeg"

integer

défaut:1

Nombre d’images à générer. Chaque image est facturée séparément

Remarques :

Les tokens de texte et d’image en entrée augmentent proportionnellement à n
Si certaines images échouent (par exemple lors des contrôles de sécurité du contenu), la tâche se termine avec les images réussies. Le nombre réel est indiqué par results dans la réponse, et la facturation suit la valeur usage renvoyée

Plage requise: 1 <= x <= 10

Exemple:

1

prompt_extend

boolean

défaut:true

Optimisation du prompt : le modèle réécrit le prompt de façon plus détaillée avant la génération. Par défaut : true

Remarques :

Ne peut être défini sur false que pour la génération à partir de texte, lorsque size est un rapport d’aspect ou des dimensions explicites en pixels
Si size vaut auto ou si image_urls est fourni, la valeur false renvoie 400
Si activé, ajoute environ 2,300 à 3,800 tokens de texte en entrée par image ; sinon, seul le prompt d’origine est comptabilisé

Exemple:

true

callback_url

string<uri>

Adresse de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

Déclenché lorsque la tâche est terminée, échouée ou annulée
Envoyé après confirmation de la facturation

Restrictions de sécurité :

Seul le protocole HTTPS est pris en charge
Les rappels vers les adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

Délai d'expiration : 10 secondes
Maximum 3 tentatives en cas d'échec (tentatives après 1 seconde/2 secondes/4 secondes)
Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de requête de tâche
Un code de statut 2xx renvoyé par l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative

Exemple:

"https://your-domain.com/webhooks/image-task-completed"

Réponse

Tâche d'image créée avec succès

created

integer

Horodatage de création de la tâche

Exemple:

1757156493

string

ID de tâche

Exemple:

"task-unified-1757156493-imcg5zqt"

model

string

Nom du modèle réellement utilisé

Exemple:

"minimax-h3-image"

object

enum<string>

Type spécifique de tâche

Options disponibles:

image.generation.task

progress

integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tâche

Options disponibles:

pending,

processing,

completed,

failed

Exemple:

"pending"

task_info

object

Informations sur la tâche asynchrone

Show child attributes

type

enum<string>

Type de sortie de la tâche

Options disponibles:

text,

image,

audio,

video

Exemple:

"image"

usage

object

Informations d'utilisation et de facturation

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

MiniMax H3 Image Génération d’images

Autorisations

Corps

Réponse