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

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الاسمافتراضي
berryBerry
berry-2Berry 2نعم

الخيارات

معاملات Berry

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4
resolution720p, 1080p, 480p
duration3, 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

  • فيديو · من 360 Gems

    Blueberry API

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

  • فيديو · من 618 Gems

    واجهة Cherry API

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

  • فيديو · من 375 Gems

    Grok Video API

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

  • فيديو · من 270 Gems

    Kiwi API

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

  • فيديو · من 245 Gems

    واجهة Lemon API

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

  • فيديو · من 20 Gems

    LTX Video API

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

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

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

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

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

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

Charactersالمجتمع