لمحة سريعة
تشغّل Blueberry API نموذج Blueberry ونسخة أخرى واحدة عبر Mage على POST https://api.mage.space/v1/blueberry/generate. يكلّف الطلب بالإعدادات الافتراضية 360 Gems (نحو $0.36) دون اشتراك. يستخدم Blueberry المراجع الصوتية المحفوظة عبر @handle في الوصف.
فيديو
المخرجات
2
الإصدارات
360
Gems لكل مقطع، افتراضيًا
$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 | الاسم | افتراضي |
|---|---|---|
| blueberry | Blueberry | |
| blueberry-v2 | Blueberry | نعم |
الخيارات
معاملات Blueberry
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 720p, 1080p |
| duration | 2, 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
فيديو سريع بأوزان مفتوحة للتجارب المتكررة
فيديو · من 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.