Mage API · حزم SDK
حزم SDK الرسمية لواجهة Mage API
عملاء مضبوطو الأنواع للغتي TypeScript وPython، وعُقد Mage لـ ComfyUI. كل نماذج الصور والفيديو والصوت في بضعة أسطر من الكود.
لمحة سريعة
ينشر Mage حزم SDK مفتوحة المصدر لواجهته البرمجية: @mage-space/sdk على npm للغتي TypeScript وJavaScript، وmage-space على PyPI للغة Python، وحزمة العقد comfyui-mage لـ ComfyUI. تغلّف كل منها واجهة REST API بإعدادات مكتوبة الأنواع لجميع النماذج الـ 37، مع استعلام تلقائي وإعادة محاولة آمنة ورفع للملفات.
- 3حزم SDK والتكاملات
- 37نماذج مضبوطة الأنواع
- MITمفتوح المصدر
- $0للتثبيت
اختر ما يناسبك
حزم SDK والتكاملات
npm install @mage-space/sdkTypeScript SDK
ولّد الصور والفيديو والصوت من Node.js بإعدادات مضبوطة الأنواع لكل نموذج من نماذج Mage. استدعاء واحد يرسل الطلب وينتظر ويعيد النتيجة.
pip install mage-spacePython SDK
ولّد الصور والفيديو والصوت من Python بعملاء متزامنين وغير متزامنين (asyncio) وإعدادات مضبوطة الأنواع لكل نموذج من نماذج Mage.
comfy node install comfyui-mageMage لـ ComfyUI
Mango وCherry وSeed Audio وكل نماذج Mage الأخرى كعُقد في ComfyUI. بلا GPU وبلا تنزيل نماذج.
بداية سريعة
أول عملية توليد لك باستخدام SDK
ثبّت الحزمة، وصدّر 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"])مدمج
ما تتولاه كل حزمة SDK نيابةً عنك
استدعاء واحد، ووسائط جاهزة
يرسل run طلب التوليد، ويستعلم عن حالته بفترات التراجع التي توصي بها الواجهة، ثم يعيد الطلب المكتمل مع result.url.
إعادة محاولات بلا دفع مزدوج
يحمل كل طلب مفتاح تكرار آمنًا (idempotency key). تُعاد المحاولة عند أخطاء الشبكة والخادم مع فترات تراجع، ولا يُحتسب الطلب المعاد مرة أخرى.
رفع الملفات باستدعاء واحد
الملفات الأكبر من أن تُرسل كـ data URL تُرفع عبر رابط رفع موقّع، ونتولى عنك التذكرة وطلب PUT والتحقق من الحجم.
أخطاء واضحة
تتضمن حالات رفض الواجهة رمز حالة HTTP ورمز الخطأ ومعرّف الطلب، وللتوليد الفاشل أو الملغى وانتهاء المهلة أنواع أخطاء خاصة بها.
الحزم
من أين تحصل عليها
| SDK | الحزمة | التثبيت | المصدر |
|---|---|---|---|
| TypeScript SDK | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK | mage-space | pip install mage-space | GitHub |
| Mage لـ ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
الأسئلة الشائعة
الأسئلة الشائعة
هل حزم Mage SDK مجانية ومفتوحة المصدر؟
هل تعمل نماذج Mage الجديدة مع إصدار أقدم من SDK؟
كيف تتجنب حزم SDK الدفع مرتين عند إعادة محاولة طلب؟
هل حزم SDK مستقرة؟
كم تبلغ تكلفة Mage API؟
هل أحتاج إلى عضوية في Mage لاستخدام API؟
هل يمكنني استخدام مخرجات API تجاريًا؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.