Skip to main content
qwen/qwen-image-3.0 的 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 端点: POST https://api.comfy.org/v2/models/qwen/qwen-image-3.0

Schema

输入

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