Skip to main content
Pricing: $0.06/image. Endpoint: POST /v1/models/black-forest-labs/flux-1-1-pro-ultra/runs.
Ultra-resolution variant of FLUX 1.1 [pro] with 4MP+ outputs and richer detail. Drop-in upgrade when the standard FLUX 1.1 [pro] resolution is the bottleneck.

Overview

Pricing

  • Base price: $0.06/image
  • Note: per image, ultra resolution

FLUX 1.1 [pro] Ultra API

Endpoint: POST /v1/models/black-forest-labs/flux-1-1-pro-ultra/runs

Run the model

Python

import requests

response = requests.post(
    "https://api.runflow.io/v1/models/black-forest-labs/flux-1-1-pro-ultra/runs",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "input": {
            "prompt": "a serene japanese garden with cherry blossoms at dawn"
        },
        "callback_url": "https://your-server.com/webhook"
    },
)

data = response.json()
print(data)

Node.js

const response = await fetch(
  "https://api.runflow.io/v1/models/black-forest-labs/flux-1-1-pro-ultra/runs",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
        "input": {
            "prompt": "a serene japanese garden with cherry blossoms at dawn"
        },
        "callback_url": "https://your-server.com/webhook"
    }),
  }
);

const data = await response.json();
console.log(data);

cURL

curl -X POST https://api.runflow.io/v1/models/black-forest-labs/flux-1-1-pro-ultra/runs \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
    "input": {
        "prompt": "a serene japanese garden with cherry blossoms at dawn"
    },
    "callback_url": "https://your-server.com/webhook"
}
JSON

Request parameters

ParameterTypeRequiredDescription
inputobjectrequiredModel input parameters. See “Input schema” below.
callback_urlstring | nulloptionalWebhook URL - POSTed when the run reaches a terminal state.
metadataobject | nulloptionalArbitrary key-value pairs attached to the run.

Input schema

FieldTypeRequiredAllowed valuesDescription
promptstringrequiredAnyText description of the image to generate.
seedintegeroptionalAnyRandom positive integer for reproducible results. Leave blank to randomise.

Output schema

FieldTypeDescription
outputsjsonUnified output array. One entry per generated artifact with url/type/width/height/content_type.
seedjsonDeterministic seed used for generation, or null if not returned.
timingjsonProvider timing info (inference_ms etc.), or null.
nsfw_detectedjsontrue if flagged as NSFW, false if cleared, null if not checked.

Callback payload

When you provide a callback_url, Runflow POSTs to it once the run reaches a terminal state.
FieldTypeDescription
eventstringEvent type: “run.completed”, “run.failed”, or “run.cancelled”.
run_idstringThe unique identifier of the run.
statusstringTerminal status: “succeeded”, “failed”, or “cancelled”.
outputobject | nullThe run output. Null if the run failed or was cancelled.
duration_msnumber | nullTotal run duration in milliseconds.
created_atstring | nullISO 8601 timestamp when the run was created.
completed_atstring | nullISO 8601 timestamp when the run reached terminal state.
metadataobject | nullThe metadata object passed at run creation, if any.
  • Retries: 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
  • Headers: Runflow-Request-Id is always sent. Runflow-Signature is sent if a signing secret is configured.

Additional Resources

Browse all models

Browse the catalog.

Run lifecycle

Callbacks, polling, statuses.

Callbacks

Handle async results.

Pricing

How requests bill out.