رفتن به محتوا

Mage API · مدل ویدیو

API مدل Berry

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

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

در یک نگاه

API مدل Berry، مدل Berry 2 و ۱ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/berry/generate اجرا می‌کند. هزینه یک درخواست با تنظیمات پیش‌فرض ۱۸۹ Gems (حدود $0.189) است، بدون اشتراک. Berry کاراکترها و مرجع‌های ذخیره‌شده را با @handle در پرامپت می‌پذیرد.

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

نگاه کلی

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

ویدیویی که به تک‌تک تصاویر مرجع شما وفادار می‌ماند. یک فریم شروع، تا 9 تصویر مرجع یا Characters، یا یک ویدیوی منبع برای ویرایش؛ از 3 تا 15 ثانیه، با کیفیت تا 1080p.

مدل ویدیوی مرجع‌محور Mage که به تصاویر شما وفادار می‌ماند؛ Berry 2 نسخه فعلی است. یک فریم اول یا چند تصویر مرجع، یا یک ویدیوی منبع برای ویرایش.

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

شروع سریع

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

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id در Berry

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

model_idنامپیش‌فرض
berryBerry
berry-2Berry 2بله

گزینه‌ها

پارامترهای Berry

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

فیلدمقادیر
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4
resolution720p, 1080p, 480p
duration3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

ورودی‌ها

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

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

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

قوانین

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

  • فریم اول را نمی‌توان همراه با تصاویر مرجع استفاده کرد.
  • ویرایش ویدیو فقط روی `berry` کار می‌کند، نه `berry-2`: مقدار `model_id: "berry"` را همراه با یک ویدیوی مبدأ بین 3 تا 60 ثانیه ارسال کنید.

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

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

  • ویدیو · از 360 Gems

    Blueberry API

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

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

    Cherry API

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

  • ویدیو · از 375 Gems

    Grok Video API

    Grok Imagine در حرکت

  • ویدیو · از 270 Gems

    Kiwi API

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

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

    Lemon API

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

  • ویدیو · از 20 Gems

    LTX Video API

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

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

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

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

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

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