Skip to Content

Qwen Image

OpenAI Images
图片生成与编辑POST /v1/images/generations
qwen-image-3.0qwen-image-3.0-pro

模型能力

两个模型均支持文生图和参考图编辑,支持中文与英文提示词。编辑时可传入 1 至 3 张公网图片 URL。输出为 PNG;未指定尺寸时由模型根据提示词选择分辨率。

请求参数

参数类型必填说明
modelstring是qwen-image-3.0 或 qwen-image-3.0-pro。
promptstring是描述要生成或编辑的画面,支持中文和英文。
sizestring否输出尺寸,格式为 宽x高;宽高比为 1:8 至 8:1,像素面积为 512×512 至 2048×2048。省略时由模型选择尺寸。
ninteger否生成数量,取值 1 至 6,默认 1。费用按实际生成图片数量核算,具体费率以平台显示为准。
response_formatstring否url 或 b64_json,默认 url。
inputobject否参考图编辑输入,包含 messages。
input.messagesarray否参考图编辑使用。包含一个 role: “user” 消息,其 content 按顺序包含图片 URL 和编辑提示词;最多传入 3 张图片。
input.messages[].rolestring条件必填固定为 user。
input.messages[].content[].imagestring条件必填参考图片的公网 HTTP(S) URL。编辑场景传入 1 至 3 张。
input.messages[].content[].textstring条件必填描述参考图片的编辑方式。
parametersobject否模型参数,包含以下可选字段。
parameters.sizestring否尺寸格式与 size 相同。使用 parameters 时,请将尺寸放在此字段中。
parameters.ninteger否生成数量,取值 1 至 6;设置后优先于顶层 n。
parameters.prompt_extendboolean否是否启用提示词智能改写,默认 true。
parameters.seedinteger否随机种子,取值 0 至 2147483647。使用相同种子可提高结果稳定性。
parameters.watermarkboolean否是否添加水印,默认 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 } }'

响应

字段类型说明
createdinteger响应创建时间,Unix 时间戳。
data[].urlstringresponse_format 为 url 时返回的图片地址。
data[].b64_jsonstringresponse_format 为 b64_json 时返回的 Base64 图片内容。
data[].revised_promptstring启用提示词改写后可能返回的改写提示词。
{ "created": 1788339600, "data": [ { "url": "https://example.com/generated-image.png" } ] }

图片链接有效期为 24 小时,请及时保存生成结果。

官方参考:Qwen Image 生成与编辑 API

Last updated on