Qwen Image Gen

通过阿里云百炼 Qwen-Image 接口生成图片。默认使用 qwen-image-2.0-pro，支持按模型自动选择同步/异步模式，并在成功后下载 PNG 到本地。

详细接口、尺寸限制、价格表见 references/api.md。

Setup

1. 1. 配置 API Key：

bash
export DASHSCOPEAPIKEY=sk-xxx

也可以在 skill 目录下创建 config.json，参考 config.example.json。

1. 2. 运行环境要求 Node.js >= 18

1. 3. 北京和新加坡地域使用不同的 API Key 与 Base URL，不能混用

配置优先级：

• - CLI 参数
• 环境变量
• config.json
• 脚本默认值

默认模型

• - 默认模型：qwen-image-2.0-pro
• qwen-image-2.0-pro、qwen-image-2.0、qwen-image-max 走同步接口
• qwen-image-plus、qwen-image 走异步接口

支持范围

• - qwen-image-2.0-pro / qwen-image-2.0：支持 1-6 张，适合通用文生图
• qwen-image-max：固定 1 张，偏真实感
• qwen-image-plus / qwen-image：固定 1 张，支持异步任务
• 图片输出格式为 png
• 任务和结果链接默认保留 24 小时，拿到后要尽快下载

CLI

主要脚本：node scripts/qwen-image-gen.js

默认出图

bash
node scripts/qwen-image-gen.js \
--prompt=一间有着精致窗户的花店，漂亮的木质门，摆放着花朵 \
--goal=quality

低成本试探

bash
node scripts/qwen-image-gen.js \
--prompt=一个赛博朋克风格的雨夜街道 \
--goal=cheap \
--n=1

异步任务

bash
node scripts/qwen-image-gen.js \
--prompt=复古海报风格的城市街景 \
--model=qwen-image-plus \
--mode=async

继续查询已有任务

bash
node scripts/qwen-image-gen.js \
--task-id=你的task_id

仅做预检

bash
node scripts/qwen-image-gen.js \
--prompt=一张产品海报，主体是一瓶绿色玻璃香水 \
--ratio=3:4 \
--dry-run

参数约定

• - --prompt：正向提示词，提交新任务时必填
• --negative-prompt：反向提示词，建议控制在 500 字符内
• --goal=cheap|balanced|quality：按用户意图选择默认模型和尺寸
• --tier=draft|standard|final：按档位选择模型
• --model：模型名，默认 qwen-image-2.0-pro
• --mode=auto|sync|async：自动选择或强制接口模式
• --ratio：快捷比例

• - --size：具体分辨率，如 2048*2048
• --n：张数

• - --prompt-extend=true|false：是否启用提示词改写，默认 true
• --watermark=true|false：是否添加水印，默认 false
• --task-id：查询已有异步任务
• --no-wait：只提交异步任务，不继续轮询
• --poll-interval：轮询间隔秒数，默认 10
• --timeout：总等待超时秒数，默认 600
• --output-dir：图片下载目录，默认 outputs/
• --name：输出文件名前缀
• --dry-run：只打印最终请求体和配置预检

工作流

1. 1. 用户要生图时，优先提交新任务而不是直接假定已有结果。
2. qwen-image-2.0-pro / qwen-image-2.0 / qwen-image-max 直接同步出图并下载。
3. qwen-image-plus / qwen-image 走异步任务，返回 task_id 后轮询。
4. 成功后立即下载生成结果到本地 outputs/。
5. 需要稳定复现时，显式传 --seed。

价格提醒

• - 价格按中国内地单价表估算；如果使用新加坡地域，脚本会切换到国际单价表
• 计费按成功生成的图片张数计算
• 免费额度和单价会随官方更新变化，需同步更新脚本内置表