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 argument -
DASHSCOPE_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:91536*2688— 9:162368*1728— 4:31728*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 密钥和端点——请勿混用。
Scan to join WeChat group