qwen/qwen-image-3.0-pro 的 API 参考文档,由 Comfy Router 从 Qwen 提供服务。
快速开始
在你的 Comfy 工作区中创建密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 片段是通过原始 HTTP 发起的同一调用。
模型 ID: qwen/qwen-image-3.0-pro
端点: POST https://api.comfy.org/v2/models/qwen/qwen-image-3.0-pro
- Wait for the result
- Queue and collect later
Schema
输入
object
必填
包含请求消息的输入参数对象
object[]
必填
请求内容数组。仅支持单轮对话,因此该数组必须恰好包含一个对象
object[]
必填
消息内容数组。文生图包含一个 text 对象;图像编辑包含 1-3 个 image 对象和一个 text 对象
string
输入图像的 URL 或 Base64 编码数据。图像编辑支持 1-3 张图像
string
描述要生成或编辑的图像内容、风格和构图的正面提示词
string
必填
消息发送者的角色。必须设置为 user可选值:
userstring
用于多模态图像生成与编辑的模型 ID。可选值为 qwen-image-3.0-pro 和 qwen-image-3.0。它不在本 schema 的
required 列表中,因为 Comfy Router 会从 /v2/models/qwen/{model} 的 {model} 路径段中填充它,所以 Router 调用方会省略该字段;而直接以 v1 调用 /proxy/ 路由时必须提供它。object
用于控制图像生成的附加参数
integer
默认值:"1"
输出图像的数量。范围为 1-6,默认为 1范围:
1 到 6string
描述你不希望出现在图像中的内容的负面提示词
boolean
默认值:"true"
是否启用提示词智能改写。默认为 true
string
默认值:"\"direct\""
提示词改写方法,direct(默认,支持 T2I 和 I2I)或 agent(仅支持 T2I)可选值:
direct、agentinteger
用于控制随机性的随机数种子。范围 [0, 2147483647]范围:
0 到 2147483647string
输出图像分辨率,格式为 宽高,例如 10241024。API 接受的像素面积介于 262144 (512512) 与 6553600 (25602560) 之间,宽高比介于 1:8 与 8:1 之间。若未指定,模型会根据提示词自动推荐分辨率
boolean
默认值:"false"
是否添加水印。默认为 false
GET /v2/models/qwen/qwen-image-3.0-pro/openapi.json 提供的 schema 生成,该 schema 也是请求到达提供商之前 Router 校验调用时所依据的同一份文档。
输出
string
失败请求的错误码(请求成功时不返回)
string
失败请求的详细信息(请求成功时不返回)
object
包含模型生成结果
object[]
结果选项列表
string
任务停止的原因。任务正常完成时该值为 stop
object
模型返回的消息
object[]
包含已生成图像信息的消息内容
string
已生成图像的 URL,格式为 PNG。该链接有效期为 24 小时
string
代替图像返回的文本元素。仅带有此字段的元素不会产出任何资源,因此调用方应依据
image 而非内容元素是否存在来判断是否完成string
消息的角色。固定为 assistant
string
唯一请求标识符
object
本次调用的资源使用情况。仅在成功时返回
integer
请求中的输入图像数量。文生图返回 0
string
输入图像计费档位,qima_input_1k 或 qima_input_2k,由输出分辨率的像素面积决定
integer
最终输出图像的高度(像素)
integer
实际返回的输出图像数量
string
输出图像计费档位,qima_output_1k 或 qima_output_2k,由输出分辨率的像素面积决定
integer
最终输出图像的宽度(像素)
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。