概述

千问文生图

快速使用

# 设置 API Key（一次性）
set DASHSCOPE_API_KEY=sk-xxxx   # Windows
export DASHSCOPE_API_KEY=sk-xxxx  # macOS/Linux

# 生成图片
python scripts/generate.py --prompt "一只在草地上奔跑的金毛犬" --out dog.png

API Key 配置

方式1：环境变量（推荐）

set DASHSCOPE_API_KEY=sk-你的密钥

方式2：直接传入

python scripts/generate.py --prompt "..." --api-key sk-xxxx --out result.png

API Key 获取地址：北京 https://bailian.console.aliyun.com/cn-beijing | 新加坡 https://modelstudio.console.aliyun.com/ap-southeast-1

> ⚠️ 北京和新加坡地域 API Key 不可混用，选一个地域使用即可。

模型选择

模型	推荐场景	接口	支持图片数
------	---------	------	-----------
`qwen-image-2.0-pro`	文字渲染最强、真实质感最佳	仅同步	1-6张
`qwen-image-2.0`	效果与速度平衡	仅同步	1-6张
`qwen-image-max`	真实感最强、AI痕迹最低	仅同步	仅1张
`qwen-image-plus`	多样艺术风格	仅同步	仅1张

默认使用 qwen-image-2.0-pro（效果最好）。

参数说明

参数	默认值	说明
------	--------	------
`--prompt, -p`	（必填）	正向提示词，中英文均可，最多800字符
`--negative`	空	反向提示词，避免不想要的元素
`--model, -m`	`qwen-image-2.0-pro`	模型名称
`--size, -s`	`2048*2048`	分辨率，qwen-2.0 系列总像素 512²~2048²
`--n`	1	生成数量，max/plus 仅支持1张
`--no-extend`	False	关闭 Prompt 智能改写（默认开启）
`--watermark`	False	添加水印（默认关闭）
`--seed`	随机	随机种子，相同值结果相对稳定
`--out, -o`	自动生成	输出 .png 文件路径

常用分辨率

尺寸	比例	推荐用途
------	------	---------
`2048*2048`	1:1	方形图片
`2688*1536`	16:9	横版海报
`1536*2688`	9:16	竖版海报/手机壁纸
`2368*1728`	4:3	通用横版
`1728*2368`	3:4	通用竖版

使用示例

生成单张图片

python scripts/generate.py -p "冬日故宫角楼，夕阳西下" -o winter.png

生成竖版海报（9:16）

python scripts/generate.py -p "中国风山水画" -s 1536*2688 -o landscape.png

生成4张图（qwen-image-2.0 系列）

python scripts/generate.py -p "赛博朋克城市夜景" -m qwen-image-2.0 -n 4 -o cyberpunk.png

关闭 Prompt 改写（更精确控制细节）

python scripts/generate.py -p "极简风格苹果产品海报" --no-extend -o apple.png

使用随机种子（可复现）

python scripts/generate.py -p "一只白猫" --seed 42 -o cat.png

典型提示词结构

好的文生图提示词应包含：

主体：是什么（人物/动物/物体/场景）
细节：外观特征、颜色、材质
风格：摄影/油画/水彩/3D/中国风等
光线/氛围：晴天/夕阳/夜景、冷暖色调
构图：近景/远景/俯视/仰视

示例：一只橘猫躺在阳光下的窗台上，毛发蓬松，表情慵懒，浅绿色窗帘，午后柔和光线，真实摄影风格，浅色木质房间背景，景深虚化

常见问题

Q: 图片链接有效期多久？

A: 24小时。脚本会自动下载保存到本地。

Q: 生成失败怎么办？

A: 检查 API Key 是否正确、地域是否对应（Beijing Key 用 Beijing 地域）、提示词是否包含敏感词。

Q: 如何提高生成质量？

A: 开启 prompt_extend（默认）让模型优化提示词；加入 negative_prompt 排除畸形/模糊/AI感等；使用 seed 参数固定随机性便于对比。

版本历史

共 1 个版本

v1.0.0 Initial release 当前

2026-05-07 14:31 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)