> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Flux 1.1 Pro Ultra Image with Comfy Router

> Python, TypeScript and cURL snippets for calling FLUX 1.1 [pro] Ultra and FLUX 1.1 [pro] over HTTP through Comfy Router, plus the request fields and the result shape

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.

<Note>
  **Comfy Router is not generally available yet.** `POST /v2/models/{provider}/{model}` and its catalog and schema siblings are not serving requests yet: an authenticated call answers `404` today. The snippets on this page document the contract those routes will serve, published ahead of the rollout so your integration is ready to write against.
</Note>

## 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.

Pick the model you want to call. Everything below, from the snippets to the schema and examples, follows your choice.

<Tabs>
  <Tab title="FLUX 1.1 [pro] Ultra">
    **Model ID:** `bfl/flux-pro-1.1-ultra`

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

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

      # Reads COMFY_API_KEY from the environment. Each call sends a fresh
      # Idempotency-Key and waits up to 10 minutes for the finished result.
      with Comfy() as client:
          result = client.models.run(
              "bfl/flux-pro-1.1-ultra",
              {
                  "prompt": "a single red maple leaf on a plain white background, studio lighting",
                  "aspect_ratio": "16:9",
                  "raw": False,
              },
          )

      print("image:", result["result"]["sample"])
      ```

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

      // Reads COMFY_API_KEY from the environment. Each call sends a fresh
      // Idempotency-Key and waits up to 10 minutes for the finished result.
      type Result = { result: { sample: string } };
      const { data } = await comfy.models.run<Result>("bfl/flux-pro-1.1-ultra", {
        prompt: "a single red maple leaf on a plain white background, studio lighting",
        aspect_ratio: "16:9",
        raw: false,
      });

      console.log("image:", data.result.sample);
      ```

      ```bash cURL theme={null}
      curl https://api.comfy.org/v2/models/bfl/flux-pro-1.1-ultra \
        -H "X-API-Key: $COMFY_API_KEY" \
        -H "Idempotency-Key: $(uuidgen)" \
        -H "Content-Type: application/json" \
        -d "{\"prompt\": \"a single red maple leaf on a plain white background, studio lighting\", \"aspect_ratio\": \"16:9\", \"raw\": false}"
      ```
    </CodeGroup>

    <h2>Schema</h2>

    <h3>Input</h3>

    <ParamField body="aspect_ratio" type="string" default="&#x22;16:9&#x22;">
      Aspect ratio of the image between 21:9 and 9:21, e.g. 16:9.
    </ParamField>

    <ParamField body="image_prompt" type="string">
      Optional base64-encoded image to remix.
    </ParamField>

    <ParamField body="image_prompt_strength" type="number" default="0.1">
      Blend between the prompt and the image prompt, from 0 (prompt only) to 1 (image prompt only).

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

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

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

    <ParamField body="prompt" type="string" required>
      Text prompt for image generation.
    </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.
    </ParamField>

    <ParamField body="raw" type="boolean" default="false">
      Generate less processed, more natural-looking images.
    </ParamField>

    <ParamField body="safety_tolerance" type="integer" default="2">
      Tolerance level for input and output moderation, between 0 (most strict) and 6 (least strict).

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

    <ParamField body="seed" type="integer">
      Optional seed for reproducibility. A random seed is used when omitted.
    </ParamField>

    <ParamField body="webhook_secret" type="string">
      Optional secret for webhook signature verification.
    </ParamField>

    <ParamField body="webhook_url" type="string (uri)">
      URL to receive webhook notifications.

      Format: `uri`
    </ParamField>

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

    <h3>Output</h3>

    <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>

    <h2>Examples</h2>

    <h3>Input</h3>

    ```json theme={null}
    {
      "aspect_ratio": "16:9",
      "prompt": "A lighthouse on a rocky coast at golden hour, cinematic"
    }
    ```

    <h3>Output</h3>

    ```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"
    }
    ```

    The URL is temporary. Download the image promptly if you need to keep it.
  </Tab>

  <Tab title="FLUX 1.1 [pro]">
    **Model ID:** `bfl/flux-pro-1.1`

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

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

      # Reads COMFY_API_KEY from the environment. Each call sends a fresh
      # Idempotency-Key and waits up to 10 minutes for the finished result.
      with Comfy() as client:
          result = client.models.run(
              "bfl/flux-pro-1.1",
              {
                  "prompt": "a single red maple leaf on a plain white background, studio lighting",
                  "width": 1024,
                  "height": 768,
              },
          )

      print("image:", result["result"]["sample"])
      ```

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

      // Reads COMFY_API_KEY from the environment. Each call sends a fresh
      // Idempotency-Key and waits up to 10 minutes for the finished result.
      type Result = { result: { sample: string } };
      const { data } = await comfy.models.run<Result>("bfl/flux-pro-1.1", {
        prompt: "a single red maple leaf on a plain white background, studio lighting",
        width: 1024,
        height: 768,
      });

      console.log("image:", data.result.sample);
      ```

      ```bash cURL theme={null}
      curl https://api.comfy.org/v2/models/bfl/flux-pro-1.1 \
        -H "X-API-Key: $COMFY_API_KEY" \
        -H "Idempotency-Key: $(uuidgen)" \
        -H "Content-Type: application/json" \
        -d "{\"prompt\": \"a single red maple leaf on a plain white background, studio lighting\", \"width\": 1024, \"height\": 768}"
      ```
    </CodeGroup>

    <h2>Schema</h2>

    <h3>Input</h3>

    <ParamField body="height" type="integer" default="768">
      Height of the generated image in pixels. Must be a multiple of 32.

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

    <ParamField body="image_prompt" type="string">
      Optional base64-encoded image to use with FLUX Redux.
    </ParamField>

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

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

    <ParamField body="prompt" type="string" required>
      Text prompt for image generation.
    </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.
    </ParamField>

    <ParamField body="safety_tolerance" type="integer" default="2">
      Tolerance level for input and output moderation, between 0 (most strict) and 6 (least strict).

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

    <ParamField body="seed" type="integer">
      Optional seed for reproducibility. A random seed is used when omitted.
    </ParamField>

    <ParamField body="webhook_secret" type="string">
      Optional secret for webhook signature verification.
    </ParamField>

    <ParamField body="webhook_url" type="string (uri)">
      URL to receive webhook notifications.

      Format: `uri`
    </ParamField>

    <ParamField body="width" type="integer" default="1024">
      Width of the generated image in pixels. Must be a multiple of 32.

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

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

    <h3>Output</h3>

    <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>

    <h2>Examples</h2>

    <h3>Input</h3>

    ```json theme={null}
    {
      "height": 768,
      "prompt": "An impressionist landscape of rolling hills under a summer sky",
      "width": 1024
    }
    ```

    <h3>Output</h3>

    ```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"
    }
    ```

    The URL is temporary. Download the image promptly if you need to keep it.
  </Tab>
</Tabs>

## Before you ship

The snippets above are the shortest working call. Three things are the same for every model and are documented once on the [Comfy Router headers](/development/comfy-router/headers) page: send an `Idempotency-Key` on every paid call and reuse it when you retry, expect the connection to be held up to Router's 10 minute deadline, and keep `X-Comfy-Request-Id` from every response. The SDKs do all three for you; the cURL tab does none of them. On failure, `X-Comfy-Error-Type` names the bucket, and a `422` means the body failed the model's schema and was never billed.

<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="Quick Start" icon="rocket" href="/development/comfy-router/quickstart">
    Typed error handling in Python and TypeScript, reading the 422, walking the catalog.
  </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>