رفتن به محتوا

Mage API · مدل ویدیو

Cherry API

خانواده مدل‌های ویدیوی شاخص ما

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

در یک نگاه

Cherry API مدل Cherry 2 Pro و ۳ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/cherry/generate اجرا می‌کند. هزینه یک درخواست با تنظیمات پیش‌فرض ۶۱۸ Gem (حدود ۰٫۶۱۸ دلار) است، بدون اشتراک. Cherry کاراکترها و مرجع‌ها و مرجع‌های صوتی ذخیره‌شده را با @handle در پرامپت می‌گیرد.

  • ویدیوخروجی
  • 4نسخه‌ها
  • 618Gems برای هر کلیپ، پیش‌فرض
  • $0.618حدود، به دلار

نگاه کلی

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

ویدیوی سینمایی همراه با صدا؛ از Cherry Mini برای پیش‌نویس تا Cherry 2 Pro، قدرتمندترین مدل ما، با کلیپ‌هایی تا ۳۰ ثانیه، مرجع‌ها یا Characters متعدد و ویرایش ویدیوی مبدأ.

مجموعه ویدیوی شاخص Mage با حرکت سینمایی و صدا: Cherry Mini، Cherry، Cherry Pro و Cherry 2 Pro که قدرتمندترین است و کلیپ‌هایی تا ۳۰ ثانیه می‌سازد.

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

شروع سریع

فراخوانی Cherry API

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id در Cherry

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

model_idنامپیش‌فرض
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2-proCherry 2 Proبله

گزینه‌ها

پارامترهای Cherry

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

فیلدمقادیر
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

ورودی‌ها

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

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

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

قوانین

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

  • ویرایش ویدیو دقیقاً یک ویدیوی مبدأ می‌گیرد، به طول ۴ تا ۳۰ ثانیه در `cherry-2-pro` و ۲ تا ۱۵ ثانیه در بقیه مدل‌ها.
  • در `cherry-2-pro` ویرایش، طول و نسبت تصویر ویدیوی مبدأ را حفظ می‌کند: `duration` و `aspect_ratio` نادیده گرفته می‌شوند و قیمت بر اساس طول ویدیو محاسبه می‌شود.

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

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

  • ویدیو · از 375 Gems

    Grok Video API

    Grok Imagine در حرکت

  • ویدیو · از 270 Gems

    Kiwi API

    ویدیوی روزمره، بدون هیچ راه‌اندازی

  • ویدیو · از ۲۴۵ Gem

    Lemon API

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

  • ویدیو · از 20 Gems

    LTX Video API

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

  • ویدیو · از 147 Gems

    Melon API

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

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

    MiniMax-H3 API

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

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

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

هزینه Cherry API چقدر است؟
یک درخواست Cherry با تنظیمات پیش‌فرض (Cherry 2 Pro) ۶۱۸ Gem هزینه دارد، یعنی حدود ۰٫۶۱۸ دلار. رزولوشن، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ مبلغ دقیق در پاسخ اعلام می‌شود. اگر ساخت ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
آدرس endpoint در Cherry API چیست؟
POST https://api.mage.space/v1/cherry/generate با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک status_url است که برای دریافت نتیجه باید پیوسته بررسی شود.
کدام مدل‌های Cherry را می‌توانم فراخوانی کنم؟
cherry-mini (Cherry Mini)، cherry (Cherry)، cherry-pro (Cherry Pro)، cherry-2-pro (Cherry 2 Pro). مدل پیش‌فرض Cherry 2 Pro است.
آیا Cherry از تصاویر مرجع یا کاراکترها پشتیبانی می‌کند؟
Cherry ورودی‌های image، additional_images و videos را می‌پذیرد. Cherry کاراکترها و مرجع‌ها و مرجع‌های صوتی ذخیره‌شده را با @handle در پرامپت می‌گیرد.
آیا می‌توانم Cherry را از داخل Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مج (Mage) را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Cherry را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از ساخت، قیمت را اعلام می‌کند.
نتیجه‌های Cherry تا چه مدت نگه داشته می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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