انتقل إلى المحتوى

Mage API · نموذج فيديو

Blueberry API

ثبّت الإطار الأول والأخير

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

لمحة سريعة

تشغّل Blueberry API نموذج Blueberry ونسخة أخرى واحدة عبر 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

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
first_imageصورة الإطار الأول.
last_imageصورة الإطار الأخير.

القواعد

ما الذي تفرضه Blueberry API

  • الإطار الأخير مدعوم في `blueberry-v2` فقط.

المزيد من نماذج الفيديو

واجهات برمجة أخرى لتوليد الفيديو على Mage

  • فيديو · من 618 Gems

    واجهة Cherry API

    عائلة الفيديو الرائدة لدينا

  • فيديو · من 375 Gems

    Grok Video API

    Grok Imagine في حالة حركة

  • فيديو · من 270 Gems

    Kiwi API

    فيديو للاستخدام اليومي دون أي إعداد

  • فيديو · من 245 Gems

    واجهة Lemon API

    كل ميزات الفيديو بسعر أنسب

  • فيديو · من 20 Gems

    LTX Video API

    فيديو سريع بأوزان مفتوحة للتجارب المتكررة

  • فيديو · من 1,856 Gem

    Magejutsu API

    أعِد تمثيل أي فيديو مع الحفاظ على حركته

الأسئلة الشائعة

الأسئلة الشائعة

كم تبلغ تكلفة Blueberry API؟
يكلّف طلب Blueberry بالإعدادات الافتراضية (Blueberry) ‏360 Gems، أي نحو $0.36. يتغير السعر حسب الدقة والمدة والإصدار، ويعرض الرد المبلغ المحتسب بدقة. يُردّ المبلغ عند فشل التوليد، أما التوليد الذي تحجبه سياسة المحتوى في Mage فلا يُردّ.
ما نقطة نهاية Blueberry API؟
POST https://api.mage.space/v1/blueberry/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. يتضمن الرد status_url لتتحقق منه دوريًا حتى تحصل على النتيجة.
ما نماذج Blueberry التي يمكنني استدعاؤها؟
blueberry وblueberry-v2. النموذج الافتراضي هو Blueberry.
هل يدعم Blueberry الصور المرجعية أو الشخصيات؟
يقبل Blueberry المدخلات first_image وlast_image. ويأخذ Blueberry المراجع الصوتية المحفوظة عبر @handle في الوصف.
هل يمكنني استخدام Blueberry من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP مع Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Blueberry بالاسم. سيقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
كم مدة الاحتفاظ بنتائج Blueberry؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع