رفتن به محتوا

Mage API · مدل ویدیو

LTX Video API

ویدیوی وزن‌باز و سریع برای آزمون‌وخطای پیاپی

POST https://api.mage.space/v1/ltx_video/generate

در یک نگاه

LTX Video API مدل LTX Video و ۱ نسخهٔ دیگر را از طریق Mage روی POST https://api.mage.space/v1/ltx_video/generate اجرا می‌کند. هر درخواست با تنظیمات پیش‌فرض ۲۰ Gem (حدود ۰٫۰۲ دلار) هزینه دارد، بدون اشتراک. LTX Video از اشاره با @handle پشتیبانی نمی‌کند.

  • ویدیوخروجی
  • 2نسخه‌ها
  • 20Gems برای هر کلیپ، پیش‌فرض
  • $0.02حدود، به دلار

نگاه کلی

LTX Video API چه کاری انجام می‌دهد

یک مدل ویدیوی وزن‌باز و سریع برای آزمون‌وخطای ارزان و پیاپی. با متن یا فریم شروع، تا ۷۲۰p، در نسخه‌های Distilled و Dev.

یک مدل ویدیوی وزن‌باز و سریع برای آزمون‌وخطای ارزان، در نسخه‌های Distilled و Dev، از روی متن یا فریم شروع.

first_image را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی LTX Video API

MAGE_API_KEY را تنظیم کنید، درخواست را به /ltx_video/generate بفرستید و تا کامل شدن درخواست، status_url را پیگیری کنید.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/ltx_video/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "3:2",
  "model_id": "ltx-video-096-distilled"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('ltx_video', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '3:2',
  model_id: 'ltx-video-096-distilled',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("ltx_video", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "3:2",
    "model_id": "ltx-video-096-distilled",
})

print(request["result"]["url"])

مدل‌ها

مقادیر model_id در LTX Video

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
ltx-video-096-distilledLTX Videoبله
ltx-video-096-devLTX Video

گزینه‌ها

پارامترهای LTX Video

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution240p, 360p, 480p, 720p

ورودی‌ها

ورودی‌های رسانه‌ای که LTX Video می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
first_imageتصویر فریم اول.

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

سایر APIهای ساخت ویدیو در Mage

  • ویدیو · از 147 Gems

    Melon API

    انیمه در حرکت، با صدای اختیاری

  • ویدیو · از ۳۰ Gem

    MiniMax-H3 API

    ویدیوی متن‌باز سریع با صدای استریو

  • ویدیو · از ۳۳۸ Gem

    Plum API

    صدا برای هر کلیپ، تا 2K

  • ویدیو · از 360 Gems

    Raspberry API

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

  • ویدیو · از ۴۰ Gem

    Wan Video v2.2 API

    ویدیوی وزن‌باز با نسخهٔ Lightning

  • ویدیو · از ۱۸۹ Gem

    Berry API

    ویدیویی که به مرجع‌های شما وفادار می‌ماند

سؤالات متداول

سؤالات متداول

هزینهٔ LTX Video API چقدر است؟
یک درخواست LTX Video با تنظیمات پیش‌فرض (LTX Video) ۲۰ Gem هزینه دارد، یعنی حدود ۰٫۰۲ دلار. رزولوشن، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ مبلغ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت LTX Video API چیست؟
درخواست POST به https://api.mage.space/v1/ltx_video/generate با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک status_url است تا نتیجه را با آن پیگیری کنید.
کدام مدل‌های LTX Video را می‌توانم فراخوانی کنم؟
ltx-video-096-distilled، ltx-video-096-dev. مدل پیش‌فرض LTX Video است.
آیا LTX Video از تصاویر مرجع یا کاراکترها پشتیبانی می‌کند؟
LTX Video پارامتر first_image را می‌پذیرد. LTX Video از اشاره با @handle پشتیبانی نمی‌کند.
آیا می‌توانم LTX Video را از Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و LTX Video را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج LTX Video تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

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