Passer au contenu principal
POST
/
v1
/
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": "gpt-image-2",
  "prompt": "Un magnifique coucher de soleil coloré sur l'océan"
}
EOF
{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2",
  "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"
  }
}

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:gpt-image-2
requis

Nom du modèle de génération d'image, canal officiel, meilleure stabilité et contrôlabilité, adapté aux scénarios commerciaux

Options disponibles:
gpt-image-2
Exemple:

"gpt-image-2"

​
prompt
string
requis

Invite décrivant l'image à générer, ou décrivant comment éditer l'image d'entrée

Limites :

  • Jusqu'à 32000 caractères (comptés en points de code Unicode, valable pour CJK et autres langues)
Maximum string length: 32000
Exemple:

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

​
image_urls
string<uri>[]

Liste d'URL d'images de référence pour les fonctions image vers image et édition d'image

Remarque :

  • Nombre d'images d'entrée par requête : 1~16
  • Taille d'une seule image : ne dépassant pas 50MB
  • Formats de fichiers pris en charge : .jpeg, .jpg, .png, .webp
  • Les URL d'images doivent être directement accessibles par le serveur, ou l'URL de l'image doit déclencher un téléchargement direct lors de l'accès (généralement ces URL se terminent par des extensions de fichiers image, telles que .png, .jpg)
  • Dans les scénarios image vers image / édition d'image, les images de référence fournies entraînent une consommation supplémentaire de tokens d'entrée d'image
Exemple:
[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
​
mask_url
string<uri>

URL du masque d'inpainting — marque la région de l'image de référence à régénérer. Valide uniquement en mode édition d'image (doit être combiné avec image_urls) ; en texte-vers-image pur, le masque est silencieusement ignoré.

Exigences de format :

  • Doit être un PNG avec canal alpha : pixels transparents (alpha < 255) = zones à régénérer, pixels opaques = préservés
  • Les dimensions du masque doivent correspondre exactement à celles de l'image de référence (largeur × hauteur en pixels)
  • Un seul masque par requête

Remarque :

  • Au moins une image de référence est requise dans image_urls ; un masque seul n'a aucun effet
  • Erreurs courantes :
    • Invalid mask image format - mask image missing alpha channel : l'image téléchargée n'a pas de canal alpha (JPEG, PNG opaque, etc.). Réexportez le masque en PNG avec des régions transparentes.
    • Invalid mask image format - mask size does not match image size : les dimensions du masque ne correspondent pas à l'image de référence. Redimensionnez le masque aux mêmes dimensions en pixels que votre image de référence.
Exemple:

"https://example.com/mask.png"

​
size
string
défaut:auto

Taille de l'image générée. Prend en charge à la fois le format de ratio et le format de pixels explicite, par défaut auto

① Format de ratio (recommandé, 15 options)

  • 1:1 : Carré
  • 1:2 / 2:1 : Portrait / paysage extrême
  • 1:3 / 3:1 : Ultra portrait / paysage (limite 3:1)
  • 2:3 / 3:2 : Portrait / paysage standard
  • 3:4 / 4:3 : Portrait / paysage classique
  • 4:5 / 5:4 : Courant sur les réseaux sociaux
  • 9:16 / 16:9 : Écran large mobile / bureau
  • 9:21 / 21:9 : Ultra-large

② Format de pixels explicite : WxH (ou W×H), par exemple 1024x1024, 1536x1024, 3840×2160

  • La largeur et la hauteur doivent être des multiples de 16
  • Plage de chaque côté : [16, 3840]
  • Budget de pixels : 655 360 ≤ width × height ≤ 8 294 400 (environ 0,65 MP ~ 8,29 MP)
  • Rapport d'aspect : ≤ 3:1

③ auto : Le modèle détermine la taille automatiquement (dans ce cas resolution ne s'applique pas)

Gestion des dépassements :

  • Si une combinaison ratio + resolution dépasse le budget de pixels, les dimensions sont automatiquement réduites proportionnellement au maximum (par ex. 4K 2:1 → 3840×1920)
Exemple:

"auto"

​
resolution
enum<string>
défaut:1K

Paramètre rapide de palier de résolution, effectif uniquement lorsque size est au format ratio ; ignoré en format pixels explicite

Règles de budget pixel (les dimensions sont calculées à partir du nombre total de pixels cible et du ratio size, alignées sur des multiples de 16) :

  • 1K : ~1 MP (1024² = 1 048 576 pixels)
  • 2K : ~4 MP (2048² = 4 194 304 pixels)
  • 4K : ~8,29 MP (3840×2160 = 8 294 400 pixels, le maximum)

Dimensions de sortie paysage / carré (les dimensions portrait correspondent au paysage avec largeur/hauteur inversées, par exemple 2:3 = 3:2 inversé) :

Ratio1K2K4K
1:11024×10242048×20482880×2880
2:11456×7202896×14563840×1920 *
3:11776×5923552×11843840×1280 *
3:21248×8322512×16803520×2352
4:31184×8802368×17763312×2480 *
5:41152×9122288×18243216×2576
16:91360×7682736×15363840×2160 (UHD)
21:91568×6723136×13443840×1632 *

* Indique les combinaisons automatiquement réduites pour respecter le budget de pixels. Les valeurs sont insensibles à la casse.

Options disponibles:
1K,
2K,
4K
Exemple:

"1K"

​
quality
enum<string>
défaut:medium

Qualité de rendu, contrôle la "profondeur de raisonnement" du modèle, affecte directement le nombre de tokens de sortie et le coût. Par défaut medium

ValeurBase de tuilesCoût relatif (1024²)
low16~0,11×
medium481,0×
high96~4,0×
Options disponibles:
low,
medium,
high
Exemple:

"medium"

​
n
integer
défaut:1

Nombre d'images à générer, chacune facturée indépendamment

Remarque :

  • Les tokens d'entrée texte augmentent proportionnellement à n
Plage requise: 1 <= x <= 10
Exemple:

1

​
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

​
id
string

ID de tâche

Exemple:

"task-unified-1757156493-imcg5zqt"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"gpt-image-2"

​
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

​
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