Flexible parameters
Configure 8 documented parameters, including aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt.
Balanced speed and quality for in-context editing
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-pro",
"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-pro",
prompt: "Edit this product photo: change the background to a tropical beach while keeping the product exactly the same.",
});
import os
import requests
response = requests.post(
"https://runapi.ai/api/v1/flux_kontext/text_to_image",
headers={"Authorization": f"Bearer {os.environ['RUNAPI_API_KEY']}"},
json={"model":"flux-kontext-pro","prompt":"Edit this product photo: change the background to a tropical beach while keeping the product exactly the same."}
)
response.raise_for_status()
<?php
$client = curl_init("https://runapi.ai/api/v1/flux_kontext/text_to_image");
curl_setopt_array($client, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("RUNAPI_API_KEY"), "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'flux-kontext-pro',
'prompt' => 'Edit this product photo: change the background to a tropical beach while keeping the product exactly the same.',
])
]);
$response = curl_exec($client);
RunApi client = new RunApi(System.getenv("RUNAPI_API_KEY"));
Task task = client.textToImage().run({"model":"flux-kontext-pro","prompt":"Edit this product photo: change the background to a tropical beach while keeping the product exactly the same."});
task.waitForResult();
require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-pro",
prompt: "Edit this product photo: change the background to a tropical beach while keeping the product exactly the same."
)
client := runapi.NewClient(os.Getenv("RUNAPI_API_KEY"))
task, err := client.textToImage.Run({"model":"flux-kontext-pro","prompt":"Edit this product photo: change the background to a tropical beach while keeping the product exactly the same."})
if err != nil { log.Fatal(err) }
task.Wait()
$ runapi generate \
--model flux-kontext-pro \
--endpoint text_to_image \
--wait
2 versions available
Pick any model and generate in seconds.
| Provider | Black Forest Labs |
| Model ID | flux-kontext-pro |
| Modality | Image |
| Task types | Asynchronous |
| API endpoint | /api/v1/flux_kontext/text_to_image |
| Billing unit | call |
| Input parameters | aspect_ratio, callback_url, enable_prompt_expansion, enable_translation, model, output_format, prompt, safety_tolerance, source_image_url, watermark |
| Aspect ratios | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| Output format | jpeg, png |
| Catalog status | Operational |
Sign up for free and create an API key for flux-kontext-pro from the dashboard.
POST to /api/v1/flux_kontext/text_to_image with the flux-kontext-pro model slug and your parameters.
Poll the task or follow the callback to retrieve the completed flux-kontext-pro result.
Configure 8 documented parameters, including aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt.
Exposes 1 public endpoint(s): text_to_image.
Asynchronous tasks accept a callback URL for completion notifications.
Metered by call with no subscription requirement.
promptImage description (English only).
watermarkWatermark identifier.
aspect_ratioOutput aspect ratio. Default: 16:9. (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)
callback_urlWebhook URL for async notifications.
output_formatOutput format. Default: jpeg. (jpeg, png)
safety_toleranceContent safety threshold. 0-6 for generation, 0-2 for editing. Default: 2.
source_image_urlSource image URL for editing mode.
enable_translationAuto-translate non-English prompts. Default: true.
enable_prompt_expansionExpand the prompt with more detail. Default: false.
Auto-generate lifestyle product photos for e-commerce catalogs that lack studio photography.
Rapidly concept environments and characters before committing to final art.
Generate unique cover art and illustrations for blog posts and articles at scale.
Pass the model ID shown in the quickstart.
Per-key rate limits scale with your usage tier. The pricing page shows current limits. If you need higher throughput, contact support to discuss tier upgrades.
Yes. Variant is a parameter in the request. Switch by changing the model ID — no code changes, no re-authentication, no separate billing setup. All variants share the same API key and request shape.
Where streaming is available, RunAPI streams end-to-end. LLM models support token-level streaming. Media models use async task polling or webhook callbacks for result delivery.
Open an issue on the public GitHub repo or email support at [email protected]. Include the task ID and model ID so the team can investigate the specific generation.
No. Your RunAPI API key is enough to access this variant and every other model in the catalog. You do not need accounts with the underlying provider.
We're here to help with enterprise setup, integrations, and technical questions.
Contact Us