مفتاح واحد لكل النماذج
28 نموذجًا للصور والفيديو والصوت عبر واجهة REST API واحدة ورصيد Gems واحد. بدّل بين النماذج بتغيير مسار الرابط فقط.
لمحة سريعة
يوفّر Mage للمطورين واجهة REST API على https://api.mage.space/v1 ومزوّد MCP عن بُعد على https://mcp.mage.space/mcp. كلاهما يشغّل نفس نماذج الصور والفيديو والصوت الـ 28، بما فيها Mango 3 وCherry 2 Pro الحصريان على Mage، ضمن حساب واحد، ويُدفع مقابل كل عملية توليد بالـ Gems دون أي اشتراك.
28
النماذج
3
أنواع الوسائط
16
أدوات MCP
$0
الرسوم الشهرية
طرق الاستخدام
استخدمه من الكود أو من مساعدك أو من ComfyUI
REST API
واجهة Mage API
أرسل طلبات التوليد من كودك الخاص باستخدام مفتاح. طلبات غير متزامنة، وإعادة محاولة آمنة (idempotent)، ورفع ملفات حتى 100 ميغابايت، و20 عملية توليد في وقت واحد.
SDKs
حزم SDK لـ TypeScript وPython
عملاء رسميون بأنواع محدّدة يرسلون الطلب وينتظرون النتيجة ويعيدون المحاولة بأمان ويرفعون الملفات في أسطر قليلة.
مزوّد MCP
مزوّد Mage MCP
اربط Claude أو ChatGPT أو Claude Code أو Grok أو Cursor بتسجيل دخول، واطلب الصور والفيديو والصوت بكلمات بسيطة.
ComfyUI
Mage لـ ComfyUI
Mango وCherry وSeed Audio وكل نماذج Mage الأخرى كعُقد في ComfyUI. بلا GPU وبلا تنزيل نماذج.
حسب نوع الوسائط
واجهات API للتوليد
15 نموذجًا
واجهة API لتوليد الصور بالذكاء الاصطناعي
تحويل النص إلى صورة، والتعديل، وشخصيات متسقة بدقة تصل إلى 4K.
12 نموذجًا
واجهة 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-v3"
}' | 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-v3',
});
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-v3",
})
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.
النماذج
نماذج مميزة
صورة · من 40 Gems
واجهة Flux 2 API
أوامر طويلة وتعديلات بمراجع متعددة
صورة · من 9 Gems
واجهة GPT Image 2 API
أوامر دقيقة ونصوص مقروءة
صورة · من 37 Gems
واجهة Guava API
واقعية فائقة تبدو كصورة فوتوغرافية
صورة · من 135 Gems
واجهة Mango API
عائلة الصور الرائدة لدينا
صورة · من 68 Gems
واجهة Nano Banana 2 API
نصوص واضحة ومقروءة حتى 4K
فيديو · من 618 Gems
واجهة Cherry API
عائلة الفيديو الرائدة لدينا
فيديو · من 245 Gems
واجهة Lemon API
كل ميزات الفيديو بسعر أنسب
فيديو · من 338 Gems
واجهة Plum API
صوت مع كل مقطع، حتى 2K
صوت · من 19 Gems
واجهة Seed Audio API
أصوات وموسيقى ومؤثرات صوتية من أمر واحد
جاهزة للإنتاج
ما يحصل عليه كل طلب إلى Mage API
ادفع مقابل كل عملية إنشاء
بلا اشتراك وبلا حد أدنى للإنفاق. تشتري Gems ويُحتسب على كل طلب سعره المعلن. وإذا فشلت عملية الإنشاء يُسترد المبلغ، إلا إذا حظرتها سياسة المحتوى في Mage.
إعادة محاولة آمنة
تتيح مفاتيح عدم التكرار (Idempotency keys) إعادة إرسال الطلب لتحصل على الطلب الأصلي نفسه دون خصم جديد.
شخصيات متسقة
احفظ شخصية أو مرجعًا مرة واحدة، ثم اكتب @handle في أي أمر لاستخدامه مع كل نموذج يدعم ذلك.
مدخلات كبيرة
أرسل مدخلات الصور والفيديو والصوت كروابط URL أو data URL، أو ارفع ملفات حتى 100 MB عبر رفع موقّع.
20 عملية إنشاء متزامنة
يمكن لكل حساب تشغيل 20 عملية إنشاء في وقت واحد، ويمكن رفع هذا الحد بما يناسب حالتك. الطلبات المرفوضة لا تُحتسب أبدًا.
الأسئلة الشائعة
الأسئلة الشائعة
ما هي Mage API؟
Mage API هي واجهة REST API على https://api.mage.space/v1 لإنشاء الصور والفيديو والصوت بـ 28 نموذجًا من شيفرتك البرمجية. الطلبات غير متزامنة، ويُدفع مقابل كل عملية إنشاء بـ Gems.
ما هو خادم Mage MCP؟
خادم Model Context Protocol عن بُعد على https://mcp.mage.space/mcp يتيح لمساعدي الذكاء الاصطناعي إنشاء الصور والفيديو والصوت على حسابك في Mage. ويمنح المساعد 16 أداة لاختيار النموذج ومعرفة السعر والإنشاء وانتظار النتيجة واستخدام شخصياتك ومراجعك وسجلك المحفوظ.
هل أحتاج إلى مفتاح API لاستخدام خادم MCP؟
لا. يتصل Claude وChatGPT وGrok وCursor وClaude Code عبر تسجيل الدخول إلى Mage باستخدام OAuth. مفتاح API اختياري، ويفيد في الإعدادات دون واجهة مثل CI.
كم تبلغ تكلفة Mage API؟
لا يوجد اشتراك ولا رسوم شهرية. تُدفع كل عملية إنشاء بـ Gems وفق السعر المعلن لنموذجها، وكل 1,000 Gems تكلّف 1$ في الباقة القياسية. تعرض صفحة كل نموذج سعره بالإعدادات الافتراضية، ويذكر كل رد المبلغ المحتسب بدقة. إذا فشلت عملية الإنشاء يُسترد المبلغ، أما إذا حظرتها سياسة المحتوى في Mage فلا يُسترد. أما الطلب الذي لا يغطيه رصيدك فيُرفض قبل خصم أي مبلغ.
هل أحتاج إلى عضوية في Mage لاستخدام API؟
لا. تعمل API بـ Gems فقط. لا تنطبق خطط العضوية وميزة الإنشاء غير المحدود داخل التطبيق على طلبات API، لذا يمكن لأي حساب Mage يحتوي على Gems استخدامها.
هل يمكنني استخدام مخرجات API تجاريًا؟
نعم. يمكنك استخدام المحتوى الذي تنشئه باستخدام Mage، بما في ذلك عبر واجهة API وخادم MCP، لأغراض تجارية. نقدّر ذكر المصدر لكنه ليس إلزاميًا.
ما حدود معدّل الطلبات؟
يمكن أن يضم الحساب الواحد 20 عملية توليد في قائمة الانتظار أو قيد التشغيل في الوقت نفسه. يُرفض أي طلب يتجاوز ذلك برمز 429 ولا يكلّف شيئًا. راسلنا على [email protected] لرفع الحد بما يناسب استخدامك.
هل يمكن لوكيل الذكاء الاصطناعي الخاص بي استخدام واجهة Mage API؟
نعم. يمكن للوكلاء استدعاء واجهة REST API باستخدام مفتاح، أو الاتصال بخادم Mage MCP الذي يمنح Claude وChatGPT وClaude Code وGrok وCursor ستة عشر أداة جاهزة لاختيار نموذج، ومعرفة السعر، والتوليد، وجلب النتيجة. راجع خادم MCP.
هل توجد حزمة SDK لواجهة Mage API؟
نعم. حزمة @mage-space/sdk الرسمية على npm وحزمة mage-space على PyPI مفتوحتا المصدر ومزودتان بالأنواع (typed) لكل نموذج. ترسلان الطلب، وتنتظران النتيجة، وتعيدان المحاولة بأمان، وترفعان الملفات نيابةً عنك. يمكن لمستخدمي ComfyUI تثبيت حزمة العقد comfyui-mage. راجع حزم Mage SDK.
أستخدم واجهة توليد أخرى بالفعل. ماذا عليّ أن أغيّر؟
اجعل عميلك يشير إلى https://api.mage.space/v1، وأرسل مفتاح Mage كرمز Bearer، وطابق حقولك مع صفحة النموذج: تعمل prompt وaspect_ratio وresolution وduration وmodel_id بالطريقة نفسها مع جميع نماذج Mage. الطلبات غير متزامنة، لذا أرسل الطلب ثم استعلم عن status_url بشكل متكرر.
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.