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

Illusion Diffusion

التكامل

معرّف النموذج illusion-diffusion
# 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/illusion-diffusion?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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

الحصول على مفتاح API
Open model من نص إلى صورة #composition#stylized

ينشئ صورًا بأسلوب الخداع البصري عبر تكييف مطالبة نصية على صورة إدخال باستخدام ControlNet

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب

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

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

URL لصورة المدخل.

image_size الافتراضي square_hd

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

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

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

scheduler الافتراضي Euler

المجدول أو أداة أخذ العينات المستخدمة لإزالة التشويش من الصورة.

الافتراضي 7.5

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

الافتراضي 1

المقياس المطبق على تكييف ControlNet.

الافتراضي 0
الافتراضي 1
الافتراضي 40

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

بذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.

POST /run/illusion-diffusion?wait=20 عرض السعر → ⁨‏0.022 $⁩
# 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/illusion-diffusion?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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Illusion Diffusion

يستقبل `image_url` و`prompt` المطلوبين ويمزج أشكال الصورة في الصورة المُولّدة، ما يلائم فن الخداع البصري. اضبط `controlnet_conditioning_scale` و`control_guidance_start` و`control_guidance_end` لتحديد قوة توجيه المصدر للنتيجة. يوفر أيضًا `negative_prompt` و`guidance_scale` من 0 إلى 50، ومن 0 إلى 80 خطوة استدلال، ومجدولي Euler أو DPM++ Karras SDE.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
URL لصورة المدخل.
promptمطلوب
النوعstring
صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد تفاصيل الصورة المطلوب استبعادها، بما في ذلك الألوان والعناصر والمشهد أو السمات الدقيقة. تشمل الأمثلة الشارب والضبابية والدقة المنخفضة.
guidance_scaleاختياري
النوعnumber
الافتراضي7.5
≤ 50> 0
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
controlnet_conditioning_scaleاختياري
النوعnumber
الافتراضي1
المقياس المطبق على تكييف ControlNet.
control_guidance_startاختياري
النوعnumber
الافتراضي0
0 – 1
control_guidance_endاختياري
النوعnumber
الافتراضي1
0 – 1
seedاختياري
النوعinteger | null
بذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.
schedulerاختياري
النوعenum
الافتراضيEuler
DPM++ Karras SDEEuler
المجدول أو أداة أخذ العينات المستخدمة لإزالة التشويش من الصورة.
num_inference_stepsاختياري
النوعinteger
الافتراضي40
0 – 80
يتحكم في عدد خطوات التوليد التي ينفذها Stable Diffusion؛ وقد تنتج الخطوات الإضافية صورة نهائية أكثر تفصيلاً.
image_sizeاختياري
النوعobject
الافتراضيsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد صورة المخرج، تُختار من إعدادات مسبقة أو تُحدّد بعرض وارتفاع مخصّصين. يجب أن تكون الأبعاد المخصّصة كلاهما قابلتين للقسمة على 8.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "illusion-diffusion",
  "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": 22,
    "usd": "0.022",
    "charged": 22,
    "refunded": 0
  },
  "input": {
    "image_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": {
    "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/illusion-diffusion.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt