Mage API · نموذج فيديو
Berry API
فيديو يبقى وفيًا لصورك المرجعية
POST https://api.mage.space/v1/berry/generateلمحة سريعة
تشغّل Berry API نموذج Berry 2 وإصدارًا آخر عبر Mage على POST https://api.mage.space/v1/berry/generate. يكلّف الطلب بالإعدادات الافتراضية 189 Gems (نحو 0.189$) دون اشتراك. يقبل Berry الشخصيات المحفوظة والمراجع عبر @handle في الوصف.
- فيديوالمخرجات
- 2الإصدارات
- 189Gems لكل مقطع، افتراضيًا
- $0.189التكلفة التقريبية بالدولار
نظرة عامة
ماذا تفعل Berry API
فيديو يبقى وفيًا لكل مرجع تقدّمه. إطار بداية، وحتى 9 مراجع أو Characters، أو فيديو مصدر لتحريره؛ من 3 إلى 15 ثانية بدقة تصل إلى 1080p.
نموذج الفيديو المعتمد على المراجع من Mage، وفيّ للصور التي تقدّمها؛ Berry 2 هو الإصدار الحالي. إطار أول أو صور مرجعية، أو فيديو مصدر لتحريره.
يقبل المدخلات first_image وimage وadditional_images وvideo.
بداية سريعة
استدعاء Berry API
عيّن MAGE_API_KEY، وأرسل الطلب إلى /berry/generate، ثم استطلع status_url حتى يكتمل الطلب.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])النماذج
قيم model_id في Berry
أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.
| model_id | الاسم | افتراضي |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | نعم |
الخيارات
معاملات Berry
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
المدخلات
مدخلات الوسائط التي يقبلها Berry
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| first_image | صورة الإطار الأول. |
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
| video | الفيديو المصدر. |
القواعد
ما الذي تفرضه واجهة Berry API
- لا يمكن دمج الإطار الأول مع الصور المرجعية.
- يعمل تحرير الفيديو على `berry` فقط، وليس `berry-2`: أرسل `model_id: "berry"` مع فيديو مصدر مدته من 3 إلى 60 ثانية.
المزيد من نماذج الفيديو
واجهات برمجة أخرى لتوليد الفيديو على Mage
Blueberry API
ثبّت الإطار الأول والأخير
واجهة Cherry API
عائلة الفيديو الرائدة لدينا
Grok Video API
Grok Imagine في حالة حركة
Kiwi API
فيديو للاستخدام اليومي دون أي إعداد
واجهة Lemon API
كل ميزات الفيديو بسعر أنسب
LTX Video API
فيديو سريع بأوزان مفتوحة للتجارب المتكررة
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Berry API؟
ما نقطة نهاية Berry API؟
ما نماذج Berry التي يمكنني استدعاؤها؟
هل يدعم Berry الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Berry من Claude أو ChatGPT؟
ما مدة الاحتفاظ بنتائج Berry؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.