رفتن به محتوا

Ltx 2.3 Quality · Reference Video to Video

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

شناسه مدل ltx-2.3-quality/reference-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.com/v1/run/ltx-2.3-quality/reference-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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

دریافت کلید API
Lightricks ویدیو به ویدیو صوت بومی

تولید بر اساس پرامپت با راهنمایی ویدیوی مرجع و تصاویر اختیاری فریم کلیدی اول، میانی و آخر

Lightricks · ویدیو

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

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

ساخت درخواست

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

•الزامی

پرامپت مورد استفاده برای هدایت تولید.

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

URL اشاره‌کننده به ویدیوی مرجعی که برای هدایت حرکت و ساختار استفاده می‌شود.

resolution پیش‌فرض auto

ابعاد ویدیوی خروجی که بر مدت‌زمان پایدار نیز اثر می‌گذارد: اندازه‌های کوچک‌تر فریم‌های بیشتری را مجاز می‌کنند، در حالی که اندازه‌های بزرگ‌تر بیشینه را کاهش می‌دهند. برآورد داخلی کنترل اندازه را نزدیک به گردش‌کار رسمی کنترل نگه می‌دارد؛ کنترل مستقیم از طریق `skip_control_preprocess` و `control_video_url` در عوض از ابعاد صریح با هم‌ترازی 64px پیروی می‌کند. در حالت کنترل مستقیم، `auto` ابعاد و نسبت تصویر منبع را در محدوده LTX به ارث می‌برد.

پیش‌فرض 121

تعداد فریم خروجی، مشروط به بودجه پایداری IC-LoRA بر اساس حاصل‌ضرب وضوح در فریم‌ها. پاسخ 422 یعنی این بودجه رد شده است: وضوح یا `num_frames` را کاهش دهید. این بودجه تقریباً 150 فریم را در ابعاد رده 720p و تعداد بیشتری را در اندازه‌های کوچک‌تر مجاز می‌کند.

پیشرفته negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
پیش‌فرض color distortion, ove...

پرامپت منفی که مشخص می‌کند تولید باید از چه چیزهایی پرهیز کند.

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

ویدیوی کنترلی ازپیش‌محاسبه‌شده اختیاری که در صورت ارائه همراه با `skip_control_preprocess` به‌جای برآورد داخلی کنترل استفاده می‌شود. پس از نمونه‌برداری مجدد برای تطبیق با ابعاد خروجی و تعداد فریم، به سیگنال کنترل مستقیم تبدیل می‌شود. این ویدیو می‌تواند مثلاً شامل ترکیب عمق، لبه یا ژستِ ازپیش‌رندرشده باشد.

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

سبک لنگرگذاری تصویر یا هویت شخصیت به‌صورت اختیاری، به‌عنوان کی‌فریم فریم اول.

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

ظاهر اختیاری برای لنگرگذاری تصویر نزدیک میانه کلیپ که کی‌فریم اولیه `image_url` را تکمیل می‌کند. این گزینه کمک می‌کند ظاهر حرکت دوربین را دنبال کند و دچار لغزش نشود؛ به `image_url` نیاز دارد.

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

ظاهر اختیاری برای لنگرگذاری تصویر در فریم پایانی کلیپ. زمانی مفید است که حرکت دوربین در مکانی متفاوت از تصویر آغازین پایان یابد؛ به `image_url` نیاز دارد.

video_quality پیش‌فرض high

پیش‌تنظیم کیفیت اعمال‌شده به ویدیوی خروجی.

video_write_mode پیش‌فرض balanced

حالت نوشتن ویدیوی حاصل.

پیش‌فرض 0.6

آزادی تغییر حرکت و ساختار ویدیوی مرجع با این شدت شرطی‌سازی کنترل می‌شود: مقادیر کمتر تغییرات بیشتری را مجاز می‌کنند.

پیش‌فرض 1

کنترل حذف نویز برای نمونه‌برداری ویدیوی مرجع به ویدیو که اثر آن به `preserve_original_video` بستگی دارد. وقتی این حالت خاموش است، فقط برنامه حذف نویز را کوتاه می‌کند؛ وقتی روشن است، تبدیل پیکسل‌های منبع را کنترل می‌کند؛ 1.0 همه‌چیز را بازتولید می‌کند و مقادیر کمتر بخش بیشتری را حفظ می‌کنند (مثلاً 0.5 حدود 50٪ را حفظ می‌کند).

پیش‌فرض 24

نرخ فریم ویدیوی خروجی، اندازه‌گیری‌شده برحسب فریم بر ثانیه.

پیش‌فرض 15

تعداد گام‌های استنتاج را تعیین کنید؛ حداکثر 30 است و باقی گذاشتن مقدار بدون تغییر از 15 استفاده می‌کند.

پیش‌فرض 1

هدایت بدون طبقه‌بند را با این مقیاس تنظیم کنید؛ تنظیم پیش‌فرض آن هم کیفیت بالا و هم تولید سریع را هدف می‌گیرد.

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

POST /run/ltx-2.3-quality/reference-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.com/v1/run/ltx-2.3-quality/reference-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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

درباره Ltx 2.3 Quality · Reference Video to Video

ویدئوی جدیدی را با `prompt` الزامی و `video_url` مرجع ایجاد می‌کند؛ ویدئوی مرجع حرکت و ساختار را فراهم می‌کند. `image_url`، `mid_image_url` و `end_image_url` اختیاری، ظاهر ابتدا، میانه و انتها را مشخص می‌کنند. `video_strength` و `strength` (هر دو 0 تا 1) میزان پیروی یا حفظ منبع را کنترل می‌کنند و `control_video_url` می‌تواند سیگنال کنترلی ازپیش‌محاسبه‌شده ارائه دهد. `resolution` گزینه خودکار یا پیش‌تنظیم‌های ثابتی مانند مربع و حالت عمودی یا افقی 16:9 را ارائه می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
پرامپت مورد استفاده برای هدایت تولید.
video_urlالزامی video
نوعurl · video
URL اشاره‌کننده به ویدیوی مرجعی که برای هدایت حرکت و ساختار استفاده می‌شود.
control_video_urlاختیاری
نوعurl · video
ویدیوی کنترلی ازپیش‌محاسبه‌شده اختیاری که در صورت ارائه همراه با `skip_control_preprocess` به‌جای برآورد داخلی کنترل استفاده می‌شود. پس از نمونه‌برداری مجدد برای تطبیق با ابعاد خروجی و تعداد فریم، به سیگنال کنترل مستقیم تبدیل می‌شود. این ویدیو می‌تواند مثلاً شامل ترکیب عمق، لبه یا ژستِ ازپیش‌رندرشده باشد.
skip_control_preprocessاختیاری
نوعboolean
پیش‌فرضfalse
حالت کنترل مستقیم با استفاده از `control_video_url` به‌جای برآورد داخلی عمق، لبه‌ها یا ژست؛ بدون آن URL، این تنظیم نادیده گرفته می‌شود. اندازه خروجی در این حالت از ابعاد صریح با هم‌ترازی 64 پیروی می‌کند تا ویدیوهای RGB و کنترلی هم‌اندازه بمانند، در حالی که `auto` ابعاد و نسبت تصویر منبع را در محدوده LTX می‌گیرد.
preserve_original_videoاختیاری
نوعboolean
پیش‌فرضfalse
حالت حفظ ویدیوی اصلی که فقط با `skip_control_preprocess`، `video_url` و `control_video_url` در دسترس است. این حالت به‌طور پیش‌فرض غیرفعال است و پردازش استاندارد کنترل را حفظ می‌کند؛ فعال‌کردن آن تولید را از `video_url` آغاز می‌کند و هم‌زمان راهنمایی ساختاری `control_video_url` را نگه می‌دارد. حذف نویز از طریق `strength` میزان حفظ‌شدن را تعیین می‌کند؛ مقادیر کمتر پیکسل‌های اصلی بیشتری را حفظ می‌کنند.
image_urlاختیاری image
نوعurl · image
سبک لنگرگذاری تصویر یا هویت شخصیت به‌صورت اختیاری، به‌عنوان کی‌فریم فریم اول.
mid_image_urlاختیاری
نوعurl · image
ظاهر اختیاری برای لنگرگذاری تصویر نزدیک میانه کلیپ که کی‌فریم اولیه `image_url` را تکمیل می‌کند. این گزینه کمک می‌کند ظاهر حرکت دوربین را دنبال کند و دچار لغزش نشود؛ به `image_url` نیاز دارد.
end_image_urlاختیاری end_image
نوعurl · image
ظاهر اختیاری برای لنگرگذاری تصویر در فریم پایانی کلیپ. زمانی مفید است که حرکت دوربین در مکانی متفاوت از تصویر آغازین پایان یابد؛ به `image_url` نیاز دارد.
video_strengthاختیاری
نوعnumber
پیش‌فرض0.6
۰ – ۱
آزادی تغییر حرکت و ساختار ویدیوی مرجع با این شدت شرطی‌سازی کنترل می‌شود: مقادیر کمتر تغییرات بیشتری را مجاز می‌کنند.
strengthاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
کنترل حذف نویز برای نمونه‌برداری ویدیوی مرجع به ویدیو که اثر آن به `preserve_original_video` بستگی دارد. وقتی این حالت خاموش است، فقط برنامه حذف نویز را کوتاه می‌کند؛ وقتی روشن است، تبدیل پیکسل‌های منبع را کنترل می‌کند؛ 1.0 همه‌چیز را بازتولید می‌کند و مقادیر کمتر بخش بیشتری را حفظ می‌کنند (مثلاً 0.5 حدود 50٪ را حفظ می‌کند).
num_framesاختیاری
نوعinteger
پیش‌فرض121
۹ – ۴۸۱
تعداد فریم خروجی، مشروط به بودجه پایداری IC-LoRA بر اساس حاصل‌ضرب وضوح در فریم‌ها. پاسخ 422 یعنی این بودجه رد شده است: وضوح یا `num_frames` را کاهش دهید. این بودجه تقریباً 150 فریم را در ابعاد رده 720p و تعداد بیشتری را در اندازه‌های کوچک‌تر مجاز می‌کند.
resolutionاختیاری
نوعobject
پیش‌فرضauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد ویدیوی خروجی که بر مدت‌زمان پایدار نیز اثر می‌گذارد: اندازه‌های کوچک‌تر فریم‌های بیشتری را مجاز می‌کنند، در حالی که اندازه‌های بزرگ‌تر بیشینه را کاهش می‌دهند. برآورد داخلی کنترل اندازه را نزدیک به گردش‌کار رسمی کنترل نگه می‌دارد؛ کنترل مستقیم از طریق `skip_control_preprocess` و `control_video_url` در عوض از ابعاد صریح با هم‌ترازی 64px پیروی می‌کند. در حالت کنترل مستقیم، `auto` ابعاد و نسبت تصویر منبع را در محدوده LTX به ارث می‌برد.
frames_per_secondاختیاری
نوعnumber
پیش‌فرض24
۱ – ۶۰
نرخ فریم ویدیوی خروجی، اندازه‌گیری‌شده برحسب فریم بر ثانیه.
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض15
۸ – ۳۰
تعداد گام‌های استنتاج را تعیین کنید؛ حداکثر 30 است و باقی گذاشتن مقدار بدون تغییر از 15 استفاده می‌کند.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض1
۱ – ۲۰
هدایت بدون طبقه‌بند را با این مقیاس تنظیم کنید؛ تنظیم پیش‌فرض آن هم کیفیت بالا و هم تولید سریع را هدف می‌گیرد.
generate_audioاختیاری
نوعboolean
پیش‌فرضtrue
کلید قطعه صوتی برای MP4 بازگشتی: حالت خاموش فایل فقط ویدیو تولید می‌کند و حالت روشن صوت را نیز شامل می‌شود.
negative_promptاختیاری
نوعstring
پیش‌فرضcolor distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards
پرامپت منفی که مشخص می‌کند تولید باید از چه چیزهایی پرهیز کند.
seedاختیاری
نوعinteger | null
Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضtrue
مشخص می‌کند گسترش پرامپت فعال باشد یا نه.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
مشخص می‌کند بررسی ایمنی فعال باشد یا نه.
video_qualityاختیاری
نوعenum
پیش‌فرضhigh
lowmediumhighmaximum
پیش‌تنظیم کیفیت اعمال‌شده به ویدیوی خروجی.
video_write_modeاختیاری
نوعenum
پیش‌فرضbalanced
fastbalancedsmall
حالت نوشتن ویدیوی حاصل.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/reference-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": 270,
    "usd": "0.27",
    "charged": 270,
    "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
    },
    "seed": 42,
    "prompt": "string"
  },
  "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
integerseed واقعی اعمال‌شده هنگام تولید.
prompt
stringپرامپت تولید، شامل هر گسترشی که پیش از استفاده اعمال شده است.

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

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/ltx-2.3-quality/reference-video-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt