Image · Black Forest Labs

Flux Kontext API

In-context image editing — local edits, style transfer, and character-consistent generation.

جاهز للتشغيل · 2 variants · ابتداءً من $0.050

runapi.ai

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 cursor

@runapi.ai/flux-kontext v1

OVERVIEW

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.

عدة إصدارات لمستويات مختلفة من السرعة / الجودة
يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
يعمل مع workflows موجهة لتطوير التطبيقات
لا يتم احتساب رسوم على عمليات التوليد الفاشلة

VARIANTS

قارن جميع إصدارات API

Variant	Billing	From
flux-kontext-max	call	$0.100	عرض →
flux-kontext-pro	call	$0.050	عرض →

SKILLS

ثبّت skill Flux Kontext لتطوير التطبيقات

حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.

# Install the model skill for app development workflows
npx skills add runapi-ai/flux-kontext -g

Installs docs, schemas, pricing context, and setup notes into your developer workspace.

Or use this setup request in your coding tool:

Install 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.

OpenClaw

Use Flux Kontext in OpenClaw

Prompt, curl command, parameters, and FAQ.

Hermes Agent

Use Flux Kontext in Hermes Agent

Custom provider setup, API call, and FAQ.

كيف يعمل

من model skill إلى أول نتيجة في أربع خطوات

اختر النموذج

اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.

الإعداد

اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.

التنفيذ

استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.

الاستلام

استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.

CONTEXT

ما هي 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.

Provider

Black Forest Labs

Modality

Image

لماذا RunAPI

لماذا تستخدم Flux Kontext API عبر RunAPI

مصادقة واحدة لكل مزود

مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.

تسعير وفوترة موحّدان

تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.

Skill مع schemas

تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.

FAQ

أسئلة شائعة

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.

أي نسخة ينبغي أن أبدأ بها؟

اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.

هل توجد خطة مجانية؟

تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.

هل تدعمون البث المباشر للنتائج؟

حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.

كيف يتم احتساب الرسوم عند الفشل؟

لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.

هل يتم تخزين المخرجات مؤقتًا؟

يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.

هل يمكنني الاستخدام تجاريًا؟

نعم — يشمل كل إصدار الاستخدام التجاري ما لم يقيّده ترخيص النموذج صراحةً، ويُشار إلى ذلك في صفحة الإصدار.

ماذا عن حدود المعدل؟

تتدرج حدود المعدل لكل مفتاح وفق فئة الاستخدام. راجع صفحة الأسعار للاطلاع على الحدود الحالية.

أين يمكنني الإبلاغ عن المشاكل؟

افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.

نماذج مشابهة

إذا أعجبتك Flux Kontext API، فجرّب هذه الخيارات

ابدأ الآن

ابدأ البناء باستخدام Flux Kontext API.

إنشاء حساب مجاني اقرأ البدء السريع →

النسخ

الفئة نفسها

من هذا المزود

Flux
Flux 2

التوثيق