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

Blueberry API

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

احصل على مفتاح APIجرّب Blueberry في بيئة التجربة
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 في الوصف.

نظرة عامة

ما الذي تقدّمه 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

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

واجهات برمجة أخرى لتوليد الفيديو على 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

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

فيديو · من 147 Gems

Melon 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

احصل على مفتاح APIجرّب Blueberry في بيئة التجربة

ذات صلة