Skip to main content
bfl/vto-v1 的 API 参考文档，由 Black Forest Labs 的 Comfy Router 提供。

​
Quick start

Create a key in your Comfy workspace and export it as COMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk, npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP. Model ID: bfl/vto-v1 Endpoint: POST https://api.comfy.org/v2/models/bfl/vto-v1

​
Schema

​
输入

​
string
必填
一件或多件服装的图像（内部映射到 input_image_2）。
​
string
可选值：jpeg、png、webp
​
string
必填
人物图像（内部映射到 input_image）。
​
string
必填
用于 VTO 生成的文本提示词。
​
integer
默认值:"2"
输入和输出审核的阈值。公开使用时介于 0 和 5 之间。范围：0 到 5
​
integer
可选种子，用于结果复现。
​
string
用于 webhook 签名校验的可选密钥。
​
string (uri)
接收 webhook 通知的 URL。格式：uri
本文档由 Router 在 GET /v2/models/bfl/vto-v1/openapi.json 提供的 schema 生成，Router 在请求到达提供商之前，正是用这同一份文档来校验调用。

​
输出

​
number
提供商上报的积分成本，任务进入 Ready 后填充。格式：float
​
string
必填
BFL 任务标识符。
​
number
BFL 上报的可选生成进度。范围：0 到 1格式：float
​
object
必填
已完成的生成结果。此处不可为空：该组件的 required 条目承诺 200 响应会携带结果，而可空的 result 会使其退化为仅检查键是否存在。
​
number
提供商上报的本次生成成本。这是 BFL 的数字，而非 Comfy 的计费。格式：double
​
number
提供商上报的生成时长，单位为秒。格式：double
​
number
提供商上报的生成完成时间，以 Unix 纪元以来的秒数表示。与 start_time 同理使用 double。格式：double
​
string
生成实际运行的提示词，即经过任何提示词上采样之后的版本。
​
string (uri)
已生成资产的签名 URL。Router 会把该资产重新托管到 Comfy 存储并重写此字段，因此它通常是 Comfy 托管的 URL，有效期最长 24 小时：签发时按 24 小时签名，并从 23 小时的备忘中重放，因此稍后轮询返回的 URL 可能仅剩一小时有效期；如果某个叶子节点无法完成重新托管，则保留 BFL 自己的短时效分发 URL：视频约两小时，图像约十分钟。无论哪种情况，链接都会过期，因此请下载资产，而不要存储该 URL。格式：uri
​
integer
生成所使用的种子，无论是提供的还是由提供商选择的。声明为 int64，因为 BFL 会返回大于 2^31 的种子（例如 2784347701），而未加格式约束的 integer 在许多 SDK 生成器中会生成 32 位字段。格式：int64
​
number
提供商上报的生成开始时间，以 Unix 纪元以来的秒数表示。使用 double 而非 float：在当前纪元的数值附近，float32 的间距约为 128 秒，会把一次生成的完整时间跨度坍缩成单个解码值。格式：double
​
string
必填
任务状态：Pending、Reasoning、Generating、Ready、Request Moderated、Content Moderated、Error 或 Task not found。

​
Examples

​
Input

​
Output

​
发布前须知

SDK 会生成 Idempotency-Key 并在自动重试中复用它。手动重试时，请复用原始 key。Router 最长可保持连接 10 分钟。 请求失败时，Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载，因为结果链接会过期。

请求头

身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。

使用 Router API

模型发现、校验错误、重试与计费。

限制

Router 目前不支持的功能，以及替代方案。