معاملات مرنة
اضبط 8 معاملاً موثَّقاً، بما يشمل aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt.
توازن بين السرعة والجودة للتحرير ضمن السياق
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": "حرّر صورة المنتج هذه: غيّر الخلفية إلى شاطئ استوائي مع إبقاء المنتج كما هو تمامًا."
}'
import { FluxKontextClient } from "@runapi.ai/flux-kontext";
const client = new FluxKontextClient();
const result = await client.textToImage.run({
model: "flux-kontext-pro",
prompt: "حرّر صورة المنتج هذه: غيّر الخلفية إلى شاطئ استوائي مع إبقاء المنتج كما هو تمامًا.",
});
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":"حرّر صورة المنتج هذه: غيّر الخلفية إلى شاطئ استوائي مع إبقاء المنتج كما هو تمامًا."}
)
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' => 'حرّر صورة المنتج هذه: غيّر الخلفية إلى شاطئ استوائي مع إبقاء المنتج كما هو تمامًا.',
])
]);
$response = curl_exec($client);
RunApi client = new RunApi(System.getenv("RUNAPI_API_KEY"));
Task task = client.textToImage().run({"model":"flux-kontext-pro","prompt":"حرّر صورة المنتج هذه: غيّر الخلفية إلى شاطئ استوائي مع إبقاء المنتج كما هو تمامًا."});
task.waitForResult();
require "runapi/flux_kontext"
client = RunApi::FluxKontext::Client.new
result = client.text_to_image.run(
model: "flux-kontext-pro",
prompt: "حرّر صورة المنتج هذه: غيّر الخلفية إلى شاطئ استوائي مع إبقاء المنتج كما هو تمامًا."
)
client := runapi.NewClient(os.Getenv("RUNAPI_API_KEY"))
task, err := client.textToImage.Run({"model":"flux-kontext-pro","prompt":"حرّر صورة المنتج هذه: غيّر الخلفية إلى شاطئ استوائي مع إبقاء المنتج كما هو تمامًا."})
if err != nil { log.Fatal(err) }
task.Wait()
$ runapi generate \
--model flux-kontext-pro \
--endpoint text_to_image \
--wait
2 إصدارات متاحة
اختر أي نموذج وابدأ التوليد في ثوانٍ.
| المزوّد | Black Forest Labs |
| معرّف النموذج | flux-kontext-pro |
| النمط | صورة |
| أنواع المهام | Asynchronous |
| نقطة نهاية API | /api/v1/flux_kontext/text_to_image |
| وحدة الفوترة | استدعاء |
| معلمات الإدخال | aspect_ratio, callback_url, enable_prompt_expansion, enable_translation, model, output_format, prompt, safety_tolerance, source_image_url, watermark |
| نسب العرض إلى الارتفاع | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| تنسيق الإخراج | jpeg, png |
| حالة الكتالوج | جاهز للتشغيل |
سجّل مجانًا وأنشئ مفتاح API لـ flux-kontext-pro من لوحة التحكم.
أرسل طلب POST إلى /api/v1/flux_kontext/text_to_image باستخدام معرّف نموذج flux-kontext-pro ومعلماتك.
استطلع المهمة أو اتبع الاستدعاء الراجع لاسترداد نتيجة flux-kontext-pro المكتملة.
اضبط 8 معاملاً موثَّقاً، بما يشمل aspect_ratio, enable_prompt_expansion, enable_translation, output_format, prompt.
يعرض 1 endpoint(s) عامة: text_to_image.
تقبل المهام غير المتزامنة عنوان URL للاستدعاء عند اكتمال المهمة.
محسوبة بـ استدعاء دون اشتراط اشتراك.
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.
أنشئ تلقائيًا صور منتجات بأسلوب lifestyle لكتالوجات التجارة الإلكترونية التي تفتقر إلى تصوير استوديو.
ابتكر سريعًا مفاهيم للعوالم والشخصيات قبل الانتقال إلى العمل الفني النهائي.
أنشئ أعمال غلاف ورسومًا توضيحية فريدة للمدونات والمقالات على نطاق واسع.
مرّر معرّف النموذج الظاهر في دليل البدء السريع.
تتدرج حدود المعدل لكل مفتاح بحسب مستوى الاستخدام. راجع صفحة التسعير للاطلاع على الحدود الحالية.
نعم — المتغير مجرد خيار. بدّل عبر تغيير معامل model.
حيثما يتوفر البث، يقدّم RunAPI البث من البداية إلى النهاية.
افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.
لا. يكفي مفتاح RunAPI API للوصول إلى هذه النسخة وكل نموذج آخر في الكتالوج. لا تحتاج إلى حسابات لدى المزود الأساسي.