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

Playground v2.5 · Inpainting

التكامل

معرّف النموذج playground-v25/inpainting
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/playground-v25/inpainting?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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

هذا الطلب: ≈⁨‏0.004 $⁩ 4 أرصدة API · ≈ ⁨‏0.43 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح API
Playground تحرير الصور #inpaint#artistic#style

يعيد طلاء المناطق المقنّعة من صورة وفقًا لموجّه، باستخدام صورة قناع منفصلة

Playground · صورة

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

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

إنشاء طلب

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

•مطلوب

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

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

الصورة الابتدائية للتوليد، مقدّمة عبر عنوان URL.

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

عنوان URL يشير إلى قناع الطلاء الداخلي.

image_size الافتراضي square_hd

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

num_images الافتراضي 1

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

متقدم negative_prompt · safety_checker_version · format · request_id · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · embeddings
الافتراضي

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

safety_checker_version الافتراضي v1

اختر بين مدقق أمان ViT مخصص (`v2`) ومدقق CompVis (`v1`، الافتراضي).

format الافتراضي jpeg

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

الافتراضي

معرّف الطلب لربط الاستجابة بالطلب الذي أنشأها.

الافتراضي 25

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

الافتراضي 3

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

الافتراضي 0.95

درجة التشابه بين الصورة المُولّدة والصورة الابتدائية.

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

الافتراضي []

التضمينات المحددة للاستخدام، والمقدَّمة كقائمة.

POST /run/playground-v25/inpainting?wait=20 عرض السعر → ⁨‏0.004 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/playground-v25/inpainting?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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

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

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

حول Playground v2.5 · Inpainting

يتطلب `image_url` و`mask_url` و`prompt` ويعيد إنشاء المنطقة المقنّعة. تتراوح `strength` من 0.01 إلى 1، وخطوات الاستدلال من 1 إلى 65، و`guidance_scale` من 0 إلى 20. يمكن طلب ما يصل إلى 8 مخرجات بصيغة jpeg أو png. ويدعم أيضًا `negative_prompt` و`seed` والتضمينات وقيم `image_size` المسبقة.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
الصورة الابتدائية للتوليد، مقدّمة عبر عنوان URL.
mask_urlمطلوب mask
النوعurl · image
عنوان URL يشير إلى قناع الطلاء الداخلي.
promptمطلوب
النوعstring
صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد تفاصيل الصورة غير المرغوبة. يمكنه استبعاد الألوان والعناصر والمشهد أو السمات والصفات الدقيقة، مثل الشارب أو الضبابية أو الدقة المنخفضة.
image_sizeاختياري
النوعobject
الافتراضيsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد الصورة المُولّدة.
num_inference_stepsاختياري
النوعinteger
الافتراضي25
1 – 65
عدد خطوات الاستدلال المطلوب تنفيذها.
guidance_scaleاختياري
النوعnumber
الافتراضي3
0 – 20
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
strengthاختياري
النوعnumber
الافتراضي0.95
0.01 – 1
درجة التشابه بين الصورة المُولّدة والصورة الابتدائية.
seedاختياري
النوعinteger | null
بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 8
عدد الصور المطلوب توليده.
embeddingsاختياري
النوعobject[]
الافتراضي[]
التضمينات المحددة للاستخدام، والمقدَّمة كقائمة.
embeddings[].pathمطلوب
النوعstring
أوزان التضمين المحددة عبر عنوان URL أو مسار ملف.
embeddings[].tokensاختياري
النوعstring[]
قائمة رموز التضمين، مع توفر تسمية تلقائية عند حذفها: يتلقى كل متجه في ملف التضمين رمزًا من التسلسل <s0> و<s1> ... .
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
تنشيط مدقق السلامة؛ تُمكّن true الفحص.
safety_checker_versionاختياري
النوعenum
الافتراضيv1
v1v2
اختر بين مدقق أمان ViT مخصص (`v2`) ومدقق CompVis (`v1`، الافتراضي).
expand_promptاختياري
النوعboolean
الافتراضيfalse
توسيع الموجّه بموجّهات إضافية، ويُفعَّل عند كون القيمة true.
formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق ملف الصورة الناتجة.
request_idاختياري
النوعstring
الافتراضي
معرّف الطلب لربط الاستجابة بالطلب الذي أنشأها.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "playground-v25/inpainting",
  "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": 4,
    "usd": "0.004",
    "charged": 4,
    "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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/playground-v25/inpainting.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt