Skip to main content
POST
/
v1
/
images
/
generations
qwen-image-edit-plus Interface
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"
  }
}

Authorizations

​
Authorization
string
header
required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header when using:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
default:qwen-image-edit-plus
required

Model name

Available options:
qwen-image-edit-plus
Example:

"qwen-image-edit-plus"

​
prompt
string
required

Prompt describing the image to generate or how to edit the input image, limited to 2000 tokens

Maximum string length: 2000
Example:

"Replace the background of this image"

​
image_urls
string<uri>[]
required

Reference image URL list

Note:

  • Maximum number of input images per request: 3 images
  • Image width and height must be within [384-3072] pixel range
  • Supported file formats: .jpg, .jpeg, .png, .bmp, .webp, .tiff
  • Image URLs must be directly accessible by the server, or the image URL should directly download when accessed (typically these URLs end with image file extensions, such as .png, .jpg)
Example:
[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
​
n
integer
default:1

Specifies the number of images to generate, supports any integer value between [1,6]

Note:

  • Each request will be pre-charged based on the value of n, actual charges are based on the number of images generated
Required range: 1 <= x <= 6
Example:

1

​
negative_prompt
string

Negative prompt to describe content you don't want to see in the image, used to constrain the output

Note:

  • Supports Chinese and English, maximum length of 500 characters, each Chinese character/letter counts as one character, excess will be automatically truncated
Maximum string length: 500
Example:

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

​
size
string

Generated image size, supports pixel format:

  • Width x Height, such as: 1024x1024, 1024x1536, 1536x1024 and other values within range
  • Width and height range: [512, 2048] pixels
  • If not set, output image will maintain aspect ratio similar to original image, close to 1024x1024 resolution

Note:

  • This parameter is only available when the number of output images n is 1, otherwise an error will be returned
Example:

"1024x1024"

​
prompt_extend
boolean
default:true

Whether to enable intelligent prompt rewriting. When enabled, uses a large model to optimize the positive prompt, significantly improving results for simple or insufficiently descriptive prompts. Default value is true

Example:

true

​
watermark
boolean
default:false

Whether to add "Qwen-Image" watermark to the bottom right corner of the image. Default value is false

Example:

false

​
seed
integer

Random seed, range [0, 2147483647], using the same seed value can keep generated content relatively stable

Note:

  • If not provided, the algorithm will automatically use a random seed
  • Model generation process is probabilistic, even with the same seed, results cannot be guaranteed to be completely identical each time
Required range: 0 <= x <= 2147483647
Example:

12345

​
callback_url
string<uri>

HTTPS callback address after task completion

Callback Timing:

  • Triggered when task is completed, failed, or cancelled
  • Sent after billing confirmation is completed

Security Restrictions:

  • Only HTTPS protocol is supported
  • Callback to internal IP addresses is prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • URL length must not exceed 2048 characters

Callback Mechanism:

  • Timeout: 10 seconds
  • Maximum 3 retries on failure (retries after 1 second/2 seconds/4 seconds)
  • Callback response body format is consistent with the task query API response format
  • Callback address returning 2xx status code is considered successful, other status codes will trigger retry
Example:

"https://your-domain.com/webhooks/image-task-completed"

Response

Image task created successfully

​
created
integer

Task creation timestamp

Example:

1757156493

​
id
string

Task ID

Example:

"task-unified-1757156493-imcg5zqt"

​
model
string

Actual model name used

Example:

"qwen-image-edit-plus"

​
object
enum<string>

Specific task type

Available options:
image.generation.task
​
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

​
status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

​
task_info
object

Asynchronous task information

​
type
enum<string>

Task output type

Available options:
text,
image,
audio,
video
Example:

"image"

​
usage
object

Usage and billing information