curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2-beta",
  "prompt": "A beautiful colorful sunset over the ocean"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2-beta",
  "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: gpt-image-2-beta",
    "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"
  }
}

GPT Image

GPT Image 2 Génération d'images Beta

Le modèle GPT Image 2 (gpt-image-2-beta) prend en charge les modes texte vers image, image vers image et édition d’image
Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour interroger le statut
Les liens d’image générés sont valides pendant 24 heures, veuillez les enregistrer rapidement

Tailles prises en charge :

Actuellement, seuls size=auto ou les tailles en ratio (par ex. size="1:1") avec resolution="1K" sont pris en charge
Lorsque size=auto, le champ resolution est ignoré et traité comme 1K
resolution="2K" / resolution="4K" et les tailles en pixels explicites (par ex. 1024x1024) ne sont pas pris en charge actuellement
Pour du 2K, 4K ou un contrôle explicite des pixels, utilisez gpt-image-2

Facturation (per_call) :

Facturation uniquement au palier 1K
n est fixé à 1 ; quality n’est pas exposé sur ce canal

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2-beta",
  "prompt": "A beautiful colorful sunset over the ocean"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2-beta",
  "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: gpt-image-2-beta",
    "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:gpt-image-2-beta

requis

Nom du modèle de génération d'image

Options disponibles:

gpt-image-2-beta

Exemple:

"gpt-image-2-beta"

prompt

string

requis

Invite décrivant l'image que vous souhaitez générer, ou décrivant comment éditer l'image d'entrée. Limitée à 2000 tokens

Maximum string length: 2000

Exemple:

"A beautiful colorful sunset over the ocean"

size

string

défaut:auto

Taille de l'image générée. Deux modes sont pris en charge :

1. auto (par défaut)

Le modèle détermine automatiquement la taille de sortie. Dans ce mode, le champ resolution est ignoré et traité comme 1K.

2. Ratio (doit être utilisé avec resolution="1K")

1:1 : Carré
3:2 / 2:3 : Paysage / Portrait
4:3 / 3:4 : Paysage / Portrait
5:4 / 4:5 : Paysage / Portrait
16:9 / 9:16 : Écran large paysage / portrait
21:9 / 9:21 : Ultra-large paysage / portrait
2:1 / 1:2 : Paysage / Portrait
3:1 / 1:3 : Panorama paysage / portrait (rapport maximal)

Remarque : Les tailles en pixels explicites (par ex. 1024x1024) ne sont pas prises en charge actuellement. Pour un contrôle explicite des pixels, utilisez gpt-image-2.

Exemple:

"16:9"

resolution

enum<string>

défaut:1K

Niveau de résolution. Effectif uniquement lorsque size est un ratio. Actuellement, seul 1K est pris en charge.

Cas d'ignorance :

Lorsque size=auto, ce champ est ignoré et traité comme 1K (ce paramètre n'a pas besoin d'être passé)

Dimensions de sortie paysage/carré (les dimensions portrait sont celles du paysage avec largeur/hauteur inversées) :

Ratio	1K
`1:1`	1024×1024
`2:1`	1456×720
`3:1`	1776×592
`3:2`	1248×832
`4:3`	1184×880
`5:4`	1152×912
`16:9`	1360×768
`21:9`	1568×672

Remarque : 2K / 4K ne sont pas pris en charge actuellement. Pour une résolution plus élevée, utilisez gpt-image-2.

Options disponibles:

1K

Exemple:

"1K"

image_urls

string<uri>[]

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

Remarques :

Jusqu'à 16 images de référence par requête
Formats pris en charge : .jpeg, .jpg, .png, .webp
Les URL d'images doivent être directement accessibles par le serveur, ou des URL qui déclenchent un téléchargement direct (généralement des URL se terminant par des extensions d'image comme .png, .jpg)

Maximum array length: 16

Exemple:

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

callback_url

string<uri>

URL de rappel HTTPS pour 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é :

Protocole HTTPS uniquement
Les adresses IP internes sont interdites (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 après échec (à 1/2/4 secondes après l'échec)
Le format de réponse du rappel est cohérent avec l'API de requête de tâche
Un code de statut 2xx est considéré comme un succès, les autres codes 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:

"gpt-image-2-beta"

object

enum<string>

Type d'objet 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

GPT Image 2 Génération d'images GPT Image 1.5 Génération d'images

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

GPT Image 2 Génération d'images Beta

Autorisations

Toutes les API nécessitent une authentification Bearer Token

Corps

Réponse