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

IC-Light-v2 for Image Relighting

التكامل

معرّف النموذج iclight-v2
# 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/iclight-v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"
  }'

# 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.40 $⁩ 400 رصيد API · ≈ ⁨‏42.19 ₽⁩ تشغيله في هذه الصفحة

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

يعيد إضاءة صورة ويغيّر خلفيتها وفق وصف نصي

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب

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

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

رابط يشير إلى الصورة التي ستُعاد إضاءتها.

image_size

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

num_images الافتراضي 1

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

متقدم negative_prompt · mask_image_url · initial_latent · output_format · background_threshold · num_inference_steps · cfg · lowres_denoise · highres_denoise · hr_downscale · guidance_scale · seed · enable_hr_fix · enable_safety_checker
الافتراضي

موجّه سلبي يحدد محتوى الصورة غير المرغوب فيه.

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

عنوان URL للقناع الخاص بصورة تهيئة ic-light.

initial_latent الافتراضي None

ظروف الإضاءة المقدّمة إلى النموذج.

output_format الافتراضي jpeg

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

الافتراضي 0.67

عتبة قديمة لإزالة الخلفية، ولا تأثير حاليًا لها على النتائج. كان سلوكها المقصود زيادة حدة الأقنعة عند الإعدادات الأعلى.

الافتراضي 28

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

الافتراضي 1

مقياس التوجيه الفعلي الخالي من المصنّف المطبّق أثناء التوليد.

الافتراضي 0.98

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

الافتراضي 0.95

القوة المطبّقة أثناء المرور عالي الدقة؛ ولا تسري إلا عند كون enable_hr_fix هو True.

الافتراضي 0.5
الافتراضي 5

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

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

POST /run/iclight-v2?wait=20 عرض السعر → ⁨‏0.40 $⁩
# 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/iclight-v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"
  }'

# 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

حول IC-Light-v2 for Image Relighting

يستقبل صورة مصدر (`image_url`) و`prompt` تصف الإضاءة والخلفية المطلوبتين. يمكن لـ`initial_latent` تحديد اتجاه الضوء (Left أو Right أو Top أو Bottom)، كما تقيّد `mask_image_url` اختيارية النتيجة. يوفر `enable_hr_fix` لمعالجة عالية الدقة، و1-4 مخرجات عبر `num_images`، وإخراج jpeg أو png.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
الموجّه الذي يوجّه توليد الصورة.
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد محتوى الصورة غير المرغوب فيه.
image_urlمطلوب image
النوعurl · image
رابط يشير إلى الصورة التي ستُعاد إضاءتها.
mask_image_urlاختياري
النوعurl · image
عنوان URL للقناع الخاص بصورة تهيئة ic-light.
background_thresholdاختياري
النوعnumber
الافتراضي0.67
0.01 – 1
عتبة قديمة لإزالة الخلفية، ولا تأثير حاليًا لها على النتائج. كان سلوكها المقصود زيادة حدة الأقنعة عند الإعدادات الأعلى.
image_sizeاختياري
النوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد الصورة المُولّدة.
num_inference_stepsاختياري
النوعinteger
الافتراضي28
1 – 50
عدد خطوات الاستدلال المطلوب تنفيذها.
seedاختياري
النوعinteger | null
بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.
initial_latentاختياري
النوعenum
الافتراضيNone
NoneLeftRightTopBottom
ظروف الإضاءة المقدّمة إلى النموذج.
enable_hr_fixاختياري
النوعboolean
الافتراضيfalse
يمكّن HR fix.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليده.
cfgاختياري
النوعnumber
الافتراضي1
0.01 – 5
مقياس التوجيه الفعلي الخالي من المصنّف المطبّق أثناء التوليد.
lowres_denoiseاختياري
النوعnumber
الافتراضي0.98
0.01 – 1
القوة المطبّقة أثناء المرور منخفض الدقة.
highres_denoiseاختياري
النوعnumber
الافتراضي0.95
0.01 – 1
القوة المطبّقة أثناء المرور عالي الدقة؛ ولا تسري إلا عند كون enable_hr_fix هو True.
hr_downscaleاختياري
النوعnumber
الافتراضي0.5
0.01 – 1
guidance_scaleاختياري
النوعnumber
الافتراضي5
0 – 20
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص الأمان الذي يتطلب إعداد إيقافه تفويض الحساب. من دون هذا التفويض، يُفحص كل طلب بغض النظر عن الإعداد؛ وتفعّل true أداة الفحص.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق ملف الصورة الناتجة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

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