Qwen-Image-3.0 生成图片的分辨率,通常取决于调用侧传入的生成参数,而不是单纯靠提示词描述。先确认你使用的是 API 接入还是本地部署,因为两类方式的设置入口不同。下文按前置条件、配置、验证、失败回退四个步骤说明。
前置条件:确认接入方式和版本暴露的参数
先确认当前进程里的 Qwen-Image-3.0 是哪个渠道提供的。不同服务商对图像生成参数命名不一致,常见字段有 size、resolution、width、height 或 image_size。先抓取一次实际请求的入参,或查看服务商 SDK 的模型类定义,确认哪个字段被真实读取。如果使用本地部署,需要检查推理脚本里是否硬编码了输出尺寸。
- API 接入:看接口文档或 SDK 源码,找到生成参数列表中与尺寸相关的键名。
- 本地部署:检查模型加载和推理配置,通常存在全局的默认分辨率设置。
- 提前确认模型版本是否支持动态分辨率,不支持时设置值会被忽略或裁剪。
配置分辨率:参数优先,提示词兜底
在 API 请求中显式传入尺寸参数是最可靠的方式。以下是一个通用接入骨架,字段名按你实际服务商的规范替换。建议先固定一个分辨率,比如 1024x1024,跑通后再验证其他尺寸。
{
"model": "qwen-image-3.0",
"prompt": "一只猫坐在窗台上,自然光",
"size": "1024x1024"
}如果找不到对应参数,可以在提示词里追加分辨率描述,例如“输出一张 1024 宽、1024 高的图片”。这是一种兜底策略,但不能保证所有服务商都识别。部分模型只把提示词当作文本引导,不会精确控制像素,所以验证环节必须做。
判断表可参考:
| 场景 | 优先设置方式 | 验证动作 |
|---|---|---|
| 有 API 参数 | 传 size 或 width/height | 检查返回图片尺寸 |
| 无 API 参数 | 提示词指定分辨率 | 检查输出是否接近指定值 |
| 本地部署 | 修改推理配置中的默认尺寸 | 重启服务后测试 |
验证输出图片尺寸
拿到生成结果后,用脚本或工具确认实际像素尺寸,不要相信返回的元数据,因为有些网关可能压缩过。推荐用 Python PIL 读取,命令如下:
from PIL import Image
img = Image.open("output.png")
print(img.size)或者用 ImageMagick:
identify output.png验证清单:
- 输出尺寸是否与请求一致。
- 如果不一致,是否被等比缩放或裁剪。
- 重复生成两次,确认尺寸行为稳定。
- 用不同分辨率(如 512、1024、2048)各测试一次,确认参数是否对所有值生效。
分辨率设置不生效时的回退
如果参数传了但输出尺寸没变化,按顺序检查以下几项。
- 字段名或参数格式是否正确:有的接口要求小写,有的要求用“分辨率”而不是“尺寸”。先尝试同义词。
- 是否被服务商策略覆盖:某些版本会强制固定分辨率,设置无效,需要换接口或降级到支持尺寸的版本。
- 本地部署时,检查模型配置是否被推理代码覆盖:搜索代码里的“resize”“size”相关赋值。
- 提示词里描述与参数冲突:如果同时存在,以接口参数为准,但提示词中的数字可能引起模型产生不同构图,建议测试时保持提示词一致。
最后,如果所有常规手段都无效,可以直接在服务商控制台或模型配置中心查看是否开放了分辨率选项。若当前版本不开放,只能接受默认尺寸,或换用其他图像生成模型。