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

Raspberry API

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

احصل على مفتاح APIجرّب Raspberry في ساحة التجربة
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 في الوصف.

نظرة عامة

ما الذي تتيحه 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

فيديو · من 40 Gems

Wan Video v2.2 API

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

فيديو · من 189 Gems

Berry API

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

فيديو · من 360 Gems

Blueberry API

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

فيديو · من 618 Gems

واجهة Cherry API

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

فيديو · من 375 Gems

Grok Video API

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

فيديو · من 270 Gems

Kiwi 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

احصل على مفتاح APIجرّب Raspberry في ساحة التجربة

ذات صلة