رفتن به محتوا

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"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۴۹⁩ ۴۹۰ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Open model ویدیو به ویدیو ورودی‌های مرجع #video-to-video

نورپردازی مجدد ویدیو بر اساس پرامپت، فریم مرجع، تصویر HDR یا تصویر پس‌زمینه

Open model · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

پرامپت متنی اختیاری؛ Light-X وقتی پرامپت ارائه نشود، به‌طور خودکار برای ویدیو کپشن تولید می‌کند.

•الزامی video_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 است.

Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.

تنظیمات نورپردازی مجدد که کاربردشان به relight_condition_type بستگی دارد: 'ic' به آن‌ها نیاز دارد، اما 'bg' نادیده‌شان می‌گیرد و به URL تصویر پس‌زمینه نیاز دارد.

POST /run/lightx/relight?wait=20 قیمت → ⁨‎$۰٫۴۹⁩
# 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
نشانی اینترنتی ویدیوی ورودی.
promptاختیاری
نوعstring | null
پرامپت متنی اختیاری؛ Light-X وقتی پرامپت ارائه نشود، به‌طور خودکار برای ویدیو کپشن تولید می‌کند.
seedاختیاری
نوعinteger | null
Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.
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
۱ – ۱۰
مقیاس راهنمایی بدون طبقه‌بندی اعمال‌شده هنگام نورپردازی مجدد.
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
۰ – ۴۸
مرجع نورپردازی مجدد انتخاب‌شده با شاخص فریم؛ تعداد فریم‌های تولیدشده کران بالای انحصاری است. این تعداد به‌طور پیش‌فرض 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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}فایل ویدیویی تولیدشده.
seed
integerمقدار Seed اعمال‌شده هنگام تولید.
input_video
object {url, content_type, file_name, file_size} | nullویدیوی ورودی نرمال‌سازی یا پردازش‌شده که در صورت تولید توسط pipeline به‌طور اختیاری برگردانده می‌شود.
viz_video
object {url, content_type, file_name, file_size} | nullویدیوی بصری‌سازی یا اشکال‌زدایی که در صورت تولید توسط pipeline به‌طور اختیاری برگردانده می‌شود.

مدل‌های بیشتر: ویدیو به ویدیو

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/lightx/relight.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt