> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-stale2000-router-model-pages.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Use FLUX 2 Pro with Comfy Router

> Call bfl/flux-2-pro through Comfy Router: endpoint, request shape and the response Router returns.

Use `bfl/flux-2-pro` with the Comfy Router API. Black Forest Labs provides the model; Router gives it the shared authentication and request route below.

## Quick start

Create a key at [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) and export it as `COMFY_API_KEY`. The Python and TypeScript snippets use the Comfy SDKs (`pip install comfy-sdk`, `npm install @comfyorg/sdk`); the cURL snippet is the same call over raw HTTP.

**Model ID:** `bfl/flux-2-pro`

**Endpoint:** `POST https://api.comfy.org/v2/models/bfl/flux-2-pro`

<CodeGroup>
  ```python Python theme={null}
  import uuid
  from comfy_sdk import Comfy

  # Reads COMFY_API_KEY from the environment. Save this key and reuse it if you
  # retry this request after the SDK returns an error.
  idempotency_key = str(uuid.uuid4())
  with Comfy() as client:
      result = client.models.run(
          "bfl/flux-2-pro",
          {
              # Request fields are the provider's own — see Input below.
          },
          idempotency_key=idempotency_key,
      )

  print(result)
  ```

  ```typescript TypeScript theme={null}
  import { comfy } from "@comfyorg/sdk";

  // Reads COMFY_API_KEY from the environment. Save this key and reuse it if you
  // retry this request after the SDK returns an error.
  const idempotencyKey = crypto.randomUUID();
  const { data } = await comfy.models.run("bfl/flux-2-pro", {
    // Request fields are the provider's own — see Input below.
  }, { idempotencyKey });

  console.log(data);
  ```

  ```bash cURL theme={null}
  # Request fields are the provider's own — see Input below.
  # Run this line once. Reuse ROUTER_REQUEST_KEY if you retry the curl command.
  ROUTER_REQUEST_KEY=$(uuidgen)
  curl https://api.comfy.org/v2/models/bfl/flux-2-pro \
    -H "X-API-Key: $COMFY_API_KEY" \
    -H "Idempotency-Key: $ROUTER_REQUEST_KEY" \
    -H "Content-Type: application/json" \
    -d '{}'
  ```
</CodeGroup>

## Schema

### Input

<ParamField body="height" type="integer" default="1024">
  Height of the image.

  Range: `256` to `2048`
</ParamField>

<ParamField body="input_image" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_2" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_3" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_4" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_5" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_6" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_7" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_8" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="input_image_9" type="string">
  Base64 encoded image for image-to-image generation.
</ParamField>

<ParamField body="output_format" type="string" default="&#x22;jpeg&#x22;">
  Output format for the generated image.

  Possible values: `jpeg`, `png`
</ParamField>

<ParamField body="prompt" type="string" required>
  Text description of the image to generate.
</ParamField>

<ParamField body="prompt_upsampling" type="boolean" default="true">
  Automatically modify prompt for generation.
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
  Moderation tolerance level (Flux 2 Max only).

  Range: `0` to `5`
</ParamField>

<ParamField body="seed" type="integer">
  Seed for reproducibility.
</ParamField>

<ParamField body="width" type="integer" default="1024">
  Width of the image.

  Range: `256` to `2048`
</ParamField>

Generated from the schema Router serves at `GET /v2/models/bfl/flux-2-pro/openapi.json`, the same document it validates a call against before the request reaches the provider.

### Output

<ResponseField name="cost" type="number">
  Provider-reported cost in credits, populated once the task is Ready.

  Format: `float`
</ResponseField>

<ResponseField name="id" type="string" required>
  BFL task identifier.
</ResponseField>

<ResponseField name="progress" type="number">
  Optional generation progress reported by BFL.

  Range: `0` to `1`

  Format: `float`
</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.
</ResponseField>

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

  Format: `double`
</ResponseField>

<ResponseField name="result.duration" type="number">
  Provider-reported generation duration in seconds.

  Format: `double`
</ResponseField>

<ResponseField name="result.end_time" type="number">
  Provider-reported completion time of the generation, in seconds since the Unix epoch. `double` for the same reason as `start_time`.

  Format: `double`
</ResponseField>

<ResponseField name="result.prompt" type="string">
  The prompt the generation actually ran, after any prompt 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.

  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.

  Format: `int64`
</ResponseField>

<ResponseField name="result.start_time" type="number">
  Provider-reported start time of the generation, in seconds since the Unix epoch. `double`, not `float`: float32 spacing near a present-day epoch value is \~128 seconds, which collapses a whole generation's span to a single decoded value.

  Format: `double`
</ResponseField>

<ResponseField name="status" type="string" required>
  Task status: Pending, Reasoning, Generating, Ready, Request Moderated, Content Moderated, Error, or Task not found.
</ResponseField>

## Examples

### Input

```json theme={null}
{
  "prompt": "A single red maple leaf on a plain white background."
}
```

### Output

```json theme={null}
{
  "cost": null,
  "id": "b2e0c1a4-0f2f-4a55-9f2e-2f9a1c0d4e77",
  "progress": null,
  "result": {
    "cost": null,
    "duration": 3.4,
    "end_time": 1767225603.4,
    "prompt": "A watercolor painting of a lighthouse at dawn, soft light on the water",
    "sample": "https://example.invalid/bfl/flux-pro-1.1/sample.png",
    "seed": 2784347701,
    "start_time": 1767225600
  },
  "status": "Ready"
}
```

## Before you ship

Save one `Idempotency-Key` for each call and reuse it for retries. Router can hold the connection for up to 10 minutes. The SDKs handle authentication; raw HTTP clients send the headers themselves.

Use `X-Comfy-Error-Type` to classify a failure. A `422` means Router rejected the input before calling the provider. Download generated assets promptly because [result URLs can expire](/development/comfy-router/reference#result-assets).

<CardGroup cols={3}>
  <Card title="Headers" icon="list" href="/development/comfy-router/headers">
    Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.
  </Card>

  <Card title="Using the Router API" icon="code" href="/development/comfy-router/models">
    Find models, inspect schemas, and retry safely.
  </Card>

  <Card title="Limitations" icon="triangle-exclamation" href="/development/comfy-router/limitations">
    What Router does not do today, and what to use instead.
  </Card>
</CardGroup>