Black Forest Labs · Image

OpenClaw x Flux Kontext

Flux Kontext is Black Forest Labs' context-aware editing model, built on the 12B-parameter Flux architecture. Through RunAPI, both Kontext Pro and Max variants share a single key.

2 variants from $0.11 / call Commercial OK
Get API Key View OpenClaw Docs

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use flux-kontext-max when it matches the task: 4K output, superior text rendering, advanced contextual editing.

You have access to RunAPI task tools for Flux Kontext.

Available Flux Kontext models:
- flux-kontext-max: 4K output, superior text rendering, advanced contextual editing
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt
- flux-kontext-pro: Balanced speed and quality for in-context editing
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: Edit this product photo: change the background to a tropical beach while keeping the product exactly the same.
/api/v1/flux_kontext/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux_kontext/text_to_image and save the returned Task id.
GET /api/v1/flux_kontext/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-kontext-max
/api/v1/flux_kontext/text_to_image
$0.17 / call Model detail
flux-kontext-pro
/api/v1/flux_kontext/text_to_image
$0.11 / 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 Kontext

  • Background replacement while keeping subjects

    Swap product or portrait backgrounds while the subject stays in place, using a text instruction instead of masks or inpainting.

  • Clothing and appearance changes

    Change outfits, hair color, or accessories on a character while preserving facial identity, useful for fashion mockups and character design iteration.

  • Text replacement on signs and labels

    Replace text on signs, product labels, or storefronts in existing images by writing the new text in the prompt.

Why Use Flux Kontext Through RunAPI + OpenClaw

  • 2 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 Kontext Questions

Can I use Flux Kontext in OpenClaw?

Yes. Configure RunAPI as a provider in OpenClaw, then call the Flux Kontext endpoint shown on this page. The same RunAPI API key you use for chat handles image generation and editing.

Is Flux Kontext asynchronous?

Yes. The API returns a task ID immediately. Poll the task status or use a callback to receive the finished image URL.

Can Flux Kontext edit text inside an image?

Yes. Pass the original image and describe the text change in the prompt. The model renders the new text in the same position and style as the original.

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 Kontext with OpenClaw

Get API Key Read Quickstart

Building with a team?

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

Contact Us