Passer au contenu principal
POST
/
v1
/
images
/
generations
Interface qwen-image-edit-plus
curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-edit-plus",
  "prompt": "Replace the background of this image"
}
'
{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-edit-plus",
  "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"
  }
}

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-edit-plus
requis

Nom du modèle

Options disponibles:
qwen-image-edit-plus
Exemple:

"qwen-image-edit-plus"

​
prompt
string
requis

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

Maximum string length: 2000
Exemple:

"Replace the background of this image"

​
image_urls
string<uri>[]
requis

Liste d'URLs d'images de référence

Remarque :

  • Nombre maximum d'images d'entrée par requête : 3 images
  • 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"
]
​
n
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

Taille de l'image générée, prend en charge le format pixel:

  • Largeur x Hauteur, par exemple: 1024x1024, 1024x1536, 1536x1024 et autres valeurs dans la plage
  • Plage de largeur et hauteur: [512, 2048] pixels
  • Si non défini, l'image de sortie conservera un rapport d'aspect similaire à l'image d'origine, proche de la résolution 1024x1024

Remarque:

  • Ce paramètre n'est disponible que lorsque le nombre d'images de sortie n est 1, sinon une erreur sera retournée
Exemple:

"1024x1024"

​
prompt_extend
boolean
défaut:true

S'il faut activer la réécriture intelligente du prompt. Lorsqu'activé, utilise un grand modèle pour optimiser le prompt positif, améliorant considérablement les résultats pour les prompts simples ou insuffisamment descriptifs. La valeur par défaut est true

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

​
id
string

ID de tâche

Exemple:

"task-unified-1757156493-imcg5zqt"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"qwen-image-edit-plus"

​
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

​
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