Flux Kontext API
In-context image editing — local edits, style transfer, and character-consistent generation.
curl -X POST https://runapi.ai/api/v1/flux_kontext/text_to_image \
-H "Authorization: Bearer $RUNAPI_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 cursorFlux 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.
- Meerdere varianten voor verschillende snelheid-/kwaliteitsniveaus
- Modelskill bevat docs, schema's en setupnotities
- Werkt met appgerichte codeerworkflows
- Mislukte generaties worden niet in rekening gebracht
Vergelijk alle API-varianten
| Variant | Billing | From | |
|---|---|---|---|
| flux-kontext-max | call | $0.100 | Bekijken → |
| flux-kontext-pro | call | $0.050 | Bekijken → |
Installeer de Flux Kontext skill voor appontwikkeling
Laad modeldocs, schema's, prijsnotities en setupstappen in je codeworkspace.
# Install the model skill for app development workflows
npx skills add runapi-ai/flux-kontext -gInstall the Flux Kontext skill for this app: 1. Add runapi-ai/flux-kontext with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Van modelskill naar eerste resultaat in vier stappen
Kies het model
Kies het model en de variant die passen bij je outputtype, kwaliteitslat en latencydoel.
Configureren
Stel je RunAPI-key in en installeer de modelskill in je codeworkspace.
Bouwen
Gebruik de skill-instructies om de modelfeature in je applicatie toe te voegen.
Ontvangen
Poll op task-ID, stream wanneer ondersteund of verwerk de webhook-callback.
Wat is de Flux Kontext API?
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.
Waarom de Flux Kontext API via RunAPI gebruiken
Eén auth, elke provider
Met één RunAPI-sleutel ontgrendel je de hele catalogus. Geen aparte accounts, geen sleutelrotatie per integratie.
Uniforme prijzen & billing
Prijs per call in USD, maandelijks gefactureerd. Mislukte generaties worden niet in rekening gebracht.
Skill met schema's
Getypeerde schema's en setupnotities zitten in de modelskill, zodat implementatie start vanuit het juiste contract.
Veelgestelde vragen
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.
Met welke variant moet ik beginnen?
Kies de goedkoopste variant die aan je kwaliteitsnorm voldoet. De meeste teams beginnen met de snelle variant en stappen over op pro voor productie.
Is er een gratis tier?
Nieuwe accounts krijgen de eerste calls gratis op elk model. Daarna betaal je per call.
Streamen jullie resultaten?
Waar streaming beschikbaar is, streamt RunAPI end-to-end.
Hoe worden mislukkingen gefactureerd?
Mislukte generations worden niet in rekening gebracht.
Worden outputs gecachet?
Gegenereerde outputs worden opgeslagen en zijn op te vragen via task-ID. Inputs worden niet gecachet.
Mag ik het commercieel gebruiken?
Ja — commercieel gebruik is inbegrepen voor elke variant, tenzij een modellicentie het expliciet beperkt. Dat staat aangegeven op de variantpagina.
Hoe zit het met rate limits?
Rate limits per key schalen mee met je usage tier. Zie de prijzenpagina voor de actuele limieten.
Waar kan ik problemen melden?
Open een issue in de publieke GitHub-repo of mail support.