رفتن به محتوا

Mage API · مدل ویدیو

Lemon API

همه امکانات ویدیو با قیمتی مناسب‌تر

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

در یک نگاه

Lemon API مدل Lemon را از طریق مایج روی POST https://api.mage.space/v1/lemon/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 245 Gems (حدود $0.245) هزینه دارد، بدون اشتراک. Lemon در پرامپت، کاراکترها، مرجع‌ها و مرجع‌های صوتی ذخیره‌شده را با @handle می‌پذیرد.

  • ویدیوخروجی
  • 1نسخه
  • 245Gems برای هر کلیپ، پیش‌فرض
  • $0.245حدود، به دلار

نگاه کلی

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

مدل ویدیوی همه‌کاره ما. فریم شروع و پایان، تا 10 مرجع یا Characters، Voices و صدا، و کلیپ‌هایی از 2 تا 30 ثانیه با کیفیت تا 1080p.

مدل ویدیوی همه‌کاره Mage با قیمتی مناسب‌تر: فریم‌ها، مرجع‌ها، Voices، صدای تولیدشده و کلیپ‌هایی از 2 تا 30 ثانیه.

ورودی‌های first_image، last_image، image، additional_images و videos را می‌پذیرد.

شروع سریع

فراخوانی Lemon API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/lemon/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": "16:9",
  "duration": "3",
  "model_id": "lemon"
}' | 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('lemon', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'lemon',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("lemon", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "lemon",
})

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

مدل‌ها

مقادیر model_id برای Lemon

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

model_idنامپیش‌فرض
lemonLemonبله

گزینه‌ها

پارامترهای Lemon

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

فیلدمقادیر
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

ورودی‌ها

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

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

فیلدنقش
first_imageتصویر فریم اول.
last_imageتصویر فریم آخر.
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.
videosویدیوهای مبدأ.

قوانین

محدودیت‌هایی که API مدل Lemon اعمال می‌کند

  • فریم اول و آخر را نمی‌توان همراه با تصاویر یا ویدیوهای مرجع ارسال کرد: فقط یکی از این دو نوع را بفرستید.
  • حداکثر ۱۰ تصویر مرجع و ۵ ویدیوی مرجع.
  • هر ویدیوی مرجع باید بین ۱ تا ۱۵ ثانیه باشد، مجموع طول همهٔ آن‌ها حداکثر ۱۵ ثانیه است و مجموع این طول به‌علاوهٔ `duration` نباید از ۳۰ ثانیه بیشتر شود. ثانیه‌های ویدیوی مرجع مثل ثانیه‌های خروجی محاسبه می‌شوند.

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

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

  • ویدیو · از 20 Gems

    LTX Video API

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

  • ویدیو · از 147 Gems

    Melon API

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

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

    MiniMax-H3 API

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

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

    Plum API

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

  • ویدیو · از 360 Gems

    Raspberry API

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

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

    Wan Video v2.2 API

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

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

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

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

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

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