| model | string | Yes | Model name, e.g. qwen-image-edit-plus. |
| input | object | Yes | Input object. |
| └─ messages | array | Yes | Message list. |
| └─ └─ role | string | Yes | Role, usually user. |
| └─ └─ content | array | Yes | Array containing image and text. |
| └─ └─ └─ image | string | Yes | - Formats: JPG, JPEG, PNG, BMP, TIFF, WEBP, GIF.
- Output format is PNG; for GIF input, only the first frame is processed.
- Recommended resolution: both width and height between 384 and 3072 pixels.
- File size: <=10MB.
- For file uploads, the platform auto-converts to base64. For public URLs, use Qwen-format parameters.
Supported input forms:
1) Public URL (HTTP/HTTPS), e.g.
2) Temporary OSS URL (obtained via upload), e.g.
3) Base64 string, e.g. |
| └─ └─ └─ text | string | Yes | Positive prompt describing target content/style/composition.
Supports Chinese/English, max 800 chars (extra chars truncated).
Example: Make the girl in image 1 wear the black dress from image 2 and sit in the pose from image 3, while keeping hairstyle/expression unchanged and motion natural.
Note: content must contain exactly one text object, otherwise the request fails. |
| parameters | object | No | Control parameters. |
| └─ n | integer | No | Number of output images, default 1.
For qwen-image-2.0 series, qwen-image-edit-max, qwen-image-edit-plus series: 1-6 images.
For qwen-image-edit: only 1 image. |
| └─ negative_prompt | string | No | Negative prompt for undesired content.
Supports Chinese/English, max 500 chars (extra truncated).
Example: low resolution, errors, worst quality, low quality, missing parts, extra fingers, bad proportions, etc. |
| └─ watermark | boolean | No | Add watermark or not. |
| └─ seed | integer | No | Random seed in [0,2147483647].
Same seed can improve consistency, but exact reproducibility is not guaranteed. |
