رفتن به محتوا

LTX 2.3 Trainer (V2) - Keyframe Interpolation

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

شناسه مدل ltx23-trainer-v2/interpolate
# 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/ltx23-trainer-v2/interpolate?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "training_data_url": "https://example.com/your-file.zip"
  }'

# 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 آموزش ۱–۶۰ ثانیه

یک LoRA آموزش می‌دهد که حرکت بین فریم‌های کلیدی اول و آخر، و در صورت وجود فریم میانی، بین آن‌ها را تولید می‌کند

Lightricks · فایل

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

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

ساخت درخواست

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

resolution پیش‌فرض medium

وضوح آموزشی. افزایش وضوح نیاز حافظه را بیشتر می‌کند.

aspect_ratio پیش‌فرض 1:1

نسبت تصویر آموزشی.

•الزامی

URL یک `.zip` حاوی داده‌های آموزشی، سازمان‌یافته بر اساس حالت آموزشی انتخاب‌شده. هر فایل رسانه‌ای می‌تواند یک کپشن `.txt` با نام پایه یکسان داشته باشد.

پیش‌فرض 2000

تعداد کل گام‌های آموزشی.

پیشرفته validation_negative_prompt · rank · validation_resolution · validation_aspect_ratio · trigger_phrase · learning_rate · number_of_frames · frame_rate · split_input_duration_threshold · validation_number_of_frames · validation_frame_rate · stg_scale · auto_scale_input · split_input_into_scenes · debug_dataset · include_middle_keyframe · validation
پیش‌فرض blurry, out of focus,...

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

rank پیش‌فرض 32

رتبه سازگارسازی LoRA که با افزایش مقدار، مصرف حافظه بیشتر و ظرفیت بالاتری ایجاد می‌کند.

validation_resolution پیش‌فرض high

وضوح استفاده‌شده هنگام اعتبارسنجی.

validation_aspect_ratio پیش‌فرض 1:1

نسبت تصویر استفاده‌شده هنگام اعتبارسنجی.

پیش‌فرض

عبارت فعال‌سازی سبک LoRA که هنگام آموزش در ابتدای کپشن‌ها درج می‌شود.

پیش‌فرض 0.0002

نرخ یادگیری بهینه‌سازی.

پیش‌فرض 89

تعداد فریم هر نمونه آموزشی. تقسیم این تعداد بر 8 باید باقیمانده 1 داشته باشد؛ نمونه‌ها شامل 1، 9، 17، 25، 33، 41، 49، 57، 65، 73، 81، 89، 97 هستند.

پیش‌فرض 24

نرخ فریم هدف ویدیوی آموزشی برحسب فریم در ثانیه. نرخ بومی LTX-2.3 برابر 24 است.

پیش‌فرض 30

محرک تقسیم صحنه که به‌صورت مدت برحسب ثانیه بیان می‌شود: فقط ویدیوهای طولانی‌تر از آستانه تقسیم می‌شوند.

پیش‌فرض 89

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

پیش‌فرض 24

نرخ فریم هدف برای ویدیوهای اعتبارسنجی، برحسب فریم در ثانیه؛ LTX-2.3 به‌صورت بومی با 24 اجرا می‌شود.

پیش‌فرض 1

مقیاس راهنمایی مکانی-زمانی (STG)؛ مقدار پیشنهادی 1.0 است و 0.0، STG را خاموش می‌کند.

پیش‌فرض []

داده اعتبارسنجی ارائه‌شده به‌صورت فهرست؛ هر مورد تصاویر فریم کلیدی را با یک پرامپت ترکیب می‌کند.

POST /run/ltx23-trainer-v2/interpolate?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/ltx23-trainer-v2/interpolate?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "training_data_url": "https://example.com/your-file.zip"
  }'

# 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 Trainer (V2) - Keyframe Interpolation

یک LoRA برای درون‌یابی فریم‌های کلیدی آموزش می‌دهد: هنگام استنتاج، فریم اول و آخر را ارائه می‌کنید و مدل ویدیوی بین آن‌ها را تولید می‌کند. برای آموزش با فریم‌های اول، میانی و آخر، `include_middle_keyframe` را فعال کنید؛ در این حالت هر نمونهٔ اعتبارسنجی باید `middle_image_url` را ارائه دهد. داده‌ها از طریق `training_data_url` به‌صورت zip ارسال می‌شوند و حداکثر 2 ورودی اعتبارسنجی دارند.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
training_data_urlالزامی
نوعstring
URL یک `.zip` حاوی داده‌های آموزشی، سازمان‌یافته بر اساس حالت آموزشی انتخاب‌شده. هر فایل رسانه‌ای می‌تواند یک کپشن `.txt` با نام پایه یکسان داشته باشد.
rankاختیاری
نوعenum
پیش‌فرض32
8163264128
رتبه سازگارسازی LoRA که با افزایش مقدار، مصرف حافظه بیشتر و ظرفیت بالاتری ایجاد می‌کند.
number_of_stepsاختیاری
نوعinteger
پیش‌فرض2000
۱۰۰ – ۱۰٬۰۰۰
تعداد کل گام‌های آموزشی.
learning_rateاختیاری
نوعnumber
پیش‌فرض0.0002
۰٫۰۰۰۰۰۱ – ۱
نرخ یادگیری بهینه‌سازی.
number_of_framesاختیاری
نوعinteger
پیش‌فرض89
۹ – ۱۲۱
تعداد فریم هر نمونه آموزشی. تقسیم این تعداد بر 8 باید باقیمانده 1 داشته باشد؛ نمونه‌ها شامل 1، 9، 17، 25، 33، 41، 49، 57، 65، 73، 81، 89، 97 هستند.
frame_rateاختیاری
نوعinteger
پیش‌فرض24
۸ – ۶۰
نرخ فریم هدف ویدیوی آموزشی برحسب فریم در ثانیه. نرخ بومی LTX-2.3 برابر 24 است.
resolutionاختیاری
نوعenum
پیش‌فرضmedium
lowmediumhigh
وضوح آموزشی. افزایش وضوح نیاز حافظه را بیشتر می‌کند.
aspect_ratioاختیاری
نوعenum
پیش‌فرض1:1
16:91:19:16
نسبت تصویر آموزشی.
trigger_phraseاختیاری
نوعstring
پیش‌فرض
عبارت فعال‌سازی سبک LoRA که هنگام آموزش در ابتدای کپشن‌ها درج می‌شود.
auto_scale_inputاختیاری
نوعboolean
پیش‌فرضfalse
تنظیم خودکار ویدیو برای تطبیق با FPS و تعداد فریم درخواستی هنگام فعال‌بودن؛ مجموعه‌داده‌های تصویری بدون تغییر می‌مانند.
split_input_into_scenesاختیاری
نوعboolean
پیش‌فرضtrue
تقسیم صحنه برای ویدیوهای طولانی‌تر از آستانه مدت‌زمان که در صورت true فعال می‌شود.
split_input_duration_thresholdاختیاری
نوعnumber
پیش‌فرض30
۱ – ۶۰
محرک تقسیم صحنه که به‌صورت مدت برحسب ثانیه بیان می‌شود: فقط ویدیوهای طولانی‌تر از آستانه تقسیم می‌شوند.
debug_datasetاختیاری
نوعboolean
پیش‌فرضfalse
حالت بررسی پیش‌پردازش برای وارسی ویدیوها، تصاویر و کپشن‌ها پیش از اجرای کامل آموزش. فعال‌کردن آن باعث می‌شود آموزش‌دهنده مجموعه‌داده آموزشی پردازش‌شده را در یک بایگانی قابل‌دانلود برای بررسی دستی برگرداند.
validationاختیاری
نوعobject[]
پیش‌فرض[]
≤ ۲ مورد
داده اعتبارسنجی ارائه‌شده به‌صورت فهرست؛ هر مورد تصاویر فریم کلیدی را با یک پرامپت ترکیب می‌کند.
validation[].promptالزامی
نوعstring
پرامپت استفاده‌شده هنگام اعتبارسنجی.
validation[].start_image_urlالزامی
نوعurl · image
≥ 1 characters
URL تصویر فریم کلیدی برای فریم آغازین.
validation[].end_image_urlالزامی
نوعurl · image
≥ 1 characters
URL تصویر فریم کلیدی برای فریم پایانی.
validation[].middle_image_urlاختیاری
نوعurl · image
URL تصویر فریم کلیدی میانی برای درون‌یابی اول+میانی+آخر. اجراهای دارای `include_middle_keyframe=true` به آن نیاز دارند؛ در غیر این صورت اختیاری است.
validation_negative_promptاختیاری
نوعstring
پیش‌فرضblurry, out of focus, overexposed, underexposed, low contrast, washed out colors, excessive noise, grainy texture, poor lighting, flickering, motion blur, distorted proportions, unnatural skin tones, deformed facial features, asymmetrical face, missing facial features, extra limbs, disfigured hands, wrong hand count, artifacts around text, inconsistent perspective, camera shake, incorrect depth of field, background too sharp, background clutter, distracting reflections, harsh shadows, inconsistent lighting direction, color banding, cartoonish rendering, 3D CGI look, unrealistic materials, uncanny valley effect, incorrect ethnicity, wrong gender, exaggerated expressions, wrong gaze direction, mismatched lip sync, silent or muted audio, distorted voice, robotic voice, echo, background noise, off-sync audio, incorrect dialogue, added dialogue, repetitive speech, jittery movement, awkward pauses, incorrect timing, unnatural transitions, inconsistent framing, tilted camera, flat lighting, inconsistent tone, cinematic oversaturation, stylized filters, or AI artifacts.
پرامپت منفی اعمال‌شده هنگام اعتبارسنجی که از فرایند پیش‌نمایش تک‌مرحله‌ای استفاده می‌کند. چون این فرایند استنتاج تولید تقطیرشده دومرحله‌ای را تقریب می‌زند، راهنمایی و کیفیت پیش‌نمایش آن با نتایج نهایی متفاوت است.
validation_number_of_framesاختیاری
نوعinteger
پیش‌فرض89
۹ – ۱۲۱
تعداد فریم هر ویدیوی اعتبارسنجی.
validation_frame_rateاختیاری
نوعinteger
پیش‌فرض24
۸ – ۶۰
نرخ فریم هدف برای ویدیوهای اعتبارسنجی، برحسب فریم در ثانیه؛ LTX-2.3 به‌صورت بومی با 24 اجرا می‌شود.
validation_resolutionاختیاری
نوعenum
پیش‌فرضhigh
lowmediumhigh
وضوح استفاده‌شده هنگام اعتبارسنجی.
validation_aspect_ratioاختیاری
نوعenum
پیش‌فرض1:1
16:91:19:16
نسبت تصویر استفاده‌شده هنگام اعتبارسنجی.
stg_scaleاختیاری
نوعnumber
پیش‌فرض1
۰ – ۳
مقیاس راهنمایی مکانی-زمانی (STG)؛ مقدار پیشنهادی 1.0 است و 0.0، STG را خاموش می‌کند.
include_middle_keyframeاختیاری
نوعboolean
پیش‌فرضfalse
گنجاندن فریم کلیدی میانی برای تولید ویدیو: true وجود `middle_image_url` را در هر نمونه اعتبارسنجی الزامی می‌کند و فریم میانی را در کنار فریم اول و آخر نگه می‌دارد، نه اینکه فقط از اول و آخر استفاده کند.
الزامی

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx23-trainer-v2/interpolate",
  "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": 4800,
    "usd": "4.80",
    "charged": 4800,
    "refunded": 0
  },
  "input": {
    "training_data_url": "https://example.com/your-file.zip"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "lora_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "config_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "debug_dataset": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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} | nullپیش‌نمایش ترکیبی ویدیو از اعتبارسنجی، در صورت وجود برای نقاط پایانی تولیدکننده ویدیو.
audio
object {url, content_type, file_name, file_size} | nullصوت ترکیبی اعتبارسنجی که در صورت وجود، برای این مسیرهای فقط صوت به‌صورت پیش‌نمایش ارائه می‌شود: /audio-inpaint، /audio-extend-suffix، /audio-extend-prefix، /t2a، /a2a و /v2a.
lora_file
object {url, content_type, file_name, file_size}URL وزن‌های آموزش‌دیده LoRA در قالب .safetensors.
config_file
object {url, content_type, file_name, file_size}پیکربندی راه‌اندازی نقطه پایانی استنتاج.
debug_dataset
object {url, content_type, file_name, file_size} | nullخروجی اشکال‌زدایی در صورت فعال‌بودن `debug_dataset`: بایگانی قابل‌دانلود حاوی داده‌های آموزشی پس از پیش‌پردازش.

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

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