Mage API · توليد الفيديو
واجهة API لتوليد الفيديو بالذكاء الاصطناعي من النصوص أو الصور
تحويل النص إلى فيديو، والصورة إلى فيديو، وفيديو من الإطارين الأول والأخير، وفيديو من المراجع، عبر 15 نموذجًا يتصدرها Cherry 2 Pro النموذج الرئيسي في Mage، مع صوت في كثير من المقاطع.
POST https://api.mage.space/v1/{model}/generateلمحة سريعة
واجهة Mage لتوليد الفيديو هي واجهة REST API على https://api.mage.space/v1 تشغّل 15 نموذجًا لتحويل النص إلى فيديو والصورة إلى فيديو، منها Cherry 2 Pro وLemon وPlum وMelon وMiniMax-H3 وGrok Video وWan. أرسل وصفًا نصيًا مع إطارات أو مراجع اختيارية، ثم تابع حالة الطلب ونزّل ملف MP4. يُدفع ثمن كل مقطع بعملة Gems بحسب النموذج والدقة والمدة.
- 15نماذج فيديو
- $0.02أرخص خيار افتراضي لكل مقطع
- 20عمليات توليد متزامنة
- $0الرسوم الشهرية
النماذج
جميع نماذج الفيديو في Mage API
الأسعار لكل عملية توليد، بـ Gems. يكلّف 1,000 Gems دولارًا واحدًا في الباقة القياسية، وتضيف الباقات الأكبر Gems إضافية. يعتمد السعر على النموذج والدقة والمدة؛ ويظهر السعر بالإعدادات الافتراضية، وتوضح كل استجابة الرسوم الدقيقة في billing.gems_charged. تُسترد تكلفة عملية التوليد الفاشلة، أما التي تحظرها سياسة المحتوى في Mage فلا تُسترد.
| النموذج | الأنسب لـ | قيم model_id | السعر الافتراضي |
|---|---|---|---|
| Berry | فيديو يلتزم بمراجعك بدقة | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | ثبّت الإطارين الأول والأخير | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | عائلة الفيديو الرئيسية لدينا | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine في حركة | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | فيديو للاستخدام اليومي بلا أي إعداد | kiwi | 270 Gems ($0.27) |
| Lemon | كل ميزات الفيديو بسعر أنسب | lemon | 245 Gems ($0.245) |
| LTX Video | فيديو سريع بأوزان مفتوحة للتجارب المتكررة | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | أعِد تمثيل أي فيديو مع الحفاظ على حركته | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | أنمي متحرك مع صوت اختياري | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | فيديو مفتوح سريع بصوت ستيريو | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | صوت في كل مقطع، حتى 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | شخصيات تنبض بالحياة من الإطار الأول | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance، مع فلتر صارم | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0 مع فلتر صارم | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | فيديو بأوزان مفتوحة مع نسخة Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
بداية سريعة
أنشئ فيديو باستخدام Berry 2
عيّن MAGE_API_KEY وأرسل الطلب، ثم تابع حالته حتى يكتمل. استبدل berry في الرابط بأي نموذج من النماذج أعلاه.
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"])كيف يعمل
من مفتاح API إلى وسائط جاهزة في ثلاث طلبات
تشترك جميع النماذج في نظام مصادقة واحد، ودورة طلب غير متزامنة واحدة، وأسماء الحقول نفسها.
أنشئ مفتاح API
سجّل الدخول إلى Mage، وافتح API ← API Keys، وأنشئ مفتاحًا. يبدأ بـ mage_sk_ ويظهر مرة واحدة فقط. يمكن للحساب الواحد الاحتفاظ بـ 10 مفاتيح نشطة.
أرسل طلب توليد
أرسل طلب POST بجسم JSON إلى https://api.mage.space/v1/{model}/generate مع ترويسة Authorization: Bearer. تعود الاستجابة فورًا مع request_id وstatus وstatus_url. أضف ترويسة Idempotency-Key حتى لا تدفع مرتين عند إعادة المحاولة.
تحقّق ثم نزّل
استعلم عن status_url إلى أن تصبح الحالة completed أو failed أو cancelled. يحتوي الطلب المكتمل على result.url الذي يشير إلى ملف الصورة أو الفيديو أو الصوت، ويُحفظ لمدة 30 يومًا.
جاهزة للإنتاج
ما يحصل عليه كل طلب إلى Mage API
مفتاح واحد لكل النماذج
37 نموذجًا للصور والفيديو والصوت عبر واجهة REST API واحدة ورصيد Gems واحد. بدّل النموذج بتغيير مسار الرابط.
ادفع مقابل كل عملية إنشاء
بلا اشتراك وبلا حد أدنى للإنفاق. تشتري Gems ويُحتسب على كل طلب سعره المعلن. وإذا فشلت عملية الإنشاء يُسترد المبلغ، إلا إذا حظرتها سياسة المحتوى في Mage.
إعادة محاولة آمنة
تتيح مفاتيح عدم التكرار (Idempotency keys) إعادة إرسال الطلب لتحصل على الطلب الأصلي نفسه دون خصم جديد.
شخصيات متسقة
احفظ شخصية أو مرجعًا مرة واحدة، ثم اكتب @handle في أي أمر لاستخدامه مع كل نموذج يدعم ذلك.
مدخلات كبيرة
أرسل مدخلات الصور والفيديو والصوت كروابط URL أو data URL، أو ارفع ملفات حتى 100 MB عبر رفع موقّع.
20 عملية إنشاء متزامنة
يمكن لكل حساب تشغيل 20 عملية إنشاء في وقت واحد، ويمكن رفع هذا الحد بما يناسب حالتك. الطلبات المرفوضة لا تُحتسب أبدًا.
حالات الاستخدام
ماذا يبني المطورون بواجهة API للفيديو
الفيديو القصير ومحتوى التواصل الاجتماعي
أنتج مقاطع عمودية لـ TikTok وReels وShorts انطلاقًا من وصف نصي أو صورة منتج.
تحريك الصور الثابتة
حوّل إطارًا أول، أو إطارين أول وأخير، إلى حركة باستخدام نماذج تحويل الصورة إلى فيديو مثل Lemon وKiwi.
قصص تقودها الشخصيات
حافظ على الشخصية نفسها في اللقطات باستخدام نماذج المراجع إلى فيديو التي تقبل شخصيات @handle.
فيديو بالصوت
يولّد Plum ونماذج أخرى الكلام والمؤثرات الصوتية والأجواء مع الصورة، وتقبل مراجع صوتية للأصوات.
الإعلانات والعروض التوضيحية للمنتجات
أنشئ نسخًا متعددة من الإعلان واختر الأفضل، مع إرسال idempotent لا يخصم منك مرتين أبدًا.
تحرير المقاطع الموجودة
يعدّل Berry وPlum وGrok Video فيديو أصليًا ترسله؛ ويقبل Lemon وMiniMax-H3 فيديوهات مرجعية أيضًا.
الأسئلة الشائعة
الأسئلة الشائعة
ما أفضل واجهة API لتوليد الفيديو بالذكاء الاصطناعي؟
هل تدعم واجهة API للفيديو تحويل الصورة إلى فيديو؟
ما أقصى طول للفيديوهات المولَّدة؟
كم يستغرق توليد الفيديو؟
كم تبلغ تكلفة Mage API؟
هل أحتاج إلى عضوية في Mage لاستخدام API؟
هل يمكنني استخدام مخرجات API تجاريًا؟
ما حدود معدّل الطلبات؟
هل يمكن لوكيل الذكاء الاصطناعي الخاص بي استخدام واجهة Mage API؟
هل توجد حزمة SDK لواجهة Mage API؟
أستخدم واجهة توليد أخرى بالفعل. ماذا عليّ أن أغيّر؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.