رفتن به محتوا

Mage API · مدل ویدیو

Melon API

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

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

در یک نگاه

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

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

نگاه کلی

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

مدل ویدیوی انیمه‌ی ما، در دو نسخه Melon و Melon Pro. فریم شروع و پایان یا حداکثر 7 تصویر مرجع یا Characters، صدای اختیاری، از 3 تا 16 ثانیه با کیفیت تا 1080p.

مدل ویدیوی انیمه‌ی Mage، در دو نسخه Melon و Melon Pro، با صدای اختیاری.

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

شروع سریع

فراخوانی Melon API

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id در Melon

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

model_idنامپیش‌فرض
melonMelonبله
melon-proMelon Pro

گزینه‌ها

پارامترهای Melon

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

فیلدمقادیر
aspect_ratio16:9, 9:16, 1:1, 3:4, 4:3
resolution540p, 720p, 1080p
duration3, 4, 5, 6, 8, 10, 16

ورودی‌ها

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

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

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

قوانین

محدودیت‌های Melon API

  • فریم اول و آخر را نمی‌شود همراه تصاویر مرجع ارسال کرد: فقط یکی از این دو را بفرستید.
  • پرامپت حداکثر 5000 نویسه می‌تواند باشد.

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

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

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

    MiniMax-H3 API

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

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

    Plum API

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

  • ویدیو · از 360 Gems

    Raspberry API

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

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

    Wan Video v2.2 API

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

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

    Berry API

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

  • ویدیو · از 360 Gems

    Blueberry API

    تعیین فریم اول و آخر

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

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

هزینه Melon API چقدر است؟
یک درخواست Melon با تنظیمات پیش‌فرض (Melon) 147 Gems هزینه دارد، یعنی حدود 0.147 دلار. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند و مبلغ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه‌اش برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
آدرس endpoint در Melon API چیست؟
POST https://api.mage.space/v1/melon/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل status_url است تا نتیجه را با آن بررسی کنید.
کدام مدل‌های Melon را می‌توانم فراخوانی کنم؟
melon (Melon)، melon-pro (Melon Pro). مدل پیش‌فرض Melon است.
آیا Melon از تصاویر مرجع یا کاراکترها پشتیبانی می‌کند؟
Melon ورودی‌های first_image، last_image، image و additional_images را می‌پذیرد. Melon کاراکترها و رفرنس‌های ذخیره‌شده را با @handle در پرامپت می‌پذیرد.
آیا می‌توانم Melon را از Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Melon را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتیجه‌های Melon تا چه مدت نگه‌داری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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