رفتن به محتوا

Mage API · مدل ویدیو

Plum API

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

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

در یک نگاه

API مدل Plum، یعنی Plum Max و یک نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/plum/generate اجرا می‌کند. هر درخواست با تنظیمات پیش‌فرض 338 Gem (حدود 0.338 دلار) هزینه دارد و نیازی به اشتراک نیست. Plum می‌تواند کاراکترهای ذخیره‌شده، رفرنس‌ها و رفرنس‌های صوتی را با @handle در پرامپت بگیرد.

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

نگاه کلی

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

ویدیوی کامل‌ترین نسخه با صدا در هر کلیپ و خروجی تا 2K. فریم شروع و پایان، تا 9 رفرنس یا Characters، و Voices؛ از 4 تا 15 ثانیه.

مدل ویدیوی کامل Mage با صدای تولیدشده در هر کلیپ و خروجی تا 2K، در دو نسخه Plum و Plum Max که سریع‌تر است.

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

شروع سریع

فراخوانی API مدل Plum

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

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

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

model_idنامپیش‌فرض
plumPlum
plum-maxPlum Maxبله

گزینه‌ها

پارامترهای Plum

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

فیلدمقادیر
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9
resolution768P, 2K, 480P
duration4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

ورودی‌ها

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

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

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

قوانین

قوانینی که API مدل Plum اعمال می‌کند

  • فریم اول و آخر را نمی‌شود همراه تصاویر مرجع ارسال کرد: فقط یکی از این دو را بفرستید.
  • در `plum-max` فریم آخر باید همراه با فریم اول باشد.
  • ویرایش ویدیو دقیقاً یک ویدیوی مبدأ بین 2 تا 15 ثانیه، یک `duration` برای خروجی و حداکثر 2 تصویر رفرنس می‌خواهد که کاراکترها و رفرنس‌های ذکرشده هم جزو آن‌ها حساب می‌شوند. فریم، رفرنس صوتی یا صدای کاراکتر نمی‌پذیرد: برای اشاره به کاراکتری که صدا دارد، `use_character_voices: false` را بفرستید.
  • در `plum-max` ویدیوی مبدأ به ازای هر ثانیه با نرخ بالاتری از خروجی محاسبه می‌شود؛ بنابراین در 768P یک ویرایش در `plum-max` گران‌تر از `plum` تمام می‌شود.

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

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

  • ویدیو · از 360 Gems

    Raspberry API

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

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

    Wan Video v2.2 API

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

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

    Berry API

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

  • ویدیو · از 360 Gems

    Blueberry API

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

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

    Cherry API

    خانواده‌ی پرچم‌دار ما برای ویدیو

  • ویدیو · از 375 Gems

    Grok Video API

    Grok Imagine در حرکت

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

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

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

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

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