fal/crystal-video-upscaler 的 API 参考,由 Comfy Router 从 fal 提供。
输入: 视频 · 输出: 视频
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk 和 npm install @comfyorg/sdk);cURL 代码片段则是通过原生 HTTP 发起的同一调用。
模型 ID: fal/crystal-video-upscaler
端点: POST https://api.comfy.org/v2/models/fal/crystal-video-upscaler
- 等待结果
- 排队并稍后收集结果
相同的请求体,发送至
POST https://api.comfy.org/v2/models/fal/crystal-video-upscaler/requests。运行一经受理,Router 就会返回 201 以及一个 request_id,结果准备就绪后即可收集,无论是本进程还是其他进程都可以。有关状态、取消和收集的说明,请参阅队列投递。Schema
输入
number
默认值:"2"
应用于输入视频每条边的缩放系数。放大后的视频不得超过 5K。fal 按每秒输出兆像素计费,因此价格随该值的平方增长。范围:
1 到 200string
必填
输入视频的 URL(MP4、MOV、WebM、M4V 或 GIF)。
GET /v2/models/fal/crystal-video-upscaler/openapi.json 提供的 schema 生成,这也是它在请求到达提供商之前校验调用所用的同一份文档。
输出
object
必填
放大后的视频文件。
string
视频文件的 MIME 类型。
number
视频时长,单位为秒。
string
视频文件的名称。
integer
视频文件的大小,单位为字节。
number
视频的帧率。
integer
视频的高度,单位为像素。
integer
视频的帧数。
string
必填
放大后视频的 URL。
integer
视频的宽度,单位为像素。
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入,413 表示请求体超出了 Router 可接受的大小。已生成的资源请及时下载,因为结果 URL 会过期。
上文任何字段描述中提到的尺寸限制,都是提供商对该字段自身的限定,引自提供商的规范。Router 会对整个请求体另行设置上限,base64 编码的媒体内容也计入其中:参见请求体大小。
本页记录的是通过 Comfy Router 调用的某一个合作伙伴模型。同一个 comfy-sdk / @comfyorg/sdk 包还提供第二个客户端,用于在 Comfy Cloud 上运行完整的 ComfyUI 工作流图:Comfy(api_key=...) / new Comfy({ apiKey }),并带有 client.workflows、client.assets 和 client.jobs。请参阅 Comfy SDKs。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、验证错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。