رفتن به محتوا

Lightx · Recamera

یکپارچه‌سازی

شناسه مدل lightx/recamera
# 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/recamera?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#recamera#relight

با مسیر دوربین جدید و نورپردازی مجدد، ویدیوی موجود را دوباره فیلم‌برداری می‌کند؛ کنترل با مسیر یا وضعیت هدف

Open model · ویدیو

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

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

ساخت درخواست

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

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

•الزامی video_url
یک فایل بیندازید، یا

نشانی اینترنتی ویدیوی ورودی.

پیشرفته camera · mode · seed · enable_safety_checker · trajectory · target_pose
camera پیش‌فرض traj

حالت کنترل دوربین.

mode پیش‌فرض gradual

حالت مورد استفاده برای حرکت دوربین.

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

تنظیمات مسیر دوربین، الزامی در حالت recamera.

ژست هدف دوربین، در صورت camera='target' الزامی است. آرایه را به‌ترتیب theta، سپس phi، سپس radius، سپس x و سپس y ارائه کنید.

POST /run/lightx/recamera?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/recamera?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 · Recamera

`video_url` ورودی را می‌گیرد و با تغییر دیدگاه دوربین دوباره رندر می‌کند. `camera` را روی `traj` قرار دهید و `trajectory` بدهید، یا روی `target` قرار دهید و `target_pose` را به‌شکل [theta, phi, radius, x, y] ارائه کنید. `mode` حرکت می‌تواند gradual، bullet، direct یا dolly-zoom باشد. `prompt` متنی اختیاری است؛ در صورت حذف، ویدیو به‌طور خودکار زیرنویس‌گذاری می‌شود.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
video_urlالزامی video
نوعurl · video
نشانی اینترنتی ویدیوی ورودی.
promptاختیاری
نوعstring | null
پرامپت متنی اختیاری؛ Light-X وقتی پرامپت ارائه نشود، به‌طور خودکار برای ویدیو کپشن تولید می‌کند.
seedاختیاری
نوعinteger | null
Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.
cameraاختیاری
نوعenum
پیش‌فرضtraj
trajtarget
حالت کنترل دوربین.
modeاختیاری
نوعenum
پیش‌فرضgradual
gradualbulletdirectdolly-zoom
حالت مورد استفاده برای حرکت دوربین.
trajectoryاختیاری
نوعobject
تنظیمات مسیر دوربین، الزامی در حالت recamera.
trajectory.thetaالزامی
نوعnumber[]
زاویه‌های چرخش افقی هر keyframe، برحسب درجه.
trajectory.phiالزامی
نوعnumber[]
زاویه‌های چرخش عمودی هر keyframe، برحسب درجه.
trajectory.radiusالزامی
نوعnumber[]
فاکتورهای هر keyframe برای مقیاس‌بندی فاصله دوربین.
target_poseاختیاری
نوعnumber[]
ژست هدف دوربین، در صورت camera='target' الزامی است. آرایه را به‌ترتیب theta، سپس phi، سپس radius، سپس x و سپس y ارائه کنید.
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/recamera",
  "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/recamera.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt