رفتن به محتوا

Luma Ray 3.2 Video to Video

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

شناسه مدل luma/agent/ray/v3.2/video-to-video
# 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/luma/agent/ray/v3.2/video-to-video?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",
    "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۷۲⁩ ۷۲۰ اعتبار API · ≈ ⁨‎₽۷۷٫۲۷⁩ اجرای آن در این صفحه

دریافت کلید API
Luma AI ویدیو به ویدیو همگام‌سازی لب۵–۱۰ ثانیهحداکثر 1080p #stylized#transform#lipsync

ویرایش ویدیو با Ray 3.2 که ویدیوی منبع را با پیش‌تنظیم‌ها، کنترل‌ها و فریم‌های کلیدی تغییر سبک می‌دهد

Luma AI · ویدیو

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

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

ساخت درخواست

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

•الزامی 88 / 6000

دستورهای متنی برای ویرایش ویدیوی منبع.

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

URL ویدیویی که باید ویرایش شود.

duration ۵ s

طول ویدیو پس از ویرایش.

resolution پیش‌فرض 540p

وضوح خروجی پس از ویرایش.

پیشرفته image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
یک فایل بیندازید، یا

بازنویسی فریم اول برای ویدیوی ویرایش‌شده، ارائه‌شده به‌صورت URL تصویر اختیاری؛ در صورت حذف، مدل آن فریم را از ویدیوی منبع استخراج می‌کند. برای نمونه، ارائه تصویر آغازین بازطراحی‌شده از منبع می‌تواند ظاهر ویرایش را هدایت کند.

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

تنظیم حفظ منبع برای ویرایش‌ها، فقط زمانی در دسترس است که auto_controls استفاده نشود؛ حذف آن مقدار پیش‌فرض مدل را انتخاب می‌کند. گزینه‌ها از بیشترین فاصله تا نزدیک‌ترین پیروی عبارت‌اند از 'reimagine_*'، 'flex_*' برای نتیجه متعادل و 'adhere_*'.

راهنماهای ویرایش چندفریم‌کلیدی که به‌جای start_image_url به‌صورت URL تصاویر ارائه می‌شوند. keyframes را همراه با آرایه هم‌اندازه keyframe_indexes ارائه کنید تا هر تصویر به موقعیت فریم خود در ویدیوی منبع متصل شود؛ حداکثر 64 URL مجاز است.

گزینه جایگزین دقیق‌تر برای edit_strength که شرطی‌سازی را جداگانه برای ژست، عمق، نرمال‌ها، مسیر حرکت و چهره تنظیم می‌کند. استفاده از این کنترل‌ها auto_controls را منتفی می‌کند.

نگاشت فریم منبع که یک‌به‌یک با فریم‌های کلیدی جفت می‌شود: مورد [i] موقعیت لنگر keyframes[i] را مشخص می‌کند. طول هر دو آرایه باید برابر باشد و موقعیت‌ها باید متمایز و نامنفی باشند.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 قیمت → ⁨‎$۰٫۷۲⁩
# 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/luma/agent/ray/v3.2/video-to-video?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",
    "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Luma Ray 3.2 Video to Video

یک `video_url` را طبق `prompt` ویرایش می‌کند و در صورت نیاز `start_image_url` فریم اول را هدایت می‌کند. `edit_strength` سطوح adhere، flex و reimagine از 1 تا 3 را ارائه می‌دهد، در حالی که `auto_controls` یا شیء `controls` شرطی‌سازی جایگزین را فراهم می‌کنند. حداکثر 64 `keyframes` را می‌توان با `keyframe_indexes` تثبیت کرد. خروجی 540p تا 1080p، با مدت 5s یا 10s و `hdr` و `exr_export` اختیاری است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۶٬۰۰۰ نویسه
دستورهای متنی برای ویرایش ویدیوی منبع.
video_urlالزامی video
نوعurl · video
URL ویدیویی که باید ویرایش شود.
userاختیاری
نوعstring | null
شناسه مات اختیاری برای شناسایی کاربر نهایی ارسال‌کننده درخواست.
start_image_urlاختیاری image
نوعurl · image
بازنویسی فریم اول برای ویدیوی ویرایش‌شده، ارائه‌شده به‌صورت URL تصویر اختیاری؛ در صورت حذف، مدل آن فریم را از ویدیوی منبع استخراج می‌کند. برای نمونه، ارائه تصویر آغازین بازطراحی‌شده از منبع می‌تواند ظاهر ویرایش را هدایت کند.
resolutionاختیاری
نوعenum
پیش‌فرض540p
540p720p1080p
وضوح خروجی پس از ویرایش.
durationاختیاری
نوعenum
پیش‌فرض5s
5s10s
طول ویدیو پس از ویرایش.
edit_strengthاختیاری
نوعenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
تنظیم حفظ منبع برای ویرایش‌ها، فقط زمانی در دسترس است که auto_controls استفاده نشود؛ حذف آن مقدار پیش‌فرض مدل را انتخاب می‌کند. گزینه‌ها از بیشترین فاصله تا نزدیک‌ترین پیروی عبارت‌اند از 'reimagine_*'، 'flex_*' برای نتیجه متعادل و 'adhere_*'.
auto_controlsاختیاری
نوعboolean
پیش‌فرضfalse
شرطی‌سازی ویرایش خودکار: مدل از ویدیوی منبع برای تعیین زمان‌بندی استفاده می‌کند، نه اینکه edit_strength را در کنار این گزینه بپذیرد.
hdrاختیاری
نوعboolean
پیش‌فرضfalse
کدگذاری HDR برای خروجی MP4 در 720p یا 1080p، فقط برای حساب‌های دارای دسترسی HDR در دسترس است.
exr_exportاختیاری
نوعboolean
پیش‌فرضfalse
خروجی EXR اضافی همراه MP4، فقط با دسترسی HDR و hdr=true در دسترس است.
controlsاختیاری
نوعobject
گزینه جایگزین دقیق‌تر برای edit_strength که شرطی‌سازی را جداگانه برای ژست، عمق، نرمال‌ها، مسیر حرکت و چهره تنظیم می‌کند. استفاده از این کنترل‌ها auto_controls را منتفی می‌کند.
controls.poseاختیاری
نوعobject
شرطی‌سازی مبتنی بر ژست یا اسکلت.
controls.pose.enabledاختیاری
نوعboolean
پیش‌فرضtrue
کلید شرطی‌سازی ژست یا اسکلت هنگام ویرایش.
controls.pose.strengthاختیاری
نوعenum
precisecoarse
انتخاب دقت شرطی‌سازی ژست: برای حفظ مقدار پیش‌فرض آن را حذف کنید، برای آزادی بیشتر 'coarse' یا برای دنبال‌کردن دقیق ژست منبع 'precise' را انتخاب کنید.
controls.depthاختیاری
نوعobject
شرطی‌سازی مبتنی بر عمق یا هندسه صحنه.
controls.depth.enabledاختیاری
نوعboolean
پیش‌فرضtrue
کلید شرطی‌سازی عمق یا هندسه صحنه هنگام ویرایش.
controls.depth.blurاختیاری
نوعnumber | null
۰ – ۱
تنظیم تاری عمق؛ برای حفظ مقدار پیش‌فرض مشخص نشود یا برای آزادی بیشتر هندسه افزایش یابد.
controls.normalsاختیاری
نوعobject
شرطی‌سازی مبتنی بر نرمال‌های سطح.
controls.normals.enabledاختیاری
نوعboolean
پیش‌فرضtrue
کلید شرطی‌سازی نرمال سطح هنگام ویرایش.
controls.normals.augmentationاختیاری
نوعnumber | null
۰ – ۱
تنظیم تقویت نرمال سطح؛ برای حفظ مقدار پیش‌فرض آن را حذف کنید یا برای امکان بازتفسیر بیشتر هندسه سطح، آن را افزایش دهید.
controls.trajectoryاختیاری
نوعobject
شرطی‌سازی مبتنی بر مسیرهای حرکت.
controls.trajectory.enabledاختیاری
نوعboolean
پیش‌فرضtrue
کلید شرطی‌سازی مسیر حرکت هنگام ویرایش.
controls.trajectory.sparsityاختیاری
نوعnumber | null
۰ – ۱
تنظیم تنکی مسیر حرکت؛ برای حفظ مقدار پیش‌فرض آن را حذف کنید یا برای کاهش تعداد لنگرهای حرکت استفاده‌شده، آن را افزایش دهید.
controls.faceاختیاری
نوعobject
شرطی‌سازی مبتنی بر هویت چهره.
controls.face.enabledاختیاری
نوعboolean
پیش‌فرضtrue
کلید شرطی‌سازی هویت چهره هنگام ویرایش.
keyframesاختیاری
نوعstring[]
≤ ۶۴ مورد
راهنماهای ویرایش چندفریم‌کلیدی که به‌جای start_image_url به‌صورت URL تصاویر ارائه می‌شوند. keyframes را همراه با آرایه هم‌اندازه keyframe_indexes ارائه کنید تا هر تصویر به موقعیت فریم خود در ویدیوی منبع متصل شود؛ حداکثر 64 URL مجاز است.
keyframe_indexesاختیاری
نوعinteger[]
≤ ۶۴ مورد
نگاشت فریم منبع که یک‌به‌یک با فریم‌های کلیدی جفت می‌شود: مورد [i] موقعیت لنگر keyframes[i] را مشخص می‌کند. طول هر دو آرایه باید برابر باشد و موقعیت‌ها باید متمایز و نامنفی باشند.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "luma/agent/ray/v3.2/video-to-video",
  "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": 720,
    "usd": "0.72",
    "charged": 720,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
    },
    "exr_file": {
      "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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}ویدیوی تولیدشده توسط مدل.
exr_file
object {url, content_type, file_name, file_size} | nullفایل جانبی EXR به‌شکل خروجی‌های Luma: یا یک فایل EXR یا یک آرشیو ZIP. زمانی تولید می‌شود که exr_export برابر true باشد.

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

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/luma/agent/ray/v3.2/video-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt