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

Lightx · Relight

التكامل

معرّف النموذج lightx/relight
# 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/lightx/relight?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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.49 $⁩ 490 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model من فيديو إلى فيديو مدخلات مرجعية #video-to-video

إعادة إضاءة فيديو بتوجيه من موجّه أو إطار مرجعي أو صورة HDR أو صورة خلفية

Open model · فيديو

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

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

إنشاء طلب

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

موجّه نصي اختياري؛ ينشئ Light-X تسمية للفيديو تلقائيًا عند عدم توفير موجّه.

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

عنوان URL لفيديو المدخل.

متقدم relit_cond_type · relit_cond_img_url · ref_id · seed · enable_safety_checker · relight_parameters
relit_cond_type الافتراضي ic

نوع الشرط المستخدم لإعادة الإضاءة.

عنوان URL لصورة شرط مطلوبة لإعدادات 'ref' و'hdr' و'bg' في relight_condition_type؛ وفي وضع 'bg' توفر الخلفية.

الافتراضي 0

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

بذرة تجعل التوليد قابلًا لإعادة الإنتاج. يؤدي ضبطها على None إلى اختيار بذرة عشوائيًا.

إعدادات إعادة الإضاءة التي يعتمد استخدامها على relight_condition_type: يتطلبها 'ic'، بينما يتجاهلها 'bg' ويتطلب بدلًا منها عنوان URL لصورة خلفية.

POST /run/lightx/relight?wait=20 عرض السعر → ⁨‏0.49 $⁩
# 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/lightx/relight?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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

حول Lightx · Relight

يغير إضاءة فيديو الإدخال. تحدد `relit_cond_type` الشرط: ic (يستخدم `relight_parameters`) أو ref أو hdr أو bg، وتحتاج الأنواع الثلاثة الأخيرة إلى صورة تهيئة في `relit_cond_img_url`. تحدد `ref_id` (من 0 إلى 48) الإطار المرجعي لوضع ref. يكون `prompt` النصي اختياريًا، ويُنشأ وصف تلقائي للفيديو عند حذفه.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL لفيديو المدخل.
promptاختياري
النوعstring | null
موجّه نصي اختياري؛ ينشئ Light-X تسمية للفيديو تلقائيًا عند عدم توفير موجّه.
seedاختياري
النوعinteger | null
بذرة تجعل التوليد قابلًا لإعادة الإنتاج. يؤدي ضبطها على None إلى اختيار بذرة عشوائيًا.
relit_cond_typeاختياري
النوعenum
الافتراضيic
icrefhdrbg
نوع الشرط المستخدم لإعادة الإضاءة.
relight_parametersاختياري
النوعobject
إعدادات إعادة الإضاءة التي يعتمد استخدامها على relight_condition_type: يتطلبها 'ic'، بينما يتجاهلها 'bg' ويتطلب بدلًا منها عنوان URL لصورة خلفية.
relight_parameters.relight_promptمطلوب
النوعstring
موجّه نصي يحدد ظروف الإضاءة المطلوب إنتاجها.
relight_parameters.bg_sourceاختياري
النوعenum
الافتراضيLeft
LeftRightTopBottom
اتجاه مصدر الضوء لـ IC-light.
relight_parameters.cfgاختياري
النوعnumber
الافتراضي2
1 – 10
مقياس التوجيه الخالي من المصنّف المطبّق أثناء إعادة الإضاءة.
relight_parameters.use_sky_maskاختياري
النوعboolean
الافتراضيfalse
مفتاح قناع السماء للمشاهد الخارجية.
relit_cond_img_urlاختياري
النوعstring | null
عنوان URL لصورة شرط مطلوبة لإعدادات 'ref' و'hdr' و'bg' في relight_condition_type؛ وفي وضع 'bg' توفر الخلفية.
ref_idاختياري
النوعinteger
الافتراضي0
0 – 48
مرجع إعادة الإضاءة المحدد بواسطة فهرس الإطار، مع استخدام عدد الإطارات المُنشأة كحد أعلى حصري. القيمة الافتراضية لهذا العدد هي 49.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "lightx/relight",
  "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": 490,
    "usd": "0.49",
    "charged": 490,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "input_video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "viz_video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}ملف الفيديو الناتج عن التوليد.
seed
integerقيمة البذرة المطبّقة أثناء التوليد.
input_video
object {url, content_type, file_name, file_size} | nullفيديو المدخل المُطبّع أو المُعالَج، ويُعاد اختياريًا عندما ينتجه المسار.
viz_video
object {url, content_type, file_name, file_size} | nullفيديو التصور أو تصحيح الأخطاء، ويُعاد اختياريًا عندما ينتجه المسار.

مزيد من النماذج: من فيديو إلى فيديو

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