Qwen Image
模型能力
两个模型均支持文生图和参考图编辑,支持中文与英文提示词。编辑时可传入 1 至 3 张公网图片 URL。输出为 PNG;未指定尺寸时由模型根据提示词选择分辨率。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | qwen-image-3.0 或 qwen-image-3.0-pro。 |
prompt | string | 是 | 描述要生成或编辑的画面,支持中文和英文。 |
size | string | 否 | 输出尺寸,格式为 宽x高;宽高比为 1:8 至 8:1,像素面积为 512×512 至 2048×2048。省略时由模型选择尺寸。 |
n | integer | 否 | 生成数量,取值 1 至 6,默认 1。费用按实际生成图片数量核算,具体费率以平台显示为准。 |
response_format | string | 否 | url 或 b64_json,默认 url。 |
input | object | 否 | 参考图编辑输入,包含 messages。 |
input.messages | array | 否 | 参考图编辑使用。包含一个 role: “user” 消息,其 content 按顺序包含图片 URL 和编辑提示词;最多传入 3 张图片。 |
input.messages[].role | string | 条件必填 | 固定为 user。 |
input.messages[].content[].image | string | 条件必填 | 参考图片的公网 HTTP(S) URL。编辑场景传入 1 至 3 张。 |
input.messages[].content[].text | string | 条件必填 | 描述参考图片的编辑方式。 |
parameters | object | 否 | 模型参数,包含以下可选字段。 |
parameters.size | string | 否 | 尺寸格式与 size 相同。使用 parameters 时,请将尺寸放在此字段中。 |
parameters.n | integer | 否 | 生成数量,取值 1 至 6;设置后优先于顶层 n。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写,默认 true。 |
parameters.seed | integer | 否 | 随机种子,取值 0 至 2147483647。使用相同种子可提高结果稳定性。 |
parameters.watermark | boolean | 否 | 是否添加水印,默认 false。 |
调用示例
文生图
curl "https://api.example.com/v1/images/generations" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-3.0-pro",
"prompt": "一只坐在窗边的橘猫,柔和的午后阳光,写实摄影",
"n": 1,
"response_format": "url",
"parameters": {
"size": "1024x1024",
"prompt_extend": true,
"seed": 12345,
"watermark": false
}
}'响应
| 字段 | 类型 | 说明 |
|---|---|---|
created | integer | 响应创建时间,Unix 时间戳。 |
data[].url | string | response_format 为 url 时返回的图片地址。 |
data[].b64_json | string | response_format 为 b64_json 时返回的 Base64 图片内容。 |
data[].revised_prompt | string | 启用提示词改写后可能返回的改写提示词。 |
{
"created": 1788339600,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}图片链接有效期为 24 小时,请及时保存生成结果。
官方参考:Qwen Image 生成与编辑 API
Last updated on