qwen/qwen-image-3.0 的 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
端点: POST https://api.comfy.org/v2/models/qwen/qwen-image-3.0
- Wait for the result
- Queue and collect later
Schema
输入
object
必填
包含请求消息的输入参数对象
object[]
必填
请求内容数组。仅支持单轮对话,因此该数组必须恰好包含一个对象
object[]
必填
消息内容数组。文生图包含一个 text 对象;图像编辑包含 1-3 个图像对象和一个 text 对象
string
输入图像的 URL 或 Base64 编码数据。图像编辑支持 1-3 张图像
string
正面提示词,描述要生成或编辑的图像内容、风格和构图
string
必填
消息发送者的角色。必须设置为 userPossible values:
userstring
用于多模态图像生成和编辑的模型 ID。可用值为 qwen-image-3.0-pro 和 qwen-image-3.0。它不在本 schema 的
required 列表中,因为 Comfy Router 会从 /v2/models/qwen/{model} 的 {model} 路径段中填充它,所以 Router 调用方会省略它;而直接向 /proxy/ 路由发起的 v1 调用则必须提供它。object
用于控制图像生成的附加参数
integer
默认值:"1"
输出图像的数量。范围 1-6,默认为 1Range:
1 to 6string
负面提示词,描述你不希望在图像中出现的内容
boolean
默认值:"true"
是否启用智能提示词重写。默认为 true
string
默认值:"\"direct\""
提示词重写方法,direct(默认,T2I 和 I2I 均支持)或 agent(仅 T2I)Possible values:
direct, agentinteger
用于控制随机性的随机数种子。范围 [0, 2147483647]Range:
0 to 2147483647string
输出图像分辨率,格式为 widthheight,例如 10241024。API 接受的像素面积介于 262144 (512512) 和 6553600 (25602560) 之间,宽高比介于 1:8 和 8:1 之间。如果未指定,模型会根据提示词自动推荐分辨率
boolean
默认值:"false"
是否添加水印。默认为 false
GET /v2/models/qwen/qwen-image-3.0/openapi.json 提供的 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 目前不支持的功能,以及替代方案。