رفتن به محتوا

Mage API · مدل ویدیو

Blueberry API

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

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

در یک نگاه

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

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

نگاه کلی

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

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

یک مدل ویدیویی که حرکت میان فریم اول و آخر را همراه با صدا می‌سازد؛ Blueberry 2 نسخه فعلی آن است.

این مدل first_image و last_image را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی Blueberry API

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id در Blueberry

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

model_idنامپیش‌فرض
blueberryBlueberry
blueberry-v2Blueberryبله

گزینه‌ها

پارامترهای Blueberry

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

فیلدمقادیر
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

ورودی‌ها

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

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

فیلدنقش
first_imageتصویر فریم اول.
last_imageتصویر فریم آخر.

قوانین

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

  • فریم آخر فقط در `blueberry-v2` پشتیبانی می‌شود.

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

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

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

    Cherry API

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

  • ویدیو · از 375 Gems

    Grok Video API

    Grok Imagine در حرکت

  • ویدیو · از 270 Gems

    Kiwi API

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

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

    Lemon API

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

  • ویدیو · از 20 Gems

    LTX Video API

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

  • ویدیو · از 147 Gems

    Melon API

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

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

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

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

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

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