Mage API · مصمَّم لفكرتك القادمة
واجهة API واحدة. إمكانات بلا حدود.
اجلب أفضل ما في Mage إلى منتجك ومساعدك الذكي. ولّد الصور والفيديو والصوت بمفتاح API واحد أو باتصال MCP واحد.
https://api.mage.space/v1لمحة سريعة
يوفّر Mage للمطوّرين واجهة REST API على https://api.mage.space/v1 وخادم MCP عن بُعد على https://mcp.mage.space/mcp. يشغّل كلاهما نماذج الصور والفيديو والصوت نفسها وعددها 37، ومنها Mango 4 وCherry 2 Pro الحصريان على Mage، ضمن حساب واحد، وتُدفع كل عملية توليد بعملة Gems دون اشتراك.
- 37النماذج
- 3أنواع الوسائط
- 16أدوات MCP
- $0الرسوم الشهرية
طرق الاستخدام
استخدمه من الكود أو من مساعدك أو من ComfyUI
واجهة Mage API
أرسل طلبات التوليد من كودك الخاص باستخدام مفتاح. طلبات غير متزامنة، وإعادة محاولة آمنة (idempotent)، ورفع ملفات حتى 100 ميغابايت، و20 عملية توليد في وقت واحد.
حزم SDK لـ TypeScript وPython
عملاء رسميون بأنواع محدّدة يرسلون الطلب وينتظرون النتيجة ويعيدون المحاولة بأمان ويرفعون الملفات في أسطر قليلة.
مزوّد Mage MCP
اربط Claude أو ChatGPT أو Claude Code أو Grok أو Cursor بتسجيل دخول، واطلب الصور والفيديو والصوت بكلمات بسيطة.
Mage لـ ComfyUI
Mango وCherry وSeed Audio وكل نماذج Mage الأخرى كعُقد في ComfyUI. بلا GPU وبلا تنزيل نماذج.
حسب نوع الوسائط
واجهات API للتوليد
واجهة API لتوليد الصور بالذكاء الاصطناعي
تحويل النص إلى صورة، والتعديل، وشخصيات متسقة بدقة تصل إلى 4K.
واجهة API لتوليد الفيديو بالذكاء الاصطناعي
تحويل النص إلى فيديو، والصورة إلى فيديو، والإطارات، والمراجع، والصوت.
واجهة API لتوليد الصوت بالذكاء الاصطناعي
أصوات وتعليق صوتي وموسيقى ومؤثرات صوتية من وصف نصي.
بداية سريعة
أول عملية توليد لك
أنشئ مفتاحًا من API ← API Keys، وصدّره باسم MAGE_API_KEY، ثم شغّل أحد الأمثلة التالية.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
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 يومًا.
MCP
Mage في مساعدك الذكي
Mage في Claude
ولّد الصور والفيديو والصوت في Claude على الويب وتطبيق سطح المكتب وتطبيقات الجوال وCowork.
Mage في ChatGPT
ولّد الصور والفيديو والصوت في ChatGPT كتطبيق MCP شخصي.
Mage في Claude Code
أنشئ الصور والفيديو والصوت داخل Claude Code في الطرفية والمحرر.
Mage في Grok
أنشئ الصور والفيديو والصوت داخل Grok عبر موصّل مخصص.
Mage في Cursor
أنشئ الصور والفيديو والصوت في وضع Cursor Agent.
النماذج
نماذج مميزة
واجهة Flux 2 API
أوامر طويلة وتعديلات بمراجع متعددة
واجهة GPT Image 2 API
أوامر دقيقة ونصوص مقروءة
واجهة Guava API
واقعية فائقة تبدو كصورة فوتوغرافية
واجهة Mango API
عائلة الصور الرائدة لدينا
واجهة Nano Banana 2 API
نصوص واضحة ومقروءة حتى 4K
واجهة Cherry API
عائلة الفيديو الرائدة لدينا
واجهة Lemon API
كل ميزات الفيديو بسعر أنسب
واجهة Plum API
صوت مع كل مقطع، حتى 2K
واجهة Seed Audio API
أصوات وموسيقى ومؤثرات صوتية من أمر واحد
جاهزة للإنتاج
ما يحصل عليه كل طلب إلى Mage API
مفتاح واحد لكل النماذج
37 نموذجًا للصور والفيديو والصوت عبر واجهة REST API واحدة ورصيد Gems واحد. بدّل النموذج بتغيير مسار الرابط.
ادفع مقابل كل عملية إنشاء
بلا اشتراك وبلا حد أدنى للإنفاق. تشتري Gems ويُحتسب على كل طلب سعره المعلن. وإذا فشلت عملية الإنشاء يُسترد المبلغ، إلا إذا حظرتها سياسة المحتوى في Mage.
إعادة محاولة آمنة
تتيح مفاتيح عدم التكرار (Idempotency keys) إعادة إرسال الطلب لتحصل على الطلب الأصلي نفسه دون خصم جديد.
شخصيات متسقة
احفظ شخصية أو مرجعًا مرة واحدة، ثم اكتب @handle في أي أمر لاستخدامه مع كل نموذج يدعم ذلك.
مدخلات كبيرة
أرسل مدخلات الصور والفيديو والصوت كروابط URL أو data URL، أو ارفع ملفات حتى 100 MB عبر رفع موقّع.
20 عملية إنشاء متزامنة
يمكن لكل حساب تشغيل 20 عملية إنشاء في وقت واحد، ويمكن رفع هذا الحد بما يناسب حالتك. الطلبات المرفوضة لا تُحتسب أبدًا.
الأسئلة الشائعة
الأسئلة الشائعة
ما هي Mage API؟
ما هو خادم Mage MCP؟
هل أحتاج إلى مفتاح API لاستخدام خادم MCP؟
كم تبلغ تكلفة Mage API؟
هل أحتاج إلى عضوية في Mage لاستخدام API؟
هل يمكنني استخدام مخرجات API تجاريًا؟
ما حدود معدّل الطلبات؟
هل يمكن لوكيل الذكاء الاصطناعي الخاص بي استخدام واجهة Mage API؟
هل توجد حزمة SDK لواجهة Mage API؟
أستخدم واجهة توليد أخرى بالفعل. ماذا عليّ أن أغيّر؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.