رفتن به محتوا

Mage API · مدل ویدیو

Raspberry API

جان‌دادن به کاراکترها از یک فریم اول

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

در یک نگاه

API مدل Raspberry مدل Raspberry را از طریق Mage در POST https://api.mage.space/v1/raspberry/generate اجرا می‌کند. هر درخواست با تنظیمات پیش‌فرض 360 Gem (حدود 0.36 دلار) هزینه دارد و نیازی به اشتراک نیست. Raspberry می‌تواند کاراکترهای ذخیره‌شده و رفرنس‌ها را با @handle در پرامپت بگیرد.

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

نگاه کلی

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

ویدیوی کاراکتر از یک فریم شروع به‌علاوه حداکثر 5 رفرنس یا Characters، همراه با Voices و صدا. از 2 تا 15 ثانیه در 720p یا 1080p.

مدل ویدیوی کاراکتر که از یک فریم اول و تصاویر رفرنس شروع می‌کند، همراه با Voices و صدا.

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

شروع سریع

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

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

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

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

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

گزینه‌ها

پارامترهای Raspberry

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

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

ورودی‌ها

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

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

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

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

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

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

    Wan Video v2.2 API

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

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

    Berry API

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

  • ویدیو · از 360 Gems

    Blueberry API

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

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

    Cherry API

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

  • ویدیو · از 375 Gems

    Grok Video API

    Grok Imagine در حرکت

  • ویدیو · از 270 Gems

    Kiwi API

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

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

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

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

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

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