لمحة سريعة
تشغّل Raspberry API نموذج Raspberry عبر Mage على POST https://api.mage.space/v1/raspberry/generate. يكلّف الطلب بالإعدادات الافتراضية 360 Gems (نحو 0.36$) ودون اشتراك. تستخدم Raspberry الشخصيات والمراجع المحفوظة عبر @handle في الوصف.
فيديو
المخرجات
1
النسخة
360
Gems لكل مقطع، افتراضيًا
$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 | الاسم | افتراضي |
|---|---|---|
| raspberry | Raspberry | نعم |
الخيارات
معاملات Raspberry
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 720p, 1080p |
| duration | 2, 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.