تخطّي إلى المحتوى

FLUX.1 Kontext [dev]

التكامل

معرّف النموذج flux-kontext/dev
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux-kontext/dev?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ≈⁨‏0.025 $⁩ 25 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Black Forest Labs تحرير الصور

تحرير صور Kontext قائم على التعليمات وبأوزان مفتوحة مع إعداد للسرعة

Black Forest Labs · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

موجّه يصف تعديلات الصورة.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL لصورة للتحرير، بحد أقصى للعرض والارتفاع قدره 14142px ومهلة قدرها 20 ثانية.

num_images الافتراضي 1

عدد الصور المطلوب توليده.

متقدم output_format · acceleration · resolution_mode · num_inference_steps · guidance_scale · seed · enable_safety_checker
output_format الافتراضي jpeg

التنسيق المستخدم للمخرج.

acceleration الافتراضي none

تسريع التوليد، إذ تقلل الإعدادات الأعلى الوقت اللازم لتوليد النتائج.

الافتراضي match_input

اختر كيفية تحديد تحرير الصورة للدقة الناتجة: يحاول `match_input` الاحتفاظ بأبعاد المدخل، لكنه يعدلها لتلبية متطلبات النموذج، بما في ذلك مضاعفات 16 وحدود الأحجام المدعومة. بالنسبة لمعظم الاستخدامات، يُنصح بـ `auto` لأنه يستخدم الدقات التي دُرّب عليها النموذج، ويختار الحجم المحدد مسبقًا الأمثل لنسبة أبعاد المدخل. تتوفر أيضًا بعض نسب الأبعاد الصريحة.

الافتراضي 28

عدد خطوات الاستدلال المطلوب تنفيذها.

الافتراضي 2.5

قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).

بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.

POST /run/flux-kontext/dev?wait=20 عرض السعر → ⁨‏0.025 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux-kontext/dev?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول FLUX.1 Kontext [dev]

يحرر صورة من `image_url` باتباع `prompt` نصي. يمكن لـ `resolution_mode` مطابقة الإدخال أو الاختيار تلقائيًا أو فرض نسبة مثل 16:9 أو 9:21. يوفر `acceleration` الخيارات none أو regular أو high، ويدعم النموذج من 10 إلى 50 خطوة وما يصل إلى 4 مخرجات.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
موجّه يصف تعديلات الصورة.
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة للتحرير، بحد أقصى للعرض والارتفاع قدره 14142px ومهلة قدرها 20 ثانية.
num_inference_stepsاختياري
النوعinteger
الافتراضي28
10 – 50
عدد خطوات الاستدلال المطلوب تنفيذها.
seedاختياري
النوعinteger | null
بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.
guidance_scaleاختياري
النوعnumber
الافتراضي2.5
1 – 20
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليده.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
فحص السلامة، الذي يعيد صورًا سوداء بدلًا من أي صور مصنفة على أنها غير آمنة. تُمكّن القيمة true الفحص؛ وتعطله false للحسابات المخولة فقط، بينما تُفحص الطلبات من دون تخويل على أي حال.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
التنسيق المستخدم للمخرج.
accelerationاختياري
النوعenum
الافتراضيnone
noneregularhigh
تسريع التوليد، إذ تقلل الإعدادات الأعلى الوقت اللازم لتوليد النتائج.
resolution_modeاختياري
النوعenum
الافتراضيmatch_input
automatch_input1:116:921:93:22:34:55:43:44:39:169:21
اختر كيفية تحديد تحرير الصورة للدقة الناتجة: يحاول `match_input` الاحتفاظ بأبعاد المدخل، لكنه يعدلها لتلبية متطلبات النموذج، بما في ذلك مضاعفات 16 وحدود الأحجام المدعومة. بالنسبة لمعظم الاستخدامات، يُنصح بـ `auto` لأنه يستخدم الدقات التي دُرّب عليها النموذج، ويختار الحجم المحدد مسبقًا الأمثل لنسبة أبعاد المدخل. تتوفر أيضًا بعض نسب الأبعاد الصريحة.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux-kontext/dev",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 25,
    "usd": "0.025",
    "charged": 25,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, width, height, content_type}معلومات الملفات الخاصة بالصور المولّدة.
timings
object
seed
integerبذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.
has_nsfw_concepts
array of booleanيشير إلى ما إذا كانت مفاهيم NSFW تظهر في الصور المُولّدة.
prompt
stringالموجّه المستخدم أثناء توليد الصورة.

مزيد من النماذج: تحرير الصور

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/flux-kontext/dev.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt