لمحة سريعة
تشغّل Mage API 15 نموذجًا للصور و12 نموذجًا للفيديو ونموذجًا صوتيًا واحدًا على https://api.mage.space/v1/{model}/generate. تستخدم جميع النماذج المفتاح نفسه ودورة الطلب نفسها وأسماء الحقول نفسها، ويُدفع لكل عملية توليد بالـ Gems.
15
نماذج الصور
12
نماذج الفيديو
1
نماذج الصوت
1
مفتاح API واحد للجميع
نماذج الصور
نماذج توليد الصور
الأسعار لكل عملية توليد، بـ Gems. يكلّف 1,000 Gems دولارًا واحدًا في الباقة القياسية، وتضيف الباقات الأكبر Gems إضافية. يعتمد السعر على النموذج والدقة والمدة؛ ويظهر السعر بالإعدادات الافتراضية، وتوضح كل استجابة الرسوم الدقيقة في billing.gems_charged. تُسترد تكلفة عملية التوليد الفاشلة، أما التي تحظرها سياسة المحتوى في Mage فلا تُسترد.
| النموذج | الأنسب لـ | قيم model_id | السعر الافتراضي |
|---|---|---|---|
| Anima | مصمم خصيصًا للأنمي | anima-v1 | 20 Gems ($0.02) |
| Chroma | مفتوح الأوزان، مبني على Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | المطالبات الطويلة والتعديلات متعددة المراجع | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | مطالبات دقيقة ونص مقروء | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine بثلاثة مستويات للجودة | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | واقعية تضاهي الصور الفوتوغرافية | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | سريع ومتعدد الاستخدامات، مع مطالبات سلبية | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | جماليات رائعة في ثوانٍ | krea-2-turbo | 20 Gems ($0.02) |
| Mango | عائلة الصور الرائدة لدينا | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | نص واضح ومقروء، حتى 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL بوجوه وأيدٍ مُحسَّنة | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | الكلاسيكي بسعر اقتصادي | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | نسخة Stable Diffusion الأكثر استجابة لما تكتبه | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL مضبوط للواقعية | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | أسرع نموذج صور في Mage | z-image-turbo | 10 Gems ($0.01) |
نماذج الفيديو
نماذج توليد الفيديو
| النموذج | الأنسب لـ | قيم 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-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) |
| Melon | أنمي متحرك مع صوت اختياري | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | فيديو مفتوح سريع بصوت ستيريو | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | صوت في كل مقطع، حتى 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | شخصيات تنبض بالحياة من الإطار الأول | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | فيديو بأوزان مفتوحة مع نسخة Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
نماذج الصوت
نماذج توليد الصوت
| النموذج | الأنسب لـ | قيم model_id | السعر الافتراضي |
|---|---|---|---|
| Seed Audio | أصوات وموسيقى ومؤثرات صوتية من وصف واحد | seed-audio-1.0 | 19 Gems ($0.019) |
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.