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

Fooocus Inpainting

التكامل

معرّف النموذج fooocus/inpaint
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/fooocus/inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inpaint_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

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

الحصول على مفتاح API
Open model تحرير الصور #stylized#editing

يرسم داخل الصورة أو خارجها مع قناع اختياري، وبأوضاع لإصلاح التفاصيل أو تغيير المحتوى

Open model · صورة

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

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

إنشاء طلب

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

الافتراضي

صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.

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

صورة مرجعية مستخدمة أثناء الرسم داخل الصورة.

الافتراضي 1024x1024

أبعاد صورة المخرج، تُختار من إعدادات مسبقة أو تُحدّد بعرض وارتفاع مخصّصين. يجب أن تكون الأبعاد المخصّصة كلاهما قابلتين للقسمة على 8.

num_images الافتراضي 1

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

متقدم negative_prompt · inpaint_additional_prompt · mask_image_url · performance · output_format · inpaint_engine · refiner_model · inpaint_mode · guidance_scale · sharpness · refiner_switch · inpaint_strength · inpaint_respective_field · inpaint_erode_or_dilate · seed · override_inpaint_options · inpaint_disable_initial_latent · invert_mask · mixing_image_prompt_and_inpaint · enable_safety_checker · styles · outpaint_selections · loras · image_prompt_1 · image_prompt_2 · image_prompt_3 · image_prompt_4
الافتراضي

موجّه سلبي يحدد تفاصيل الصورة المطلوب استبعادها، بما في ذلك الألوان والعناصر والمشهد أو السمات الدقيقة. تشمل الأمثلة الشارب والضبابية والدقة المنخفضة.

الافتراضي

وصف محتوى الرسم داخل الصورة المطلوب.

أفلت ملفًا، أو

صورة قناع تُطبّق أثناء توليد الصورة.

performance الافتراضي Extreme Speed

خيار الأداء: Speed أو Quality.

output_format الافتراضي jpeg

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

inpaint_engine الافتراضي v2.6

إصدار النموذج لرسم Fooocus داخل الصورة.

الافتراضي None

اختيار المحسّن: SDXL أو SD 1.5.

الافتراضي Inpaint or Outpaint (...

الوضع المطبّق أثناء الرسم داخل الصورة.

الافتراضي 4

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

الافتراضي 2

إعداد حدة صورة المخرج. تؤدي زيادته إلى جعل الصورة وملمسها أكثر حدة.

الافتراضي 0.8

قيمة تبديل المحسّن: استخدم 0.4 مع نماذج SD1.5 الواقعية، و0.667 مع نماذج SD1.5 للرسوم المتحركة، و0.8 مع XL-refiners. يتيح التبديل بين نموذجي SDXL أي قيمة.

الافتراضي 1

قوة إزالة الضوضاء للرسم داخل الصورة، وهي مكافئة لإعداد inpaint في A1111. لا تنطبق على الرسم خارج الصورة، الذي يستخدم دائمًا 1.0.

الافتراضي 0.618

حدّد المنطقة للرسم داخل الصورة باستخدام مكافئات A1111: يقابل "Only Masked" القيمة 0، وتقابل "Whole Image" القيمة 1. يتجاهل الرسم خارج الصورة هذا الإعداد ويستخدم دائمًا 1.0.

الافتراضي 0

اضبط المنطقة البيضاء للقناع قبل أي عكس، مع قيمة افتراضية تبلغ 0. استخدم القيم الموجبة لتوسيع تلك المنطقة أو القيم السالبة لتقليصها.

بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.

الافتراضي ["Fooocus Enhance","F...

النمط المطبّق أثناء التوليد.

الافتراضي []

الاتجاهات التي يمدد فيها الرسم خارج الصورة.

الافتراضي [{"path":"https://hug...

اختيار LoRA المدموج للتوليد النهائي للصورة، بحد أقصى 5 LoRAs.

POST /run/fooocus/inpaint?wait=20 عرض السعر → ⁨‏0.055 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/fooocus/inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inpaint_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

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

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

حول Fooocus Inpainting

يعدّل صورة موجودة بإعادة إنشاء منطقة مقنّعة أو تمديد حدودها. قدم `inpaint_image_url` واختياريًا `mask_image_url`، ثم اختر `inpaint_mode`: رسم داخلي/خارجي عادي، أو تحسين التفاصيل، أو تعديل المحتوى. يقبل أيضًا LoRA وما يصل إلى أربع مطالبات صورية وخيار محسّن، مع إخراج من 1 إلى 4 صور لكل طلب بصيغة png أو jpeg أو webp. تتيح إعدادات Strength وrespective-field تحكمًا أدق في مقدار التغيير.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptاختياري
النوعstring
الافتراضي
صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد تفاصيل الصورة المطلوب استبعادها، بما في ذلك الألوان والعناصر والمشهد أو السمات الدقيقة. تشمل الأمثلة الشارب والضبابية والدقة المنخفضة.
stylesاختياري
النوعenum[]
الافتراضي["Fooocus Enhance","Fooocus Sharp","Fooocus V2"]
النمط المطبّق أثناء التوليد.
performanceاختياري
النوعenum
الافتراضيExtreme Speed
SpeedQualityExtreme SpeedLightning
خيار الأداء: Speed أو Quality.
guidance_scaleاختياري
النوعnumber
الافتراضي4
1 – 30
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
sharpnessاختياري
النوعnumber
الافتراضي2
0 – 30
إعداد حدة صورة المخرج. تؤدي زيادته إلى جعل الصورة وملمسها أكثر حدة.
aspect_ratioاختياري
النوعstring
الافتراضي1024x1024
أبعاد صورة المخرج، تُختار من إعدادات مسبقة أو تُحدّد بعرض وارتفاع مخصّصين. يجب أن تكون الأبعاد المخصّصة كلاهما قابلتين للقسمة على 8.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليدها لكل طلب.
lorasاختياري
النوعobject[]
الافتراضي[{"path":"https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/main/sd_xl_offset_example-lora_1.0.safetensors","scale":0.1}]
اختيار LoRA المدموج للتوليد النهائي للصورة، بحد أقصى 5 LoRAs.
loras[].pathمطلوب
النوعstring
موقع أوزان LoRA، محدد كرابط أو مسار.
loras[].scaleاختياري
النوعnumber
الافتراضي0.1
0 – 1
المضاعف المطبق على وزن LoRA قبل دمجه في النموذج الأساسي.
refiner_modelاختياري
النوعenum
الافتراضيNone
NonerealisticVisionV60B1_v51VAE.safetensors
اختيار المحسّن: SDXL أو SD 1.5.
refiner_switchاختياري
النوعnumber
الافتراضي0.8
0 – 1
قيمة تبديل المحسّن: استخدم 0.4 مع نماذج SD1.5 الواقعية، و0.667 مع نماذج SD1.5 للرسوم المتحركة، و0.8 مع XL-refiners. يتيح التبديل بين نموذجي SDXL أي قيمة.
output_formatاختياري
النوعenum
الافتراضيjpeg
pngjpegwebp
تنسيق ملف الصورة الناتجة.
seedاختياري
النوعinteger | null
بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.
inpaint_image_urlمطلوب
النوعurl · image
صورة مرجعية مستخدمة أثناء الرسم داخل الصورة.
mask_image_urlاختياري
النوعurl · image
صورة قناع تُطبّق أثناء توليد الصورة.
inpaint_modeاختياري
النوعenum
الافتراضيInpaint or Outpaint (default)
Inpaint or Outpaint (default)Improve Detail (face, hand, eyes, etc.)Modify Content (add objects, change background, etc.)
الوضع المطبّق أثناء الرسم داخل الصورة.
inpaint_additional_promptاختياري
النوعstring
الافتراضي
وصف محتوى الرسم داخل الصورة المطلوب.
outpaint_selectionsاختياري
النوعenum[]
الافتراضي[]
الاتجاهات التي يمدد فيها الرسم خارج الصورة.
override_inpaint_optionsاختياري
النوعboolean
الافتراضيfalse
مفتاح تجاوز لإعدادات الرسم داخل الصورة المتقدمة: `inpaint_disable_initial_latent`, `inpaint_engine`, `inpaint_strength`, `inpaint_respective_field`, و`inpaint_erode_or_dilate`. يؤدي تعيينه إلى true إلى تجاوز هذه الخيارات؛ وإلا فتُطبّق قيمها الافتراضية.
inpaint_disable_initial_latentاختياري
النوعboolean
الافتراضيfalse
مفتاح المعالجة المسبقة الأولية: يؤدي true إلى تعطيل تلك المعالجة.
inpaint_engineاختياري
النوعenum
الافتراضيv2.6
Nonev1v2.5v2.6
إصدار النموذج لرسم Fooocus داخل الصورة.
inpaint_strengthاختياري
النوعnumber
الافتراضي1
≤ 1> 0
قوة إزالة الضوضاء للرسم داخل الصورة، وهي مكافئة لإعداد inpaint في A1111. لا تنطبق على الرسم خارج الصورة، الذي يستخدم دائمًا 1.0.
inpaint_respective_fieldاختياري
النوعnumber
الافتراضي0.618
0 – 1
حدّد المنطقة للرسم داخل الصورة باستخدام مكافئات A1111: يقابل "Only Masked" القيمة 0، وتقابل "Whole Image" القيمة 1. يتجاهل الرسم خارج الصورة هذا الإعداد ويستخدم دائمًا 1.0.
inpaint_erode_or_dilateاختياري
النوعnumber
الافتراضي0
-64 – 64
اضبط المنطقة البيضاء للقناع قبل أي عكس، مع قيمة افتراضية تبلغ 0. استخدم القيم الموجبة لتوسيع تلك المنطقة أو القيم السالبة لتقليصها.
invert_maskاختياري
النوعboolean
الافتراضيfalse
مفتاح عكس القناع؛ يؤدي true إلى عكس القناع.
image_prompt_1اختياري
النوعobject
image_prompt_1.typeاختياري
النوعenum
الافتراضيImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_1.image_urlاختياري
النوعurl · image
image_prompt_1.stop_atاختياري
النوعnumber
الافتراضي0.5
0 – 1
image_prompt_1.weightاختياري
النوعnumber
الافتراضي1
0 – 2
image_prompt_2اختياري
النوعobject
image_prompt_2.typeاختياري
النوعenum
الافتراضيImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_2.image_urlاختياري
النوعurl · image
image_prompt_2.stop_atاختياري
النوعnumber
الافتراضي0.5
0 – 1
image_prompt_2.weightاختياري
النوعnumber
الافتراضي1
0 – 2
image_prompt_3اختياري
النوعobject
image_prompt_3.typeاختياري
النوعenum
الافتراضيImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_3.image_urlاختياري
النوعurl · image
image_prompt_3.stop_atاختياري
النوعnumber
الافتراضي0.5
0 – 1
image_prompt_3.weightاختياري
النوعnumber
الافتراضي1
0 – 2
image_prompt_4اختياري
النوعobject
image_prompt_4.typeاختياري
النوعenum
الافتراضيImagePrompt
ImagePromptPyraCannyCPDSFaceSwap
image_prompt_4.image_urlاختياري
النوعurl · image
image_prompt_4.stop_atاختياري
النوعnumber
الافتراضي0.5
0 – 1
image_prompt_4.weightاختياري
النوعnumber
الافتراضي1
0 – 2
mixing_image_prompt_and_inpaintاختياري
النوعboolean
الافتراضيfalse
يجمع بين موجّه الصورة والترميم.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فاحص السلامة؛ يؤدي ضبطه على false إلى تعطيل الفحص.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fooocus/inpaint",
  "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": 55,
    "usd": "0.055",
    "charged": 55,
    "refunded": 0
  },
  "input": {
    "inpaint_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",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "has_nsfw_concepts": [
      false
    ]
  },
  "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://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, content_type, file_name, file_size, width, height}معلومات ملف الصورة المولدة.
timings
objectالوقت المنقضي للتوليد.
has_nsfw_concepts
array of booleanيشير إلى ما إذا كانت مفاهيم NSFW تظهر في الصور المُولّدة.

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

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