رفتن به محتوا

Ltx 2.3 Quality · Render to Real

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

شناسه مدل ltx-2.3-quality/render-to-real
# 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/render-to-real?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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 ویدیو به ویدیو صوت بومیحداکثر 720p #3d#video

تبدیل تصاویر رندر سه‌بعدی، CG یا بازی به ویدئوی فوتورئال با شدت قابل انتخاب

Lightricks · ویدیو

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

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

ساخت درخواست

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

پیش‌فرض 3DREAL.

پرامپت متنی برای نتیجه فوتورئالیستی مطلوب که پس از محرک فعال‌سازی آداپتر ازپیش‌پرشده `3DREAL` نوشته می‌شود. نه پاک‌کردن پرامپت و نه فعال‌کردن گسترش پرامپت این محرک را حذف نمی‌کند؛ این محرک همیشه حفظ می‌شود.

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

URL اشاره‌کننده به ویدیوی سه‌بعدی، CG یا رندرشده با بازی برای تبدیل فوتورئالیستی.

resolution پیش‌فرض 720p

وضوح ضلع کوتاه خروجی را با حفظ نسبت ابعاد منبع انتخاب کنید: 480p برای کلیپ‌های حداکثر تقریباً 15 ثانیه‌ای نتیجه نرم‌تری می‌دهد، درحالی‌که 720p برای حداکثر تقریباً 6 ثانیه نتیجه واضح‌تری دارد. برای کلیپ‌های طولانی‌تر 480p را انتخاب کنید، چون مسیر کنترل IC-LoRA وضوح ضربدر تعداد فریم را محدود می‌کند؛ درخواست‌های فراتر از این بودجه با خطای واضح رد می‌شوند. مدت خروجی را به‌صورت `num_frames` / `frames_per_second` محاسبه کنید.

پیش‌فرض 121

تعداد فریم خروجی، مشمول بودجه IC-LoRA بر اساس وضوح ضربدر فریم‌ها: تقریباً 6 ثانیه در 720p یا 15 ثانیه در 480p. عبور از این بودجه کد 422 برمی‌گرداند؛ `num_frames` را کاهش دهید یا 480p را انتخاب کنید. مدت کلیپ برحسب ثانیه برابر است با `num_frames` / `frames_per_second`.

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

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

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

لنگر تصویری اختیاری برای فریم 0 که ظاهر فوتورئالیستی آن را تعیین می‌کند. بدون آن، فقط رندر نتیجه را هدایت می‌کند؛ در صورت ارائه، تصویر به فریم اول تبدیل می‌شود، مطابق با آموزش تصویر به ویدیوی آداپتور.

intensity پیش‌فرض light

سطح تبدیل فوتورئالیستی؛ `strong-v2` جدیدترین آداپتر بهبودیافته را برای انسجام بهتر میان صحنه‌ها، صوت، شخصیت‌های سخنگو و کیفیت کلی انتخاب می‌کند. برای گزینه‌های دیگر، `light` را برای حفظ بیشتر ظاهر و حرکت رندر منبع یا `strong` را برای تغییرات تهاجمی‌تر به‌سوی فوتورئالیسم انتخاب کنید.

video_quality پیش‌فرض high

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

video_write_mode پیش‌فرض balanced

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

پیش‌فرض 0.75

شدت حذف نویز مرحله جزئیات که پیش‌فرض آن 0.75 است و فقط با فعال‌بودن `enable_detail_refine` اعمال می‌شود. برای ویرایش‌های ملایم‌تر که نتیجه پایه را حفظ می‌کنند، مقدار کمتری به‌کار ببرید؛ افزایش آن جزئیات را گسترده‌تر بازتولید می‌کند، اما خطر واگرایی بیشتر دارد.

پیش‌فرض 24

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

پیش‌فرض 15

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

پیش‌فرض 1

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

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

POST /run/ltx-2.3-quality/render-to-real?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/render-to-real?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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 · Render to Real

رندر سه‌بعدی ارائه‌شده در `video_url` را به ظاهری واقع‌گرایانه‌تر تبدیل می‌کند. `intensity` می‌تواند light، strong یا strong-v2 باشد؛ از ملایم تا شدید. `image_url` اختیاری فریم اول فوتورئال را تعیین می‌کند و `enable_detail_refine` یک مرحلهٔ دوم شارپ‌سازی با `detail_refine_strength` از 0.3 تا 0.95 اضافه می‌کند. پرامپت تریگر `3DREAL` را حفظ می‌کند و خروجی 480p یا 720p است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
video_urlالزامی video
نوعurl · video
URL اشاره‌کننده به ویدیوی سه‌بعدی، CG یا رندرشده با بازی برای تبدیل فوتورئالیستی.
image_urlاختیاری image
نوعurl · image
لنگر تصویری اختیاری برای فریم 0 که ظاهر فوتورئالیستی آن را تعیین می‌کند. بدون آن، فقط رندر نتیجه را هدایت می‌کند؛ در صورت ارائه، تصویر به فریم اول تبدیل می‌شود، مطابق با آموزش تصویر به ویدیوی آداپتور.
intensityاختیاری
نوعenum
پیش‌فرضlight
lightstrongstrong-v2
سطح تبدیل فوتورئالیستی؛ `strong-v2` جدیدترین آداپتر بهبودیافته را برای انسجام بهتر میان صحنه‌ها، صوت، شخصیت‌های سخنگو و کیفیت کلی انتخاب می‌کند. برای گزینه‌های دیگر، `light` را برای حفظ بیشتر ظاهر و حرکت رندر منبع یا `strong` را برای تغییرات تهاجمی‌تر به‌سوی فوتورئالیسم انتخاب کنید.
enable_detail_refineاختیاری
نوعboolean
پیش‌فرضfalse
مرحله پالایش اضافی را برای افزایش وضوح و وضوح‌تصویری فعال می‌کند؛ به‌طور پیش‌فرض غیرفعال است. پس از تولید پایه، بزرگ‌کننده مکانی نهفته ویدیو را 2x بزرگ می‌کند و سپس یک مرحله کوتاه جزئیات را با استفاده از مدل تقطیرشده پالایش می‌کند.
detail_refine_strengthاختیاری
نوعnumber
پیش‌فرض0.75
۰٫۳ – ۰٫۹۵
شدت حذف نویز مرحله جزئیات که پیش‌فرض آن 0.75 است و فقط با فعال‌بودن `enable_detail_refine` اعمال می‌شود. برای ویرایش‌های ملایم‌تر که نتیجه پایه را حفظ می‌کنند، مقدار کمتری به‌کار ببرید؛ افزایش آن جزئیات را گسترده‌تر بازتولید می‌کند، اما خطر واگرایی بیشتر دارد.
promptاختیاری
نوعstring
پیش‌فرض3DREAL.
پرامپت متنی برای نتیجه فوتورئالیستی مطلوب که پس از محرک فعال‌سازی آداپتر ازپیش‌پرشده `3DREAL` نوشته می‌شود. نه پاک‌کردن پرامپت و نه فعال‌کردن گسترش پرامپت این محرک را حذف نمی‌کند؛ این محرک همیشه حفظ می‌شود.
resolutionاختیاری
نوعenum
پیش‌فرض720p
480p720p
وضوح ضلع کوتاه خروجی را با حفظ نسبت ابعاد منبع انتخاب کنید: 480p برای کلیپ‌های حداکثر تقریباً 15 ثانیه‌ای نتیجه نرم‌تری می‌دهد، درحالی‌که 720p برای حداکثر تقریباً 6 ثانیه نتیجه واضح‌تری دارد. برای کلیپ‌های طولانی‌تر 480p را انتخاب کنید، چون مسیر کنترل IC-LoRA وضوح ضربدر تعداد فریم را محدود می‌کند؛ درخواست‌های فراتر از این بودجه با خطای واضح رد می‌شوند. مدت خروجی را به‌صورت `num_frames` / `frames_per_second` محاسبه کنید.
num_framesاختیاری
نوعinteger
پیش‌فرض121
۹ – ۴۸۱
تعداد فریم خروجی، مشمول بودجه IC-LoRA بر اساس وضوح ضربدر فریم‌ها: تقریباً 6 ثانیه در 720p یا 15 ثانیه در 480p. عبور از این بودجه کد 422 برمی‌گرداند؛ `num_frames` را کاهش دهید یا 480p را انتخاب کنید. مدت کلیپ برحسب ثانیه برابر است با `num_frames` / `frames_per_second`.
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
پرامپت منفی که مشخص می‌کند تولید باید از چه چیزهایی پرهیز کند.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضfalse
غنی‌سازی مبتنی بر هوش مصنوعی برای پرامپت تولید که به‌طور پیش‌فرض غیرفعال است تا عبارت شما بدون تغییر عبور کند. خروجی پرامپت واقعاً استفاده‌شده را گزارش می‌کند و همیشه `3DREAL` را حفظ می‌کند؛ فعال‌کردن گسترش به مدل اجازه می‌دهد پیش از تولید، توضیح را بسط دهد.
seedاختیاری
نوعinteger | null
Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.
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/render-to-real",
  "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": {
    "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/render-to-real.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt