رفتن به محتوا

Luma Ray 3.2 Image to Video

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

شناسه مدل luma/agent/ray/v3.2/image-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/image-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"
  }'

# 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، با فریم پایانی یا حداکثر 64 فریم کلیدی، حلقه و خروجی اختیاری HDR/EXR

Luma AI · ویدیو

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

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

ساخت درخواست

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

•الزامی 88 / 6000

توضیح متنی صحنه یا حرکتی که باید ایجاد شود.

duration ۵ s

مدت ویدیوی تولیدشده. یک لنگر image_url / end_image_url نمی‌تواند 10s را پشتیبانی کند؛ این مدت به چند فریم کلیدی ارائه‌شده از طریق keyframes / keyframe_indexes نیاز دارد.

aspect_ratio پیش‌فرض 16:9

نسبت تصویر ویدیوی نهایی.

resolution پیش‌فرض 540p

وضوح ویدیوی خروجی.

پیشرفته image · end_image · loop · enable_safety_checker · keyframes · keyframe_indexes
image_url
یک فایل بیندازید، یا

URL تصویر فریم اول که از طریق image_url ارائه می‌شود و یک end_image_url اختیاری را ممکن می‌کند. این حالت لنگرگذاری، فریم‌های کلیدی را حذف می‌کند؛ یکی از دو حالت را انتخاب کنید، نه هر دو.

end_image_url
یک فایل بیندازید، یا

URL اختیاری تصویر فریم آخر که درون‌یابی از image_url به end_image_url را فعال می‌کند؛ جایگزینی برای استفاده از فریم‌های کلیدی.

1–64 URL تصویر را به‌عنوان راهنماهای image-to-video چندفریم‌کلیدی ارائه کنید و آن‌ها را با فهرست هم‌اندازه keyframe_indexes که موقعیت‌ها را مشخص می‌کند جفت کنید. استفاده از فریم‌های کلیدی تولید HDR و 10s را فعال می‌کند، اما image_url، end_image_url و loop را منتفی می‌سازد.

موقعیت‌های لنگر جفت‌شده با فریم‌های کلیدی: مورد [i]، keyframes[i] را در خروجی مکان‌یابی می‌کند و طول هر دو آرایه باید برابر باشد. موقعیت‌ها باید متمایز و نامنفی باشند؛ duration × 24fps برای 5s بازه 0–120 و برای 10s بازه 0–240 می‌دهد.

POST /run/luma/agent/ray/v3.2/image-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/image-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"
  }'

# 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 Image to Video

`image_url` را به‌عنوان فریم اول متحرک می‌کند، در صورت نیاز با `end_image_url`، یا به‌جای آن از `keyframes` همراه با `keyframe_indexes` (1 تا 64) استفاده می‌کند. نسبت‌های ابعاد از 3:4 تا 21:9 هستند، وضوح 540p، 720p یا 1080p است و `duration` برابر 5s یا 10s است؛ مقدار 10s به فریم‌های کلیدی نیاز دارد. `loop`، `hdr` و `exr_export` تحت شرایط اعلام‌شده در دسترس هستند. محدودیت پرامپت 6000 نویسه است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۶٬۰۰۰ نویسه
توضیح متنی صحنه یا حرکتی که باید ایجاد شود.
image_urlاختیاری image
نوعurl · image
URL تصویر فریم اول که از طریق image_url ارائه می‌شود و یک end_image_url اختیاری را ممکن می‌کند. این حالت لنگرگذاری، فریم‌های کلیدی را حذف می‌کند؛ یکی از دو حالت را انتخاب کنید، نه هر دو.
end_image_urlاختیاری end_image
نوعurl · image
URL اختیاری تصویر فریم آخر که درون‌یابی از image_url به end_image_url را فعال می‌کند؛ جایگزینی برای استفاده از فریم‌های کلیدی.
aspect_ratioاختیاری
نوعenum
پیش‌فرض16:9
3:44:31:19:1616:921:9
نسبت تصویر ویدیوی نهایی.
resolutionاختیاری
نوعenum
پیش‌فرض540p
540p720p1080p
وضوح ویدیوی خروجی.
durationاختیاری
نوعenum
پیش‌فرض5s
5s10s
مدت ویدیوی تولیدشده. یک لنگر image_url / end_image_url نمی‌تواند 10s را پشتیبانی کند؛ این مدت به چند فریم کلیدی ارائه‌شده از طریق keyframes / keyframe_indexes نیاز دارد.
loopاختیاری
نوعboolean
پیش‌فرضfalse
تولید حلقه بدون درز، محدود به خروجی با دامنه پویای استاندارد؛ تعیین فریم پایانی یا فریم‌های کلیدی این گزینه را در دسترس خارج می‌کند.
hdrاختیاری
نوعboolean
پیش‌فرضfalse
کدگذاری HDR برای خروجی MP4، در 720p یا 1080p، برای حساب‌های دارای دسترسی HDR در دسترس است. برای استفاده از آن، حلقه‌سازی باید غیرفعال باشد.
exr_exportاختیاری
نوعboolean
پیش‌فرضfalse
خروجی EXR اضافی همراه MP4، فقط با دسترسی HDR و hdr=true در دسترس است.
keyframesاختیاری
نوعstring[]
≤ ۶۴ مورد
1–64 URL تصویر را به‌عنوان راهنماهای image-to-video چندفریم‌کلیدی ارائه کنید و آن‌ها را با فهرست هم‌اندازه keyframe_indexes که موقعیت‌ها را مشخص می‌کند جفت کنید. استفاده از فریم‌های کلیدی تولید HDR و 10s را فعال می‌کند، اما image_url، end_image_url و loop را منتفی می‌سازد.
keyframe_indexesاختیاری
نوعinteger[]
≤ ۶۴ مورد
موقعیت‌های لنگر جفت‌شده با فریم‌های کلیدی: مورد [i]، keyframes[i] را در خروجی مکان‌یابی می‌کند و طول هر دو آرایه باید برابر باشد. موقعیت‌ها باید متمایز و نامنفی باشند؛ duration × 24fps برای 5s بازه 0–120 و برای 10s بازه 0–240 می‌دهد.
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/image-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": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/image-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt