رفتن به محتوا

Ltx 2.3 Quality · Extend Video · LoRA

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

شناسه مدل ltx-2.3-quality/extend-video/lora
# 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/extend-video/lora?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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

# 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 ویدیو به ویدیو صوت بومی #extend#longer

ادامه‌دادن ویدئو به جلو یا عقب با اعمال حداکثر 3 LoRA سفارشی

Lightricks · ویدیو

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

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

ساخت درخواست

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

•الزامی

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

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

نشانی اینترنتی ویدیویی که قرار است گسترش یابد.

resolution پیش‌فرض auto

ابعاد ویدیوی تولیدشده که با افزایش‌های 32px هم‌تراز شده‌اند—برای مثال، 1920x1080 به 1888x1056 تبدیل می‌شود—و منبع برای خروجی دوخت‌شده به این ابعاد تغییر اندازه می‌یابد. گسترش‌های پایدار در وضوح کمتر طولانی‌تر و در وضوح بیشتر کوتاه‌تر هستند. انتخاب 'auto' ابعاد و نسبت ابعاد منبع را تا حد مجاز LTX حفظ می‌کند.

پیش‌فرض 121

تعداد فریم گسترش، مشمول بودجه تولید پایدار بر اساس وضوح ضربدر فریم‌ها: در 24 fps، تقریباً 20 ثانیه برای رده 480p، 11 ثانیه برای رده 720p یا 5 ثانیه برای رده 1080p. درخواست‌های فراتر از بودجه کد 422 برمی‌گردانند؛ `num_frames` را کاهش دهید یا وضوح کوچک‌تری انتخاب کنید. این تعداد شامل `num_context_frames` هم‌پوشان با منبع است، بنابراین مدت افزوده تقریباً (`num_frames` - `num_context_frames`) / `frames_per_second` ثانیه است.

•الزامی

افزوده‌های LoRA برای LTX-2.3؛ هرکدام حداکثر 3 GB هستند و حداکثر 3 مدخل مجاز است. بارگیری فقط پس از دریافت هر مسیر توسط دریافت‌کننده امن در برابر SSRF رجیستری انجام می‌شود.

پیشرفته negative_prompt · end_image · extend_direction · video_quality · video_write_mode · num_context_frames · end_image_strength · frames_per_second · video_strength · num_inference_steps · guidance_scale · seed · match_input_fps · enable_prompt_expansion · enable_safety_checker
پیش‌فرض color distortion, ove...

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

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

تصویر keyframe اختیاری که هنگام گسترش رو به عقب، فریم اول جدید و هنگام گسترش رو به جلو، فریم پایانی جدید را تعیین می‌کند.

extend_direction پیش‌فرض forward

حالت گسترش ویدیو: 'backward' آغاز جدیدی ایجاد می‌کند، درحالی‌که 'forward' ویدیو را پس از پایان آن ادامه می‌دهد.

video_quality پیش‌فرض high

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

video_write_mode پیش‌فرض balanced

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

پیش‌فرض 25

تعداد فریم منبع درخواستی برای زمینه/هم‌پوشانی گسترش که با تعداد فریم‌های موجود منبع محدود می‌شود. تعداد برای انطباق با شبکه LTX یعنی 8k+1 رو به پایین گرد می‌شود.

پیش‌فرض 1

شدت شرطی‌سازی اختیاری keyframe پایانی: کاهش آن آزادی بیشتری به مدل می‌دهد، درحالی‌که 1.0 تطبیق دقیق را اعمال می‌کند.

پیش‌فرض 24

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

پیش‌فرض 1

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

پیش‌فرض 15

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

پیش‌فرض 1

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

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

POST /run/ltx-2.3-quality/extend-video/lora?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/extend-video/lora?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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

# 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 · Extend Video · LoRA

افزونه ویدئو که فهرست الزامی `loras` شامل حداکثر 3 LoRA سفارشی، هرکدام تا 3 GB، را نیز می‌پذیرد. `prompt` نحوه ادامه کلیپ را توصیف می‌کند و `extend_direction` گزینه `forward` یا `backward` را انتخاب می‌کند. `num_context_frames` (9 تا 121) هم‌پوشانی با منبع را کنترل می‌کند، `num_frames` (9 تا 481) اندازه بخش را مشخص می‌کند و `end_image_url` می‌تواند فریم کلیدی پایانی را تعیین کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
پرامپتی که ادامه مطلوب ویدیو را مشخص می‌کند.
video_urlالزامی video
نوعurl · video
نشانی اینترنتی ویدیویی که قرار است گسترش یابد.
extend_directionاختیاری
نوعenum
پیش‌فرضforward
forwardbackward
حالت گسترش ویدیو: 'backward' آغاز جدیدی ایجاد می‌کند، درحالی‌که 'forward' ویدیو را پس از پایان آن ادامه می‌دهد.
num_framesاختیاری
نوعinteger
پیش‌فرض121
۹ – ۴۸۱
تعداد فریم گسترش، مشمول بودجه تولید پایدار بر اساس وضوح ضربدر فریم‌ها: در 24 fps، تقریباً 20 ثانیه برای رده 480p، 11 ثانیه برای رده 720p یا 5 ثانیه برای رده 1080p. درخواست‌های فراتر از بودجه کد 422 برمی‌گردانند؛ `num_frames` را کاهش دهید یا وضوح کوچک‌تری انتخاب کنید. این تعداد شامل `num_context_frames` هم‌پوشان با منبع است، بنابراین مدت افزوده تقریباً (`num_frames` - `num_context_frames`) / `frames_per_second` ثانیه است.
num_context_framesاختیاری
نوعinteger
پیش‌فرض25
۹ – ۱۲۱
تعداد فریم منبع درخواستی برای زمینه/هم‌پوشانی گسترش که با تعداد فریم‌های موجود منبع محدود می‌شود. تعداد برای انطباق با شبکه LTX یعنی 8k+1 رو به پایین گرد می‌شود.
end_image_urlاختیاری end_image
نوعurl · image
تصویر keyframe اختیاری که هنگام گسترش رو به عقب، فریم اول جدید و هنگام گسترش رو به جلو، فریم پایانی جدید را تعیین می‌کند.
end_image_strengthاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
شدت شرطی‌سازی اختیاری keyframe پایانی: کاهش آن آزادی بیشتری به مدل می‌دهد، درحالی‌که 1.0 تطبیق دقیق را اعمال می‌کند.
resolutionاختیاری
نوعobject
پیش‌فرضauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد ویدیوی تولیدشده که با افزایش‌های 32px هم‌تراز شده‌اند—برای مثال، 1920x1080 به 1888x1056 تبدیل می‌شود—و منبع برای خروجی دوخت‌شده به این ابعاد تغییر اندازه می‌یابد. گسترش‌های پایدار در وضوح کمتر طولانی‌تر و در وضوح بیشتر کوتاه‌تر هستند. انتخاب 'auto' ابعاد و نسبت ابعاد منبع را تا حد مجاز LTX حفظ می‌کند.
match_input_fpsاختیاری
نوعboolean
پیش‌فرضtrue
تطبیق نرخ فریم خروجی با منبع در صورت فعال بودن، که `frames_per_second` را بازنویسی می‌کند. FPS منبع به عدد صحیح گرد و به بازه پشتیبانی‌شده محدود می‌شود.
frames_per_secondاختیاری
نوعnumber
پیش‌فرض24
۱ – ۶۰
نرخ فریم ویدیوی خروجی، اندازه‌گیری‌شده برحسب فریم بر ثانیه.
video_strengthاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
شدت شرطی‌سازی زمینه منبع: کاهش آن آزادی بیشتری به مدل می‌دهد. در 1.0، فریم‌های هم‌پوشان به منبع قفل می‌مانند و گذار یکپارچه می‌شود.
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض15
۸ – ۳۰
تعداد گام‌های استنتاج را تعیین کنید؛ حداکثر 30 است و باقی گذاشتن مقدار بدون تغییر از 15 استفاده می‌کند.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض1
۱ – ۲۰
هدایت بدون طبقه‌بند را با این مقیاس تنظیم کنید؛ تنظیم پیش‌فرض آن هم کیفیت بالا و هم تولید سریع را هدف می‌گیرد.
generate_audioاختیاری
نوعboolean
پیش‌فرضtrue
کلید صوت گسترش: حالت خاموش بخش افزوده را بی‌صدا می‌گذارد و قطعه صوتی ویدیوی منبع را حفظ می‌کند. حالت روشن برای گسترش صوت تولید و آن را در محل اتصال با منبع crossfade می‌کند.
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
حالت نوشتن ویدیوی حاصل.
lorasالزامی
نوعobject[]
≤ ۳ مورد
افزوده‌های LoRA برای LTX-2.3؛ هرکدام حداکثر 3 GB هستند و حداکثر 3 مدخل مجاز است. بارگیری فقط پس از دریافت هر مسیر توسط دریافت‌کننده امن در برابر SSRF رجیستری انجام می‌شود.
loras[].pathالزامی
نوعstring
≤ 2048 characters
نشانی مستقیم HTTP(S) برای فایل LoRA با پسوند .safetensors و حداکثر اندازه 3 GB. بارگیری پس از دریافت با دریافت‌کننده امن در برابر SSRF انجام می‌شود.
loras[].scaleاختیاری
نوعnumber
پیش‌فرض1
۰ – ۲
با افزایش این شدت در بازه 0.0–2.0، تأثیر LoRA بر ویدیوی تولیدشده بیشتر می‌شود.
loras[].transformerاختیاری
نوعenum
پیش‌فرضboth
highlowboth
پرچم انتخاب Transformer: 'both' برای تقریباً همه کاربران LTX-2.3 مناسب است، چون مدل فقط یک Transformer دارد. این پرچم برای پشتیبانی از معماری‌های آینده با چند Transformer وجود دارد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/extend-video/lora",
  "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": 304,
    "usd": "0.304",
    "charged": 304,
    "refunded": 0
  },
  "input": {
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ],
    "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/extend-video/lora.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt