Black Forest Labs · Image

OpenClaw x Flux 2

Flux 2 is Black Forest Labs' generation model, delivering high prompt adherence across text-to-image and remix-image tasks. Through RunAPI, Pro and Flex variants share the same API shape.

6 variants from $0.07 / call Commercial OK

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use flux-2-flex-remix-image when it matches the task: Flex control + reference image input.

You have access to RunAPI task tools for Flux 2.

Available Flux 2 models:
- flux-2-flex-remix-image: Flex control + reference image input
  endpoints: /api/v1/flux_2/remix_image
  request fields: model, prompt, source_image_urls
- flux-2-flex-text-to-image: Adjustable steps + guidance; up to 8 source images via remix; best typography
  endpoints: /api/v1/flux_2/text_to_image
  request fields: model, prompt
- flux-2-max-remix-image: Highest-quality FLUX.2 source-image remix with consistent edits
  endpoints: /api/v1/flux_2/remix_image
  request fields: model, prompt, source_image_urls, aspect_ratio
- flux-2-max-text-to-image: Highest-quality FLUX.2 generation with strong prompt following
  endpoints: /api/v1/flux_2/text_to_image
  request fields: model, prompt, aspect_ratio
- flux-2-pro-remix-image: Pro quality with input image as style/content seed
  endpoints: /api/v1/flux_2/remix_image
  request fields: model, prompt, source_image_urls
- flux-2-pro-text-to-image: Zero-config flagship; automatic prompt enhancement
  endpoints: /api/v1/flux_2/text_to_image
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: Generate a photorealistic studio portrait of an astronaut holding a cat, dramatic rim lighting, fine detail.
/api/v1/flux_2/remix_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux_2/remix_image and save the returned Task id.
GET /api/v1/flux_2/remix_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.
/api/v1/flux_2/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux_2/text_to_image and save the returned Task id.
GET /api/v1/flux_2/text_to_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
flux-2-flex-remix-image
/api/v1/flux_2/remix_image
$0.14 / call Model detail
flux-2-flex-text-to-image
/api/v1/flux_2/text_to_image
$0.14 / call Model detail
flux-2-max-remix-image
/api/v1/flux_2/remix_image
$0.15 / call Model detail
flux-2-max-text-to-image
/api/v1/flux_2/text_to_image
$0.15 / call Model detail
flux-2-pro-remix-image
/api/v1/flux_2/remix_image
$0.07 / call Model detail
flux-2-pro-text-to-image
/api/v1/flux_2/text_to_image
$0.07 / call Model detail

Verify

Poll until the task reaches a terminal status

Select <model-id> to generate verification commands.

Configuration

Guide endpoint: <endpoint>

Select <model-id> to generate a request with the endpoint's public input contract.
How it works

Get Started in 3 Steps

  1. Choose a model ID

    Select a public catalog model ID and review its endpoint and current starting price.

  2. Configure RunAPI

    Set RUNAPI_API_KEY before making the endpoint request.

  3. Verify the result

    For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.

What to Build with OpenClaw + Flux 2

  • E-commerce product photography

    Generate product photos and background swaps that look like studio shots for catalog pages and listings.

  • Ad localization across markets

    Produce localized ad visuals from the same prompt structure, swapping text and cultural references while keeping the brand consistent.

  • Magazine covers and editorial images

    Create editorial covers with on-image text rendered as part of the generated image.

Why Use Flux 2 Through RunAPI + OpenClaw

  • 6 variants, one API key

    Use one RunAPI connection to choose among the live model variants without changing your integration.

  • Clear usage pricing

    See current catalog pricing before you send a request, with no subscription or minimum spend required.

  • Automatic task workflows

    Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code.

OpenClaw + Flux 2 Questions

How do I choose a Flux 2 version?

Flux 2 versions trade generation speed and cost against image fidelity. Every version supports text-to-image generation and remixing, and some add extra options. Compare them in the version table on this page and pick the one that fits your quality and speed needs.

Does output resolution affect Flux 2 pricing?

It depends on the version. Flux 2 Flex and Flux 2 Pro bill per image and cost more at 2k than at 1k. Flux 2 Max outputs 1k only, at a single per-image rate. The pricing shown on this page reflects the current rates.

How does Flux 2 compare to Flux Kontext?

Flux Kontext focuses on text-guided editing of a single image and character consistency. Flux 2 focuses on text-to-image generation and multi-image remixing. Both use the same RunAPI key.

Which model ID should I use?

Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version.

Does this guide configure a chat model?

No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model.

Start using Flux 2 with OpenClaw

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us