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

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

Raspberry API

شخصيات تنبض بالحياة انطلاقًا من الإطار الأول

POST https://api.mage.space/v1/raspberry/generate

لمحة سريعة

تشغّل Raspberry API نموذج Raspberry عبر Mage على POST https://api.mage.space/v1/raspberry/generate. يكلّف الطلب بالإعدادات الافتراضية 360 Gems (نحو 0.36$) ودون اشتراك. تستخدم Raspberry الشخصيات والمراجع المحفوظة عبر @handle في الوصف.

  • فيديوالمخرجات
  • 1النسخة
  • 360Gems لكل مقطع، افتراضيًا
  • $0.36التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تتيحه Raspberry API

فيديو للشخصيات انطلاقًا من إطار البداية مع ما يصل إلى 5 مراجع أو Characters، مع Voices وصوت. بمدة من 2 إلى 15 ثانية بدقة 720p أو 1080p.

نموذج فيديو للشخصيات ينطلق من الإطار الأول وصور مرجعية، مع Voices وصوت.

يقبل المدخلات first_image وimage وadditional_images.

بداية سريعة

استدعاء Raspberry API

عيّن MAGE_API_KEY، ثم أرسل الطلب إلى /raspberry/generate، واستعلم عن status_url بشكل متكرر حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/raspberry/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": "raspberry"
}' | 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('raspberry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'raspberry',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("raspberry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "raspberry",
})

print(request["result"]["url"])

النماذج

قيم model_id في Raspberry

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
raspberryRaspberryنعم

الخيارات

معاملات Raspberry

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

الحقلالقيم
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

المدخلات

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

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

الحقلالدور
first_imageصورة الإطار الأول.
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.

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

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

  • فيديو · من 618 Gems

    واجهة Seedance API

    Seedance مع فلتر صارم

  • فيديو · من 245 Gems

    واجهة Wan 3.0 API

    Wan 3.0 مع فلتر صارم

  • فيديو · من 40 Gems

    Wan Video v2.2 API

    فيديو مفتوح الأوزان مع نسخة Lightning

  • فيديو · من 189 Gems

    Berry API

    فيديو يبقى وفيًا لمراجعك

  • فيديو · من 360 Gems

    Blueberry API

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

  • فيديو · من 618 Gems

    واجهة Cherry API

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

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

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

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

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

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

Charactersالمجتمع