curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "qwen-image-3.0",
  "prompt": "Un chat roux portant un casque d'astronaute, sur un fond néon cyberpunk",
  "size": "16:9",
  "quality": "2K"
}
EOF

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 2.2483,
    "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: qwen-image-3.0",
    "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"
  }
}

Qwen-Image

Qwen Image 3.0

Qwen (qwen-image-3.0) est l’édition standard de la génération et de l’édition d’images Qwen 3.0 ; elle prend également en charge les deux modes : génération d’image à partir de texte (T2I, sans image de référence) et édition d’image (I2I, avec 1 à 3 images de référence), en conciliant qualité et rapidité
Les paramètres de requête, la logique de taille et la structure de réponse sont identiques à ceux de qwen-image-3.0-pro ; seules la qualité de génération et la tarification diffèrent
Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour interroger
Les liens d’image générés sont valides pendant 24 heures, veuillez les enregistrer rapidement

Facturation :

Facturé selon « nombre d’images de sortie × niveau de résolution » ; sur l’édition standard, 1K et 2K coûtent le même prix (contrairement à Pro, où le 2K est plus cher)
Si des images de référence sont fournies (I2I), chaque image de référence est facturée une fois en supplément ; ces frais sont indépendants de n et n’augmentent pas avec le nombre d’images de sortie
Le prix unitaire est inférieur à celui de Pro : privilégiez ce modèle pour optimiser le coût

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": "qwen-image-3.0",
  "prompt": "Un chat roux portant un casque d'astronaute, sur un fond néon cyberpunk",
  "size": "16:9",
  "quality": "2K"
}
EOF

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 2.2483,
    "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: qwen-image-3.0",
    "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:qwen-image-3.0

requis

Nom du modèle

Options disponibles:

qwen-image-3.0

Exemple:

"qwen-image-3.0"

prompt

string

requis

Invite décrivant l'image à générer (génération à partir de texte) ou la manière d'éditer l'image fournie (édition d'image). Limitée à 4500 tokens

Maximum string length: 4500

Exemple:

"Remplacez l'arrière-plan de cette image"

image_urls

string<uri>[]

Liste d'URLs d'images de référence (facultatif). Sans valeur ou tableau vide = génération à partir de texte (T2I) ; 1 à 3 images = édition d'image (I2I)

Remarque :

Nombre d'images d'entrée prises en charge par requête : 0-3 images, au-delà de 3 une erreur sera renvoyée
Seules les URLs d'images http/https publiques sont prises en charge, base64 / data-url ne le sont pas
La largeur et la hauteur de l'image doivent être dans la plage de [384-3072] pixels
Formats de fichiers pris en charge : .jpg, .jpeg, .png, .bmp, .webp, .tiff
Les URLs d'images doivent être directement accessibles par le serveur, ou l'URL de l'image doit télécharger directement lors de l'accès (généralement ces URLs se terminent par des extensions de fichiers image, telles que .png, .jpg)

Exemple:

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

integer

défaut:1

Spécifie le nombre d'images à générer, prend en charge toute valeur entière entre [1,6]

Remarque :

Chaque requête sera pré-facturée en fonction de la valeur de n, les frais réels sont basés sur le nombre d'images générées
Les frais liés aux images de référence (image_urls) sont facturés une seule fois par image envoyée et n’augmentent pas avec n

Plage requise: 1 <= x <= 6

Exemple:

1

negative_prompt

string

Prompt négatif pour décrire le contenu que vous ne voulez pas voir dans l'image, utilisé pour contraindre la sortie

Remarque :

Prend en charge le chinois et l'anglais, longueur maximale de 500 caractères, chaque caractère chinois/lettre compte comme un caractère, l'excédent sera automatiquement tronqué

Maximum string length: 500

Exemple:

"low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions"

size

string

défaut:auto

Taille de l'image générée, trois méthodes sont prises en charge :

Option 1 - Automatique (par défaut) :

auto : le modèle sélectionne automatiquement une taille de sortie appropriée en fonction du prompt (dans ce cas, quality n'a pas d'effet)

Option 2 - Format de ratio :

1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21
À utiliser avec le paramètre quality ; le système convertit automatiquement en pixels correspondant au ratio et à la résolution, sans spécification manuelle

Option 3 - Format en pixels :

largeur×hauteur, par exemple : 1024x1024, 2048x2048, 2720x1530, etc.
Plage de valeurs du nombre total de pixels : [262144, 4194304] (soit 512×512 à 2048×2048)
Plage de valeurs du rapport largeur/hauteur : [1/16, 16], un côté peut dépasser 2048px
La largeur et la hauteur doivent toutes deux être supérieures à 14px

Remarque :

size et n sont indépendants ; lorsque n>1, il est également possible de spécifier la taille/le ratio
Si size n'est pas fourni, la valeur par défaut est auto

Exemple:

"16:9"

quality

enum<string>

défaut:1K

Niveau de résolution, à utiliser avec le format de ratio de size, par défaut 1K (sans effet en mode auto et en format de pixels).

Ratio	1K	2K
`1:1`	1024×1024	2048×2048
`2:3`	832×1248	1664×2496
`3:2`	1248×832	2496×1664
`3:4`	864×1152	1770×2360
`4:3`	1152×864	2360×1770
`4:5`	896×1120	1792×2240
`5:4`	1120×896	2240×1792
`9:16`	800×1424	1530×2720
`16:9`	1424×800	2720×1530
`21:9`	1568×672	3122×1338
`9:21`	672×1568	1338×3122

Options disponibles:

1K,

2K

Exemple:

"2K"

prompt_extend

boolean

défaut:false

S'il faut activer la réécriture intelligente du prompt. La valeur par défaut est false (ne réécrit pas le prompt de l'utilisateur de sa propre initiative) ; passez explicitement true pour utiliser un grand modèle afin d'optimiser le prompt positif, avec une amélioration notable pour les prompts simples ou insuffisamment descriptifs

Exemple:

true

watermark

boolean

défaut:false

S'il faut ajouter le filigrane "Qwen-Image" dans le coin inférieur droit de l'image. La valeur par défaut est false

Exemple:

false

seed

integer

Graine aléatoire, plage [0, 2147483647], l'utilisation de la même valeur de graine peut maintenir le contenu généré relativement stable

Remarque :

Si non fournie, l'algorithme utilisera automatiquement une graine aléatoire
Le processus de génération du modèle est probabiliste, même avec la même graine, les résultats ne peuvent pas être garantis complètement identiques à chaque fois

Plage requise: 0 <= x <= 2147483647

Exemple:

12345

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:

"qwen-image-3.0"

object

enum<string>

Type de tâche spécifique

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

Qwen Image 3.0

Autorisations

Corps

Réponse