Skip to main content
qwen/qwen-image-3.0-pro 的 API 参考文档,由 Comfy Router 从 Qwen 提供服务。

快速开始

你的 Comfy 工作区中创建密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 片段使用 Comfy SDK(pip install comfy-sdknpm 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

Schema

输入

object
必填
包含请求消息的输入参数对象
object[]
必填
请求内容数组。仅支持单轮对话,因此该数组必须恰好包含一个对象
object[]
必填
消息内容数组。文生图包含一个 text 对象;图像编辑包含 1-3 个 image 对象和一个 text 对象
string
输入图像的 URL 或 Base64 编码数据。图像编辑支持 1-3 张图像
string
描述要生成或编辑的图像内容、风格和构图的正面提示词
string
必填
消息发送者的角色。必须设置为 user可选值:user
string
用于多模态图像生成与编辑的模型 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范围:16
string
描述你不希望出现在图像中的内容的负面提示词
boolean
默认值:"true"
是否启用提示词智能改写。默认为 true
string
默认值:"\"direct\""
提示词改写方法,direct(默认,支持 T2I 和 I2I)或 agent(仅支持 T2I)可选值:directagent
integer
用于控制随机性的随机数种子。范围 [0, 2147483647]范围:02147483647
string
输出图像分辨率,格式为 宽高,例如 10241024。API 接受的像素面积介于 262144 (512512) 与 6553600 (25602560) 之间,宽高比介于 1:8 与 8:1 之间。若未指定,模型会根据提示词自动推荐分辨率
boolean
默认值:"false"
是否添加水印。默认为 false
本文档根据 Router 在 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 目前不支持的功能,以及替代方案。