Skip to main content
Use bfl/vto-v1 with the Comfy Router API. Black Forest Labs provides the model; Router gives it the shared authentication and request route below.

​
Quick start

Create a key at platform.comfy.org/profile/api-keys 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

​
Input

​
string
required
Image of one or more garments (maps internally to input_image_2).
​
string
Possible values: jpeg, png, webp
​
string
required
Person image (maps internally to input_image).
​
string
required
Text prompt for VTO generation.
​
integer
default:"2"
Tolerance level for input and output moderation. Between 0 and 5 for public use.Range: 0 to 5
​
integer
Optional seed for reproducibility.
​
string
Optional secret for webhook signature verification.
​
string (uri)
URL to receive webhook notifications.Format: uri
Generated from the schema Router serves at GET /v2/models/bfl/vto-v1/openapi.json, the same document it validates a call against before the request reaches the provider.

​
Output

​
number
Provider-reported cost in credits, populated once the task is Ready.Format: float
​
string
required
BFL task identifier.
​
number
Optional generation progress reported by BFL.Range: 0 to 1Format: float
​
object
required
The finished generation. Not nullable here: this component’s required entry is a promise that a 200 carries the result, and a nullable result would reduce it to a key-presence check.
​
number
Provider-reported cost of the generation. This is BFL’s number, not the Comfy charge.Format: double
​
number
Provider-reported generation duration in seconds.Format: double
​
number
Provider-reported completion time of the generation, in seconds since the Unix epoch. double for the same reason as start_time.Format: double
​
string
The prompt the generation actually ran, after any prompt upsampling.
​
string (uri)
Signed URL for the generated asset. Router re-hosts the asset onto Comfy storage and rewrites this field, so it is normally a Comfy-hosted URL valid for up to 24 hours - signed for 24 hours when minted, and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left; a leaf whose re-host could not be performed keeps BFL’s own short-lived delivery URL instead - roughly two hours for video, roughly ten minutes for images. Either way the link expires, so download the asset rather than storing the URL.Format: uri
​
integer
The seed the generation used, whether supplied or chosen by the provider. Declared int64 because BFL returns seeds above 2^31 (e.g. 2784347701), which an unformatted integer generates as a 32-bit field in many SDK generators.Format: int64
​
number
Provider-reported start time of the generation, in seconds since the Unix epoch. double, not float: float32 spacing near a present-day epoch value is ~128 seconds, which collapses a whole generation’s span to a single decoded value.Format: double
​
string
required
Task status: Pending, Reasoning, Generating, Ready, Request Moderated, Content Moderated, Error, or Task not found.

​
Examples

​
Input

​
Output

​
Before you ship

Save one Idempotency-Key for each call and reuse it for retries. Router can hold the connection for up to 10 minutes. The SDKs handle authentication; raw HTTP clients send the headers themselves. Use X-Comfy-Error-Type to classify a failure. A 422 means Router rejected the input before calling the provider. Download generated assets promptly because result URLs can expire.

Headers

Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.

Using the Router API

Find models, inspect schemas, and retry safely.

Limitations

What Router does not do today, and what to use instead.