wavespeed/ultimate-image-upscaler 的 API 参考,由 Comfy Router 从 WaveSpeed 提供。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段则是通过原生 HTTP 发起的同一调用。
模型 ID: wavespeed/ultimate-image-upscaler
端点: POST https://api.comfy.org/v2/models/wavespeed/ultimate-image-upscaler
- 等待结果
- 提交排队,稍后收取
Schema
Input
boolean
默认值:"false"
如果启用,输出将被编码为 BASE64 字符串,而不是 URL。
string
必填
需要 upscale 的图像的 URL。
string
默认值:"\"jpeg\""
输出图像的格式。可选值:
jpeg、png、webpstring
默认值:"\"4k\""
输出图像的目标分辨率。可选值:
2k、4k、8kGET /v2/models/wavespeed/ultimate-image-upscaler/openapi.json 提供的 schema 生成,这也是请求到达提供商之前 Router 用于校验调用的同一份文档。
Output
integer
WavespeedAI 自己的信封状态码,对应 HTTP 状态(在本文档所描述的文档中为 200)。Wavespeed 会把某些失败报告在这里,而不是报告在传输状态中。
object
必填
string
Wavespeed 创建该预测时的 ISO-8601 时间戳。
string
Wavespeed 的自由文本失败原因,没有错误时为空字符串。真正失败的预测会以 Comfy Router 错误的形式到达 Router 调用方,而不是以本文档的形式。
string
Wavespeed 为 Router 提交并轮询的预测分配的标识符。
string
该预测运行所用的 Wavespeed 模型 id。
string[]
必填
已完成的生成结果。在 Router 返回的文档中存在且非空;这个列表就是结果本身。每个元素都是指向已生成内容的 URL:
wavespeed/flashvsr 返回 MP4,两个 upscaler 返回图像;或者,对于这两个图像 id,当请求设置了 enable_base64_output 时,元素是 base64 编码的字节本身。这些链接由 Wavespeed 提供,并且会过期。string
必填
预测的终端状态,按 Wavespeed 的拼写。此处未收窄为枚举:Router 原样转发该值,轮询分类器在比较前会将其转为小写,因此成功状态可以合理地以
completed、succeeded、success 或 done 出现,大小写不限。object
Wavespeed 自己的计时测量。
integer
推理时间,单位为毫秒。这是 Wavespeed 的数字,不是 Comfy 的计费。
object
Wavespeed 为该预测提供的链接。
string
Router 轮询的预测结果 URL。
string
信封状态消息,例如
success。示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。