رفتن به محتوا

Ltx 2.3 Quality · Outpaint

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

شناسه مدل ltx-2.3-quality/outpaint
# 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/outpaint?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 ویدیو به ویدیو صوت بومی #outpaint#outpainting

گسترش قاب ویدئو به نسبت تصویر جدید و پرکردن ناحیه افزوده‌شده

Lightricks · ویدیو

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

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

ساخت درخواست

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

•الزامی

متن هدایت‌کننده تولید نواحی خارج‌نگاری‌شده ویدیو.

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

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

aspect_ratio پیش‌فرض 16:9

نسبت ابعاد خارج‌نگاری؛ برای مثال، ورودی 4:3 را می‌توان به 16:9 گسترش داد. برای گسترش تمیز فریم، نسبتی متفاوت از منبع انتخاب کنید.

output_resolution پیش‌فرض 720p

رده وضوح خروجی با پیش‌فرض گزینه متعادل 720p. برای تولید سریع‌تر 480p یا برای بوم بزرگ‌تر 1080p را انتخاب کنید، مشروط بر اینکه در محدودیت‌های LTX جا بگیرد.

resolution پیش‌فرض landscape_16_9

ابعاد دقیق بوم با استفاده از تنظیم قدیمی که برای سازگاری رو به عقب حفظ شده است. درخواست‌های جدید باید به‌جای آن از `aspect_ratio` همراه با `output_resolution` استفاده کنند.

پیش‌فرض 121

تعداد فریم خروجی تولیدشده.

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

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

video_quality پیش‌فرض high

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

video_write_mode پیش‌فرض balanced

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

پیش‌فرض 1

مقیاس ویدیوی منبع در بوم هدف پیش از گسترش بیرونی؛ کاهش آن حاشیه‌ای با اثر کوچک‌نمایی ایجاد می‌کند و پایداری نتایج را کاهش می‌دهد. برای گسترش واقعی نسبت تصویر، مانند 4:3 به 16:9، تنظیم پیشنهادی 1.0 منبع را با بزرگ‌ترین اندازه ممکن در بوم جای می‌دهد.

پیش‌فرض 1

میزان حفظ ویدیوی اصلی در بوم گسترش‌یافته از طریق راهنمایی ویدیویی IC-LoRA؛ افزایش این مقدار منبع را دقیق‌تر حفظ می‌کند.

پیش‌فرض 24

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

پیش‌فرض 15

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

پیش‌فرض 1

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

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

POST /run/ltx-2.3-quality/outpaint?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/outpaint?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 · Outpaint

ویدئوی منبع را از نظر فضایی به بوم جدید گسترش می‌دهد. `aspect_ratio` هدف (21:9، 16:9، 4:3، 1:1، 3:4، 9:16 یا 9:21) و `output_resolution` برابر 480p، 720p یا 1080p را انتخاب کنید. `source_scale` (0.25 تا 1) اندازه تصویر اصلی در بوم را تعیین می‌کند و `video_strength` میزان حفظ آن را کنترل می‌کند. `prompt` نواحی جدید را هدایت می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
متن هدایت‌کننده تولید نواحی خارج‌نگاری‌شده ویدیو.
video_urlالزامی video
نوعurl · video
ویدیوی منبعی که مرزهای فضایی آن با خارج‌نگاری گسترش می‌یابند.
aspect_ratioاختیاری
نوعenum
پیش‌فرض16:9
21:916:94:31:13:49:169:21
نسبت ابعاد خارج‌نگاری؛ برای مثال، ورودی 4:3 را می‌توان به 16:9 گسترش داد. برای گسترش تمیز فریم، نسبتی متفاوت از منبع انتخاب کنید.
output_resolutionاختیاری
نوعenum
پیش‌فرض720p
480p720p1080p
رده وضوح خروجی با پیش‌فرض گزینه متعادل 720p. برای تولید سریع‌تر 480p یا برای بوم بزرگ‌تر 1080p را انتخاب کنید، مشروط بر اینکه در محدودیت‌های LTX جا بگیرد.
resolutionاختیاری
نوعobject
پیش‌فرضlandscape_16_9
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد دقیق بوم با استفاده از تنظیم قدیمی که برای سازگاری رو به عقب حفظ شده است. درخواست‌های جدید باید به‌جای آن از `aspect_ratio` همراه با `output_resolution` استفاده کنند.
source_scaleاختیاری
نوعnumber
پیش‌فرض1
۰٫۲۵ – ۱
مقیاس ویدیوی منبع در بوم هدف پیش از گسترش بیرونی؛ کاهش آن حاشیه‌ای با اثر کوچک‌نمایی ایجاد می‌کند و پایداری نتایج را کاهش می‌دهد. برای گسترش واقعی نسبت تصویر، مانند 4:3 به 16:9، تنظیم پیشنهادی 1.0 منبع را با بزرگ‌ترین اندازه ممکن در بوم جای می‌دهد.
video_strengthاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
میزان حفظ ویدیوی اصلی در بوم گسترش‌یافته از طریق راهنمایی ویدیویی IC-LoRA؛ افزایش این مقدار منبع را دقیق‌تر حفظ می‌کند.
num_framesاختیاری
نوعinteger
پیش‌فرض121
۹ – ۴۸۱
تعداد فریم خروجی تولیدشده.
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/outpaint",
  "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/outpaint.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt