Flux Kontext API

Use the Flux Kontext API via RunAPI with a model skill, unified auth, and pay-as-you-go pricing.

runapi.ai
curl -X POST https://runapi.ai/api/v1/flux_kontext/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-kontext-max",
  "prompt": "Edit this product photo: change the background to a tropical beach while keeping the product exactly the same."
}'
import { FluxKontextClient } from "@runapi.ai/flux-kontext";

const client = new FluxKontextClient();
const result = await client.textToImage.run({
    model: "flux-kontext-max",
    prompt: "Edit this product photo: change the background to a tropical beach while keeping the product exactly the same.",
});
<?php

require __DIR__ . "/vendor/autoload.php";

use RunApi\FluxKontext\FluxKontextClient;

$client = new FluxKontextClient();
$result = $client->textToImage->run([
        'model' => 'flux-kontext-max',
        'prompt' => 'Edit this product photo: change the background to a tropical beach while keeping the product exactly the same.',
]);
require "runapi/flux_kontext"

client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
    model: "flux-kontext-max",
    prompt: "Edit this product photo: change the background to a tropical beach while keeping the product exactly the same."
)
npx skills add runapi-ai/flux-kontext -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
@runapi.ai/flux-kontext v1
OVERVIEW

About Flux Kontext

Flux Kontext is Black Forest Labs' in-context image editing model that applies targeted edits while preserving style, character identity, and scene composition. It excels at style transfer and maintaining visual consistency.

Provider
Black Forest Labs
Modality
Image

Available Versions

Variant Billing Pricing
flux-kontext-max call $0.17 View →
flux-kontext-pro call $0.11 View →
PRICING

Flux Kontext Pricing

Endpoint Resolution Duration Price
text_to_image — — $0.17 / image

Prices shown for flux-kontext-max. Other variants retain their own endpoint pricing.

Agent integration

Run Flux Kontext From an Agent

HOW IT WORKS

Get Started with Flux Kontext

  1. Create an API key

    Sign up and generate an API key from the dashboard.

  2. Pick a version

    Choose the version that best matches your quality and cost requirements.

  3. Send a request

    Submit your prompt and parameters to the model's documented endpoint.

  4. Get your result

    Poll the task or set a webhook, then download the completed output.

CONTEXT

About Flux Kontext on RunAPI

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.

Provider
Black Forest Labs
See all →
Modality
Image
Browse models →

Why Use Flux Kontext Through RunAPI

One auth, every provider

A single RunAPI API key unlocks the whole model catalog across all providers. No separate accounts to create, no API keys to rotate per integration, and no credential management overhead. Add a new model to your app by changing one parameter.

Unified pricing & billing

Per-call pricing in USD, billed monthly into a single invoice. No subscription tiers, no minimum spend, and failed generations are never charged. The pricing page and check_pricing API show exact costs before you commit to a model.

Schema-first SDK

Typed schemas, parameter constraints, and setup notes are packaged in the model skill so your implementation starts from the right contract. The skill loads into Claude Code, Codex, Gemini CLI, Cursor, and VS Code — your agent knows the correct request shape before you write a line of code.

Flux Kontext Questions

What is contextual editing?

Flux Kontext edits a specific region of an image while preserving the lighting, perspective, and style of the untouched areas.

What is the difference between Pro and Max?

Pro is the standard tier for most editing tasks. Max offers higher fidelity and is suited for complex multi-element edits.

What input formats are supported?

JPEG, PNG, and WebP. Keep input images under 10 MB for optimal performance.

Can I maintain character identity across edits?

Yes — Kontext is designed to preserve character consistency when editing backgrounds, clothing, or scene elements.

How fast is generation?

Typically 3–5 seconds per image, depending on complexity and variant.

Which variant should I start with?

Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production.

SIMILAR MODELS

Similar Image Models

Start generating with Flux Kontext