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-pro",
  "prompt": "Un chat roux portant un casque d'astronaute, sur un fond néon cyberpunk"
}
EOF

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

🚧 Ce modele n’est pas encore disponible, restez a l’ecoute

Le modèle Qwen (qwen-image-3.0-pro) prend en charge 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)
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

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-pro",
  "prompt": "Un chat roux portant un casque d'astronaute, sur un fond néon cyberpunk"
}
EOF

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

requis

Nom du modèle

Options disponibles:

qwen-image-3.0-pro

Exemple:

"qwen-image-3.0-pro"

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

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, auto par défaut :

auto (par défaut) : le modèle choisit automatiquement une taille de sortie appropriée
largeurxhauteur : par exemple 1024x1024, 1024x1536, 1536x1024, etc., la largeur et la hauteur étant toutes deux dans la plage [512, 2048] pixels

Remarque :

La spécification explicite de la taille n'est disponible que lorsque le nombre d'images de sortie n est 1, sinon une erreur sera renvoyée ; auto n'est pas soumis à cette limite

Exemple:

"1024x1024"

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-pro"

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

Z Image Turbo Génération d'Image Qwen Image Edit Plus

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 Pro

Autorisations

Corps

Réponse