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

FLUX.1 [dev] Fill with LoRAs

التكامل

معرّف النموذج flux-lora-fill
# 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-lora-fill?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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.07 $⁩ 70 رصيد API تشغيله في هذه الصفحة

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

ترميم بأسلوب الملء باستخدام LoRAs، مع صورة مرجعية اختيارية للمنطقة المقنّعة والتحكم في الإرجاع

Black Forest Labs · صورة

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

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

إنشاء طلب

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

الافتراضي

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

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

عنوان URL للصورة الخاصة بعملية الملء.

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

قناع يحدد المنطقة الخاصة بالرسم الداخلي.

image_size

أبعاد الصورة المُولّدة.

num_images الافتراضي 1

حدد عدد الصور المراد توليدها؛ يثبت هذا الاختيار عند 1 عندما يكون المخرج متدفقًا.

متقدم output_format · acceleration · num_inference_steps · guidance_scale · seed · enable_safety_checker · paste_back · resize_to_original · loras · fill_image
output_format الافتراضي jpeg

تنسيق ملف الصورة الناتجة.

acceleration الافتراضي none

إعداد تسريع توليد الصورة. اختر 'regular' لتحقيق توازن بين السرعة والجودة.

الافتراضي 28

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

الافتراضي 30

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

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

الافتراضي []

نماذج LoRA التي ينتج تأثيرها المشترك الصورة المولدة، دون حد لعدد النماذج المقدمة.

قدّم مدخل ملء صورة لوضع محتوى الصورة المختار داخل القناع.

POST /run/flux-lora-fill?wait=20 عرض السعر → ⁨‏0.07 $⁩
# 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-lora-fill?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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 [dev] Fill with LoRAs

يملأ منطقة مقنّعة من `image_url` باستخدام `mask_url`، مع `prompt` اختياري وأي عدد من `loras`. يمكن لـ `fill_image` توفير محتوى للمنطقة المقنّعة. تحافظ `paste_back` على المناطق غير المقنّعة من الأصل، بينما يعيد `resize_to_original` أبعاد المصدر. تتراوح `guidance_scale` من 28 إلى 35، وتُعاد من 1 إلى 4 صور.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptاختياري
النوعstring
الافتراضي
الموجّه الذي يوجّه توليد الصورة.
image_sizeاختياري
النوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد الصورة المُولّدة.
num_inference_stepsاختياري
النوعinteger
الافتراضي28
1 – 50
عدد خطوات الاستدلال المطلوب تنفيذها.
seedاختياري
النوعinteger | null
بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.
lorasاختياري
النوعobject[]
الافتراضي[]
نماذج LoRA التي ينتج تأثيرها المشترك الصورة المولدة، دون حد لعدد النماذج المقدمة.
loras[].pathمطلوب
النوعstring
موقع أوزان LoRA، محدد كرابط أو مسار.
loras[].scaleاختياري
النوعnumber
الافتراضي1
0 – 4
المضاعف المطبق على وزن LoRA قبل دمجه في النموذج الأساسي.
guidance_scaleاختياري
النوعnumber
الافتراضي30
28 – 35
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
حدد عدد الصور المراد توليدها؛ يثبت هذا الاختيار عند 1 عندما يكون المخرج متدفقًا.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
فحص السلامة، الذي يعيد صورًا سوداء بدلًا من أي صور مصنفة على أنها غير آمنة. تُمكّن القيمة true الفحص؛ وتعطله false للحسابات المخولة فقط، بينما تُفحص الطلبات من دون تخويل على أي حال.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق ملف الصورة الناتجة.
accelerationاختياري
النوعenum
الافتراضيnone
noneregular
إعداد تسريع توليد الصورة. اختر 'regular' لتحقيق توازن بين السرعة والجودة.
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة الخاصة بعملية الملء.
mask_urlمطلوب mask
النوعurl · image
قناع يحدد المنطقة الخاصة بالرسم الداخلي.
paste_backاختياري
النوعboolean
الافتراضيtrue
استعد وحدات البكسل من الصورة الأصلية في مناطق المخرج الواقعة خارج المنطقة المرسومة داخليًا عند تفعيل هذا الخيار.
fill_imageاختياري
النوعobject
قدّم مدخل ملء صورة لوضع محتوى الصورة المختار داخل القناع.
fill_image.fill_image_urlاختياري
النوعurl[] · image
عناوين URL للصور التي تحدد المحتوى المراد إدراجه في المنطقة المقنّعة.
fill_image.in_context_fillاختياري
النوعboolean
الافتراضيfalse
حسّن دقة الملء عبر اعتبار الصورة الأساسية سياقًا عند استخدام صورة الملء المقدمة.
fill_image.use_promptاختياري
النوعboolean
الافتراضيfalse
أدرج الموجّه كمدخل توليد إضافي إلى جانب صورة redux عند التفعيل.
resize_to_originalاختياري
النوعboolean
الافتراضيfalse
خيار تغيير حجم يحافظ على أبعاد الصورة المقدمة بدقة عبر استعادتها بعد المعالجة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux-lora-fill",
  "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": 70,
    "usd": "0.07",
    "charged": 70,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_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-lora-fill.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt