Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions .github/scripts/snippets/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,10 +80,11 @@ commit.
Every runnable Quick start is a tab pair: **Wait for the result** is the
`models.run` call, **Queue and collect later** is the same body through
`models.submit`, polled to completion and collected. Both tabs are emitted from
the one `example`, so they cannot disagree about the request. The queued tab
opens with `snippets/comfy-router/queue-preview-notice.mdx` while that file
exists, on the same existence rule as the preview banner: once queued delivery
is on for every workspace, `rm` the snippet and regen.
the one `example`, so they cannot disagree about the request. During the
gated preview the queued tab opened with
`snippets/comfy-router/queue-preview-notice.mdx`, on the same existence rule as
the preview banner; the file was removed once the queue was on for every
workspace, and recreating it brings the note back on every page after a regen.

## Schema sections

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5-1.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-fable-5-1`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-fable-5-1/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-fable-5`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-fable-5/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-fable-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-fable-5/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-fable-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-fable-5/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-fable-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-fable-5/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-haiku-4-5-20251001.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-haiku-4-5-20251001`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-haiku-4-5-20251001/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-4-6.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-opus-4-6`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-opus-4-6/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-4-7.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-opus-4-7`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-opus-4-7/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-4-8.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-opus-4-8`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-opus-4-8/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-5.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-opus-5`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-opus-5/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-opus-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-5/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-5/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-opus-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-opus-5/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-4-5-20250929.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-sonnet-4-5-20250929`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-5-20250929/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-4-6.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-sonnet-4-6`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-6/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-5.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `anthropic/claude-sonnet-5`, served by Comfy Router from Anthropic.
Expand Down Expand Up @@ -72,13 +71,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/anthropic/claude-sonnet-5/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 78 in development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx#L78

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -169,7 +166,7 @@
</ParamField>

<ParamField body="messages[].content" type="object" required>
Either a string shorthand or an array of content blocks (text, image, document, tool_use, tool_result, ...).

Check warning on line 169 in development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx#L169

Did you really mean 'tool_use'?

Check warning on line 169 in development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx#L169

Did you really mean 'tool_result'?
</ParamField>

<ParamField body="messages[].role" type="string" required>
Expand Down
3 changes: 0 additions & 3 deletions development/comfy-router/models/beeble/switchx/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/beeble/switchx.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `beeble/switchx`, served by Comfy Router from Beeble.
Expand Down Expand Up @@ -68,13 +67,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/beeble/switchx/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 74 in development/comfy-router/models/beeble/switchx/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/beeble/switchx/code.mdx#L74

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -159,7 +156,7 @@
</ParamField>

<ParamField body="alpha_uri" type="string">
URI of a custom alpha matte. Required when alpha_mode is custom or select. Ignored for auto or fill.

Check warning on line 159 in development/comfy-router/models/beeble/switchx/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/beeble/switchx/code.mdx#L159

Did you really mean 'alpha_mode'?
</ParamField>

<ParamField body="callback_url" type="string">
Expand All @@ -173,7 +170,7 @@
</ParamField>

<ParamField body="idempotency_key" type="string">
Idempotency key for safe retries. If a job with the same key already exists for your account, the API returns the existing job's status instead of creating a duplicate.

Check warning on line 173 in development/comfy-router/models/beeble/switchx/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/beeble/switchx/code.mdx#L173

Did you really mean 'Idempotency'?
</ParamField>

<ParamField body="max_resolution" type="integer" default="1080">
Expand All @@ -181,15 +178,15 @@
</ParamField>

<ParamField body="prompt" type="string">
Text description of desired output (max 2,000 chars). At least one of prompt or reference_image_uri is required.

Check warning on line 181 in development/comfy-router/models/beeble/switchx/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/beeble/switchx/code.mdx#L181

Did you really mean 'reference_image_uri'?
</ParamField>

<ParamField body="reference_image_uri" type="string">
URI of the reference image for style transfer. Accepts the same URI types as source_uri.

Check warning on line 185 in development/comfy-router/models/beeble/switchx/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/beeble/switchx/code.mdx#L185

Did you really mean 'source_uri'?
</ParamField>

<ParamField body="source_uri" type="string" required>
URI of the source image or video. Accepts beeble://uploads/\{id}/\{filename}, https URLs, or data:\{mime};base64 URIs (max 50 MB).

Check warning on line 189 in development/comfy-router/models/beeble/switchx/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/beeble/switchx/code.mdx#L189

Did you really mean 'URIs'?
</ParamField>

Generated from the schema Router serves at `GET /v2/models/beeble/switchx/openapi.json`, the same document it validates a call against before the request reaches the provider.
Expand Down Expand Up @@ -217,7 +214,7 @@
</ResponseField>

<ResponseField name="id" type="string" required>
Job identifier (swx_...)

Check warning on line 217 in development/comfy-router/models/beeble/switchx/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/beeble/switchx/code.mdx#L217

Did you really mean 'swx_'?
</ResponseField>

<ResponseField name="modified_at" type="string">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/bfl/erase-v1.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `bfl/erase-v1`, served by Comfy Router from Black Forest Labs.
Expand Down Expand Up @@ -62,13 +61,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/erase-v1/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 68 in development/comfy-router/models/black-forest-labs/erase-v1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/erase-v1/code.mdx#L68

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -201,11 +198,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 201 in development/comfy-router/models/black-forest-labs/erase-v1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/erase-v1/code.mdx#L201

Did you really mean 'nullable'?

Check warning on line 201 in development/comfy-router/models/black-forest-labs/erase-v1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/erase-v1/code.mdx#L201

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 205 in development/comfy-router/models/black-forest-labs/erase-v1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/erase-v1/code.mdx#L205

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -223,17 +220,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 223 in development/comfy-router/models/black-forest-labs/erase-v1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/erase-v1/code.mdx#L223

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 227 in development/comfy-router/models/black-forest-labs/erase-v1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/erase-v1/code.mdx#L227

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 233 in development/comfy-router/models/black-forest-labs/erase-v1/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/erase-v1/code.mdx#L233

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for Flux 1.1 Pro Ultra Image. FLUX 1.1 [pro] is a text-to-image model from Black Forest Labs. Ultra mode generates images at up to 4MP resolution.
Expand Down Expand Up @@ -69,13 +68,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-pro-1.1-ultra/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 75 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L75

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -176,7 +173,7 @@
</ParamField>

<ParamField body="prompt_upsampling" type="boolean" default="false">
Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.

Check warning on line 176 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L176

Did you really mean 'upsample'?
</ParamField>

<ParamField body="raw" type="boolean" default="false">
Expand Down Expand Up @@ -226,11 +223,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 226 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L226

Did you really mean 'nullable'?

Check warning on line 226 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L226

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 230 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L230

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -248,17 +245,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 248 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L248

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 252 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L252

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 258 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L258

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down Expand Up @@ -310,10 +307,10 @@
<Tab title="Wait for the result">
<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 310 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L310

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# The SDK automatically creates an idempotency key and reuses it for automatic retries.

Check warning on line 313 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L313

Did you really mean 'idempotency'?
with Comfy() as client:
result = client.models.run(
"bfl/flux-pro-1.1",
Expand Down Expand Up @@ -352,13 +349,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-pro-1.1/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 356 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L356

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -455,7 +450,7 @@
</ParamField>

<ParamField body="prompt_upsampling" type="boolean" default="false">
Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.

Check warning on line 453 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L453

Did you really mean 'upsample'?
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
Expand Down Expand Up @@ -507,11 +502,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 505 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L505

Did you really mean 'nullable'?

Check warning on line 505 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L505

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 509 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L509

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -529,17 +524,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 527 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L527

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 531 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L531

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 537 in development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx#L537

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
---
title: "Use FLUX.1 Kontext with Comfy Router"

Check warning on line 2 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L2

Did you really mean 'Kontext'?
description: "Python, TypeScript and cURL snippets for calling FLUX.1 Kontext Pro and Kontext Max over HTTP through Comfy Router, plus the request fields and the result shape"

Check warning on line 3 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L3

Did you really mean 'Kontext'?
sidebarTitle: "FLUX.1 Kontext"
---

{/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for FLUX.1 Kontext. FLUX.1 Kontext is Black Forest Labs' instruction-driven image editing model: send an image and a text instruction, get the edited image back with the rest of the scene preserved.
Expand Down Expand Up @@ -41,7 +40,7 @@
"bfl/flux-kontext-pro",
{
"prompt": "replace the background with a sunlit beach, keep the subject unchanged",
"input_image": input_image,

Check warning on line 43 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L43

Did you really mean 'input_image'?
"aspect_ratio": "1:1",
},
)
Expand Down Expand Up @@ -79,17 +78,15 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-kontext-pro/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
import base64

from comfy_sdk import Comfy

Check warning on line 87 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L87

Did you really mean 'comfy_sdk'?

with open("input.jpg", "rb") as f:

Check warning on line 89 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L89

Did you really mean 'rb'?
input_image = base64.b64encode(f.read()).decode()

# Reads COMFY_API_KEY from the environment.
Expand Down Expand Up @@ -198,11 +195,11 @@
</ParamField>

<ParamField body="prompt" type="string" required>
Text prompt describing the edit to apply to input_image, or the image to generate when no input_image is given.

Check warning on line 198 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L198

Did you really mean 'input_image'?
</ParamField>

<ParamField body="prompt_upsampling" type="boolean" default="false">
Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.

Check warning on line 202 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L202

Did you really mean 'upsample'?
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
Expand Down Expand Up @@ -248,11 +245,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 248 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L248

Did you really mean 'nullable'?

Check warning on line 248 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L248

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 252 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L252

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -270,17 +267,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 270 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L270

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 274 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L274

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 280 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L280

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down Expand Up @@ -334,13 +331,13 @@
```python Python
import base64

from comfy_sdk import Comfy

Check warning on line 334 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L334

Did you really mean 'comfy_sdk'?

with open("input.jpg", "rb") as f:

Check warning on line 336 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L336

Did you really mean 'rb'?
input_image = base64.b64encode(f.read()).decode()

# Reads COMFY_API_KEY from the environment.
# The SDK automatically creates an idempotency key and reuses it for automatic retries.

Check warning on line 340 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L340

Did you really mean 'idempotency'?
with Comfy() as client:
result = client.models.run(
"bfl/flux-kontext-max",
Expand Down Expand Up @@ -384,17 +381,15 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-kontext-max/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
import base64

from comfy_sdk import Comfy

Check warning on line 390 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L390

Did you really mean 'comfy_sdk'?

with open("input.jpg", "rb") as f:

Check warning on line 392 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L392

Did you really mean 'rb'?
input_image = base64.b64encode(f.read()).decode()

# Reads COMFY_API_KEY from the environment.
Expand Down Expand Up @@ -503,11 +498,11 @@
</ParamField>

<ParamField body="prompt" type="string" required>
Text prompt describing the edit to apply to input_image, or the image to generate when no input_image is given.

Check warning on line 501 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L501

Did you really mean 'input_image'?
</ParamField>

<ParamField body="prompt_upsampling" type="boolean" default="false">
Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.

Check warning on line 505 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L505

Did you really mean 'upsample'?
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
Expand Down Expand Up @@ -553,11 +548,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 551 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L551

Did you really mean 'nullable'?

Check warning on line 551 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L551

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 555 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L555

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -575,17 +570,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 573 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L573

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 577 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L577

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 583 in development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx#L583

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/bfl/flux-2-max.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `bfl/flux-2-max`, served by Comfy Router from Black Forest Labs.
Expand Down Expand Up @@ -60,13 +59,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-2-max/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 66 in development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx#L66

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -231,11 +228,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 231 in development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx#L231

Did you really mean 'nullable'?

Check warning on line 231 in development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx#L231

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 235 in development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx#L235

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -253,17 +250,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 253 in development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx#L253

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 257 in development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx#L257

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 263 in development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-max/code.mdx#L263

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/bfl/flux-2-pro.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `bfl/flux-2-pro`, served by Comfy Router from Black Forest Labs.
Expand Down Expand Up @@ -60,13 +59,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-2-pro/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 66 in development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx#L66

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -231,11 +228,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 231 in development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx#L231

Did you really mean 'nullable'?

Check warning on line 231 in development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx#L231

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 235 in development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx#L235

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -253,17 +250,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 253 in development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx#L253

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 257 in development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx#L257

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 263 in development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-2-pro/code.mdx#L263

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for FLUX 3 Video. FLUX 3 Video is Black Forest Labs' video generation model, turning a text prompt into a short clip with synchronized audio.
Expand Down Expand Up @@ -69,13 +68,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-3-video/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 75 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L75

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -160,11 +157,11 @@
</ParamField>

<ParamField body="draft" type="boolean" default="false">
Draft mode: generate a fast preview whose result includes a draft_cache download URL. Send that bundle back with mode draft_enhance to render the full-quality version of the same generation.

Check warning on line 160 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L160

Did you really mean 'draft_cache'?

Check warning on line 160 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L160

Did you really mean 'draft_enhance'?
</ParamField>

<ParamField body="draft_cache" type="string">
draft_enhance only. Encrypted draft-cache bundle from a prior draft generation, as the base64-encoded downloaded bundle or its still-valid http(s) URL. The original inputs are embedded in the bundle.

Check warning on line 164 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L164

Did you really mean 'draft_enhance'?
</ParamField>

<ParamField body="duration" type="integer | string" default="&quot;auto&quot;">
Expand All @@ -182,17 +179,17 @@
</ParamField>

<ParamField body="mode" type="string" required>
Generation mode: t2v (text-to-video), i2v (image-continuation), v2v (video-continuation), or draft_enhance (full-quality render of a prior draft). Spelled-out aliases such as text-to-video are accepted.

Check warning on line 182 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L182

Did you really mean 'draft_enhance'?
</ParamField>

<ParamField body="prompt" type="string">
Free-form prompt describing the video. Required for every mode except draft_enhance.

Check warning on line 186 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L186

Did you really mean 'draft_enhance'?
</ParamField>

<ParamField body="resolution" type="string">
Video resolution class: hd, or fhd for a higher-resolution result finished by the video upsampler. Defaults to hd for t2v, i2v and v2v, and to fhd for draft_enhance. Exact dimensions vary with the aspect ratio.

Check warning on line 190 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L190

Did you really mean 'upsampler'?

Check warning on line 190 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L190

Did you really mean 'draft_enhance'?

Possible values: `hd`, `fhd`

Check warning on line 192 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L192

Did you really mean 'fhd'?
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
Expand All @@ -206,7 +203,7 @@
</ParamField>

<ParamField body="version" type="string" default="&quot;latest&quot;">
Endpoint version. latest serves the current release; dated pinnable release tags are added as they are published.

Check warning on line 206 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L206

Did you really mean 'pinnable'?
</ParamField>

Generated from the schema Router serves at `GET /v2/models/bfl/flux-3-video/openapi.json`, the same document it validates a call against before the request reaches the provider.
Expand Down Expand Up @@ -236,25 +233,25 @@
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported task cost. This is BFL's number, not the Comfy charge.

Check warning on line 236 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L236

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>

<ResponseField name="result.draft_cache" type="string (uri)">
Signed URL returned INSTEAD of `sample` by the `draft: true` mode, re-hosted onto Comfy storage the same way `sample` is: normally a Comfy-hosted URL valid for up to 24 hours, and BFL's own roughly two-hour delivery URL when the re-host could not be performed.

Check warning on line 242 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L242

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.sample" type="string (uri)">
Signed URL for the generated MP4. 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 roughly two-hour delivery URL instead. Absent in `draft: true` mode.

Check warning on line 248 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L248

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="status" type="string" required>
Task status: Pending, Reasoning, Generating, Ready, Request Moderated, Content Moderated, Error, or Task not found. Compare case-insensitively; Router forwards BFL's spelling unchanged.

Check warning on line 254 in development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx#L254

Did you really mean 'BFL's'?
</ResponseField>

## Examples
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/bfl/flux-pro-1.0-canny.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `bfl/flux-pro-1.0-canny`, served by Comfy Router from Black Forest Labs.
Expand Down Expand Up @@ -62,13 +61,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-pro-1.0-canny/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 68 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L68

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -163,7 +160,7 @@
</ParamField>

<ParamField body="output_format" type="`jpeg`, `png`, `webp`" default="&quot;jpeg&quot;">
Output format for the generated image. Can be 'jpeg' or 'png'.

Check warning on line 163 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L163

Did you really mean 'jpeg'?
</ParamField>

<ParamField body="preprocessed_image" type="string">
Expand All @@ -175,7 +172,7 @@
</ParamField>

<ParamField body="prompt_upsampling" type="boolean" default="false">
Whether to perform upsampling on the prompt

Check warning on line 175 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L175

Did you really mean 'upsampling'?
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
Expand Down Expand Up @@ -225,11 +222,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 225 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L225

Did you really mean 'nullable'?

Check warning on line 225 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L225

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 229 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L229

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -247,17 +244,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 247 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L247

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 251 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L251

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 257 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-canny/code.mdx#L257

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@

{/* GENERATED FILE. Generated from router-schemas/bfl/flux-pro-1.0-depth.json by `pnpm code-pages:gen`. */}

import QueuedDeliveryNotice from "/snippets/comfy-router/queue-preview-notice.mdx";
import RouterCodeFooter from "/snippets/comfy-router/model-code-footer.mdx";

API Reference for `bfl/flux-pro-1.0-depth`, served by Comfy Router from Black Forest Labs.
Expand Down Expand Up @@ -62,13 +61,11 @@
</CodeGroup>
</Tab>
<Tab title="Queue and collect later">
<QueuedDeliveryNotice />

The same body, sent to `POST https://api.comfy.org/v2/models/bfl/flux-pro-1.0-depth/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Queued delivery](/development/comfy-router/queue) walks through status, cancellation and collection.

<CodeGroup>
```python Python
from comfy_sdk import Comfy

Check warning on line 68 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L68

Did you really mean 'comfy_sdk'?

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
Expand Down Expand Up @@ -151,7 +148,7 @@
</ParamField>

<ParamField body="output_format" type="`jpeg`, `png`, `webp`" default="&quot;jpeg&quot;">
Output format for the generated image. Can be 'jpeg' or 'png'.

Check warning on line 151 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L151

Did you really mean 'jpeg'?
</ParamField>

<ParamField body="preprocessed_image" type="string">
Expand All @@ -163,7 +160,7 @@
</ParamField>

<ParamField body="prompt_upsampling" type="boolean" default="false">
Whether to perform upsampling on the prompt

Check warning on line 163 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L163

Did you really mean 'upsampling'?
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
Expand Down Expand Up @@ -213,11 +210,11 @@
</ResponseField>

<ResponseField name="result" type="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.

Check warning on line 213 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L213

Did you really mean 'nullable'?

Check warning on line 213 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L213

Did you really mean 'nullable'?
</ResponseField>

<ResponseField name="result.cost" type="number">
Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.

Check warning on line 217 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L217

Did you really mean 'BFL's'?

Format: `double`
</ResponseField>
Expand All @@ -235,17 +232,17 @@
</ResponseField>

<ResponseField name="result.prompt" type="string">
The prompt the generation actually ran, after any prompt upsampling.

Check warning on line 235 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L235

Did you really mean 'upsampling'?
</ResponseField>

<ResponseField name="result.sample" type="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.

Check warning on line 239 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L239

Did you really mean 'BFL's'?

Format: `uri`
</ResponseField>

<ResponseField name="result.seed" type="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.

Check warning on line 245 in development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

development/comfy-router/models/black-forest-labs/flux-pro-1-0-depth/code.mdx#L245

Did you really mean 'unformatted'?

Format: `int64`
</ResponseField>
Expand Down
Loading
Loading