Berry API

لمحة سريعة

تشغّل Berry API نموذج Berry 2 وإصدارًا آخر عبر Mage على POST https://api.mage.space/v1/berry/generate. يكلّف الطلب بالإعدادات الافتراضية 189 Gems (نحو 0.189$) دون اشتراك. يقبل Berry الشخصيات المحفوظة والمراجع عبر @handle في الوصف.

• فيديو

  المخرجات

• 2

  الإصدارات

• 189

  Gems لكل مقطع، افتراضيًا

• $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 حتى يكتمل الطلب.

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"

// 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);

# 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 لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

الخيارات

معاملات Berry

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

المدخلات

مدخلات الوسائط التي يقبلها Berry

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

القواعد

ما الذي تفرضه واجهة Berry API

• لا يمكن دمج الإطار الأول مع الصور المرجعية.
• يعمل تحرير الفيديو على `berry` فقط، وليس `berry-2`: أرسل `model_id: "berry"` مع فيديو مصدر مدته من 3 إلى 60 ثانية.

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

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

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

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

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

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

ذات صلة

• واجهة API لتوليد الفيديو بالذكاء الاصطناعي
• مرجع Berry API
• بيئة تجربة Berry
• جميع نماذج API
• خادم Mage MCP