Qwen Image
千问图像生成与编辑助手。支持文生图、图像编辑（增删改元素 / 修改文字 / 风格迁移）、多图融合。擅长复杂中文文字渲染，可生成海报、封面、展板、宣传图等商用素材。触发词：生成图片、画图、做海报、P图、改图、修图、抠图、换背景、加文字、融合图片。
Generate and edit images using Alibaba Cloud's Qwen Image API (千问图像).
Qwen Image AI generation & editing assistant. Supports text-to-image, image editing (add/remove/change elements, modify text, style transfer), and multi-image fusion. Excels at complex Chinese text rendering, produces commercial assets like posters, covers, banners, and promotional graphics. Triggers: generate image, image editing, text-to-image, poster design, make a poster, photo editing, image fusion.
使用阿里云千问图像 API 生成与编辑图像。
千问图像 AI 生成与编辑助手。支持文生图、图像编辑（增删改元素、修改文字、风格迁移）以及多图融合。擅长复杂中文文字渲染，可生成海报、封面、展板、宣传图等商用素材。触发词：生成图片、画图、做海报、P图、改图、修图、抠图、换背景、加文字、融合图片。
Usage
用法
Text-to-Image
文生图
Generate an image (returns URL only):
生成图像（仅返回 URL）：
python {baseDir}/scripts/generate_image.py --prompt "一只橘猫坐在窗台上晒太阳"
Generate and save locally:
生成并保存到本地：
python {baseDir}/scripts/generate_image.py --prompt "a beautiful sunset over mountains" --filename sunset.png
With custom size:
自定义尺寸生成：
python {baseDir}/scripts/generate_image.py --prompt "城市夜景" --size "2688*1536" --filename city.png
Generate multiple images:
生成多张图像：
python {baseDir}/scripts/generate_image.py --prompt "水彩风格的花卉" --n 4 --filename flower.png
Image Editing
图像编辑
Single image editing:
单图编辑：
python {baseDir}/scripts/generate_image.py --images photo.png --prompt "在画面左下角加一只猫" --filename edited.png
Multi-image fusion (up to 3 images):
多图融合（最多 3 张图像）：
python {baseDir}/scripts/generate_image.py --images bg.png style.png --prompt "将图二的风格应用到图一" --filename fused.png
Edit with a URL input:
通过 URL 输入进行编辑：
python {baseDir}/scripts/generate_image.py --images https://example.com/photo.jpg --prompt "remove the text on the wall" --filename cleaned.png
Use dedicated edit model:
使用专用编辑模型：
python {baseDir}/scripts/generate_image.py --images input.png --prompt "把天空改成星空" -m qwen-image-edit-max --filename starry.png
API Key
API 密钥
Obtain the API key in the following order:
按以下优先级获取 API 密钥：
--api-keycommand line argumentDASHSCOPE_API_KEYenvironment variable-
Get your API key from: https://dashscope.console.aliyun.com/
-
--api-key命令行参数 DASHSCOPE_API_KEY环境变量- 从以下地址获取 API 密钥：https://dashscope.console.aliyun.com/
Models
模型
| Model | Mode | Description |
|---|---|---|
qwen-image-2.0-pro |
generate + edit (default) | Best text rendering & realism |
qwen-image-2.0 |
generate + edit | Faster, balanced quality |
qwen-image-edit-max |
edit | Strongest editing: industrial design, geometry, character consistency |
qwen-image-edit-plus |
edit | Multi-output & custom resolution |
qwen-image-edit |
edit | Basic single-image editing |
| 模型 | 模式 | 说明 |
|---|---|---|
qwen-image-2.0-pro |
生成 + 编辑（默认） | 最佳文字渲染与写实效果 |
qwen-image-2.0 |
生成 + 编辑 | 更快速，质量均衡 |
qwen-image-edit-max |
编辑 | 最强编辑能力：工业设计、几何精度、角色一致性 |
qwen-image-edit-plus |
编辑 | 多输出与自定义分辨率 |
qwen-image-edit |
编辑 | 基础单图编辑 |
Options
参数选项
--images / -i — Input image(s) for editing (1-3 local paths or URLs). Omit for text-to-image.
--images / -i — 用于编辑的输入图像（1-3 个本地路径或 URL）。文生图时无需指定。
--size / -s — Output resolution WxH. Omit to auto-match input image ratio.
--size / -s — 输出分辨率 宽x高。省略时自动匹配输入图像比例。
- qwen-image-2.0 series (512x512 ~ 2048x2048):
- qwen-image-2.0 系列（512x512 ~ 2048x2048）：
- 2048*2048 — 1:1 (default when generating) / 1:1（生成时默认）
- 2688*1536 — 16:9
- 1536*2688 — 9:16
- 2368*1728 — 4:3
- 1728*2368 — 3:4
- Edit models (width & height each in [512, 2048]):
- 编辑模型（宽高各在 [512, 2048] 范围内）：
- 1024*1024, 1536*1024, 1024*1536, 1280*960, 720*1280, etc.
--n — Number of output images (1-6, default: 1). Not supported on qwen-image-edit.
--n — 输出图像数量（1-6，默认：1）。qwen-image-edit 模型不支持。
--negative-prompt / -n — Elements to avoid (default: common AI artifacts).
--negative-prompt / -n — 需要避免的元素（默认：常见 AI 伪影）。
--no-prompt-extend — Disable automatic prompt enhancement (enabled by default).
--no-prompt-extend — 禁用自动提示词增强（默认启用）。
--seed — Random seed [0, 2147483647] for reproducible results.
--seed — 随机种子 [0, 2147483647]，用于生成可复现的结果。
--watermark — Add "Qwen-Image" watermark to the output.
--watermark — 在输出图像上添加"Qwen-Image"水印。
--region — beijing (default) or singapore. Singapore requires --workspace-id.
--region — beijing（默认）或 singapore。新加坡区域需要 --workspace-id。
--no-verify-ssl — Disable SSL verification (use behind corporate proxy).
--no-verify-ssl — 禁用 SSL 验证（在企业代理网络后使用）。
Workflow
工作流程
- If the user provides images, pass them via
--images(local paths or URLs). - Execute
generate_image.pywith the user's prompt and options. - Parse the output for lines starting with
MEDIA_URL:. - Display each image using markdown:
. -
Do NOT download or save the image unless the user specifically requests it (use
--filename). -
如果用户提供了图像，通过
--images参数传入（本地路径或 URL）。 - 使用用户的提示词和选项执行
generate_image.py。 - 解析输出中以
MEDIA_URL:开头的行。 - 使用 markdown 格式展示每张图像：
。 - 除非用户明确要求，否则不要下载或保存图像（使用
--filename指定保存）。
Notes
注意事项
- Supports both Chinese and English prompts.
- Image editing accepts local files (auto Base64-encoded, max 10MB) or URLs (http/https/oss).
- Output images are PNG format. Image URLs expire in 24 hours.
qwen-image-editmodel does not support--sizeor--no-prompt-extend.- Default negative prompt helps avoid common AI artifacts (distorted limbs, low quality, etc.).
-
Beijing and Singapore regions have independent API keys and endpoints — do not mix.
-
支持中英文提示词。
- 图像编辑支持本地文件（自动 Base64 编码，最大 10MB）或 URL（http/https/oss）。
- 输出图像为 PNG 格式。图像 URL 在 24 小时后过期。
qwen-image-edit模型不支持--size和--no-prompt-extend参数。- 默认的反向提示词有助于避免常见 AI 伪影（肢体扭曲、低质量等）。
- 北京和新加坡区域拥有独立的 API 密钥和端点——请勿混用。
