prompt | string | yes | — | Text prompt. With input images attached, becomes an editing instruction. |
model | enum | no | "qwen-image-2.0-pro-2026-04-22" | Pro variants support higher quality + the dated snapshots pin a specific weights revision for reproducibility. · Allowed: qwen-image-2.0-pro-2026-04-22, qwen-image-2.0-pro-2026-03-03, qwen-image-2.0-pro, qwen-image-2.0 |
aspect_ratio | enum | no | — | Optional. If omitted, text-to-image defaults to 16:9; image-edit matches the last input image’s native ratio. · Allowed: 16:9, 9:16, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5 |
use_custom_size | boolean | no | false | Override aspect_ratio with explicit pixel dimensions. |
custom_width | number | no | — | Pixels (512–2048). Total pixel area must be in [512×512, 2048×2048]. Only when use_custom_size=true. · Range: 512 – 2048 |
custom_height | number | no | — | Pixels (512–2048). Total pixel area must be in [512×512, 2048×2048]. Only when use_custom_size=true. · Range: 512 – 2048 |
image | array | no | — | Up to 3 input image URLs. Triggers image-edit mode. |
num_images | number | no | 1 | Number of images to generate. Each is billed separately. · Range: 1 – 6 |
negative_prompt | string | no | "" | What to avoid in the output. |
prompt_extend | boolean | no | true | Let DashScope rewrite the prompt for better results. |
watermark | boolean | no | false | Add an EmpirioLabs watermark to the output. |
seed | number | no | — | Reproducibility seed. Leave empty for random. · Range: 0 – 2147483647 |
response_format | enum | no | "url" | Allowed: url, b64_json |