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

Inpainting sdxl and sd

التكامل

معرّف النموذج 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/inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "diffusers/stable-diffusion-xl-1.0-inpainting-0.1",
    "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",
    "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://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

يملأ المناطق المقنّعة في صورة باستخدام أي نموذج أساسي SD أو SDXL مختار

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب

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

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

الصورة المصدر المستخدمة في وضع img2img أو inpaint.

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

قناع inpainting الذي تحدد مناطقه البيضاء مواضع inpaint وتحمي مناطقه السوداء المحتوى الموجود.

•مطلوب

النموذج الأساسي لتوليد الصورة، المحدد إما بعنوان URL أو بمعرّف HuggingFace.

متقدم negative_prompt · num_inference_steps · guidance_scale · seed · enable_safety_checker
الافتراضي

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

الافتراضي 30

يتحكم في عدد خطوات التوليد التي ينفذها Stable Diffusion؛ وقد تنتج الخطوات الإضافية صورة نهائية أكثر تفصيلاً.

الافتراضي 7.5

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

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

POST /run/inpaint?wait=20 عرض السعر → ⁨‏0.029 $⁩
# 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/inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "diffusers/stable-diffusion-xl-1.0-inpainting-0.1",
    "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",
    "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://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Inpainting sdxl and sd

يملأ المنطقة المقنّعة في صورة وفقًا لـ`prompt`. تختار نقطة التحقق الأساسية عبر `model_name` (عنوان URL أو معرّف HuggingFace). في `mask_url`، تُعاد طلاء المناطق البيضاء وتُحفظ المناطق السوداء. يدعم `negative_prompt` و`num_inference_steps` (من 0 إلى 150) و`guidance_scale` (من 0 إلى 20) و`seed`.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
model_nameمطلوب
النوعstring
النموذج الأساسي لتوليد الصورة، المحدد إما بعنوان URL أو بمعرّف HuggingFace.
promptمطلوب
النوعstring
صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد تفاصيل الصورة المطلوب استبعادها، بما في ذلك الألوان والعناصر والمشهد أو السمات الدقيقة. تشمل الأمثلة الشارب والضبابية والدقة المنخفضة.
image_urlمطلوب image
النوعurl · image
الصورة المصدر المستخدمة في وضع img2img أو inpaint.
mask_urlمطلوب mask
النوعurl · image
قناع inpainting الذي تحدد مناطقه البيضاء مواضع inpaint وتحمي مناطقه السوداء المحتوى الموجود.
num_inference_stepsاختياري
النوعinteger
الافتراضي30
0 – 150
يتحكم في عدد خطوات التوليد التي ينفذها Stable Diffusion؛ وقد تنتج الخطوات الإضافية صورة نهائية أكثر تفصيلاً.
guidance_scaleاختياري
النوعnumber
الافتراضي7.5
0 – 20
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
seedاختياري
النوعinteger | null
بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "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": 29,
    "usd": "0.029",
    "charged": 29,
    "refunded": 0
  },
  "input": {
    "model_name": "diffusers/stable-diffusion-xl-1.0-inpainting-0.1",
    "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",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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
    },
    "seed": 42
  },
  "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size, width, height}معلومات الملفات الخاصة بالصور المولّدة.
seed
integerبذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.

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