Qwen Image Edit Plus
- Qwen (qwen-image-edit-plus) model supports image editing, image-to-image and other modes
- Asynchronous processing mode, use the returned task ID to query
- Generated image links are valid for 24 hours, please save them promptly
Authorizations
##All APIs require Bearer Token authentication##
Get API Key:
Visit API Key Management Page to get your API Key
Add to request header:
Body
Model name
qwen-image-edit-plus "qwen-image-edit-plus"
Prompt describing the image to generate or how to edit the input image, limited to 2000 tokens
2000"Replace the background of this image"
Reference image URL list
Note:
- Maximum number of input images per request:
3images - 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)
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
1 <= x <= 61
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
500characters, each Chinese character/letter counts as one character, excess will be automatically truncated
500"low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions"
Generated image size, supports pixel format:
- Width x Height, such as:
1024x1024,1024x1536,1536x1024and 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
1024x1024resolution
Note:
- This parameter is only available when the number of output images
nis1, otherwise an error will be returned
^[0-9]+x[0-9]+$"1024x1024"
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
true
Whether to add "Qwen-Image" watermark to the bottom right corner of the image. Default value is false
false
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
0 <= x <= 214748364712345
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
2048characters
Callback Mechanism:
- Timeout:
10seconds - Maximum
3retries on failure (retries after1second/2seconds/4seconds) - 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
"https://your-domain.com/webhooks/image-task-completed"
Response
Image task created successfully
Task creation timestamp
1757156493
Task ID
"task-unified-1757156493-imcg5zqt"
Actual model name used
"qwen-image-edit-plus"
Specific task type
image.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status
pending, processing, completed, failed "pending"
Asynchronous task information
Task output type
text, image, audio, video "image"
Usage and billing information