एक कॉल, तैयार मीडिया
run जनरेशन सबमिट करता है, API के सुझाए बैकऑफ़ के साथ पोल करता है और पूरा हुआ रिक्वेस्ट result.url के साथ लौटाता है।
एक नज़र में
Mage अपने API के लिए ओपन-सोर्स SDK उपलब्ध कराता है: TypeScript और JavaScript के लिए npm पर @mage-space/sdk, Python के लिए PyPI पर mage-space, और ComfyUI के लिए comfyui-mage नोड पैक। हर SDK REST API को सभी 28 मॉडल के टाइप्ड कॉन्फ़िग, ऑटोमैटिक पोलिंग, आइडेम्पोटेंट रीट्राई और अपलोड के साथ सरल बनाता है।
3
SDK और इंटीग्रेशन
28
टाइप्ड मॉडल
MIT
ओपन सोर्स
$0
इंस्टॉल करने के लिए
अपना चुनें
SDK और इंटीग्रेशन
npm install @mage-space/sdk
TypeScript SDK
Node.js से इमेज, वीडियो और ऑडियो जनरेट करें, हर Mage मॉडल के टाइप्ड कॉन्फ़िग के साथ। एक ही कॉल सबमिट करती है, इंतज़ार करती है और नतीजा लौटाती है।
pip install mage-space
Python SDK
Python से इमेज, वीडियो और ऑडियो जनरेट करें, sync और asyncio क्लाइंट और हर Mage मॉडल के टाइप्ड कॉन्फ़िग के साथ।
comfy node install comfyui-mage
ComfyUI के लिए Mage
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-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"])बिल्ट-इन
हर SDK आपके लिए क्या संभालता है
ऐसे रीट्राई जिनमें दोबारा पैसे नहीं लगते
हर सबमिशन के साथ एक आइडेम्पोटेंसी की जाती है। नेटवर्क और सर्वर एरर पर बैकऑफ़ के साथ रीट्राई होता है, और दोबारा भेजे गए सबमिशन का शुल्क कभी दोबारा नहीं लगता।
एक कॉल में अपलोड
डेटा URL के लिए बहुत बड़ी फ़ाइलें साइन्ड अपलोड से जाती हैं, जिसमें टिकट, PUT और साइज़ की जाँच आपके लिए संभाली जाती है।
साफ़ एरर
API के इनकार के साथ HTTP स्टेटस, एरर कोड और रिक्वेस्ट id मिलता है; फ़ेल या रद्द हुए जनरेशन और टाइमआउट के अपने अलग एरर टाइप हैं।
पैकेज
इन्हें कहाँ से पाएं
| SDK | पैकेज | इंस्टॉल | सोर्स |
|---|---|---|---|
| TypeScript SDK | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK | mage-space | pip install mage-space | GitHub |
| ComfyUI के लिए Mage | comfyui-mage | comfy node install comfyui-mage | GitHub |
अक्सर पूछे जाने वाले सवाल
अक्सर पूछे जाने वाले सवाल
क्या Mage SDK मुफ़्त और ओपन सोर्स हैं?
हाँ। SDK और ComfyUI नोड्स GitHub पर MIT लाइसेंस के तहत उपलब्ध हैं, और इन्हें इंस्टॉल करना मुफ़्त है। आप सिर्फ़ अपने जनरेशन के लिए भुगतान करते हैं, Gems में, हर मॉडल की बताई गई कीमत पर।
क्या Mage के नए मॉडल पुराने SDK के साथ काम करते हैं?
हाँ। नए मॉडल की id को स्ट्रिंग के रूप में दें और वह चल जाएगा; SDK उसके कॉन्फ़िग को उन फ़ील्ड से मिलाकर जाँचता है जो सभी मॉडल में समान होते हैं। API रेफ़रेंस बदलने पर एक बॉट टाइप अपडेट कर देता है, इसलिए नए मॉडल अगली रिलीज़ में अपने टाइप के साथ आ जाते हैं।
दोबारा भेजे गए रिक्वेस्ट के लिए SDK दो बार भुगतान होने से कैसे बचाते हैं?
हर सबमिशन के साथ एक Idempotency-Key जाती है। SDK हर कॉल के लिए नई key बनाता है और उसी कॉल को खुद दोबारा भेजते समय वही key इस्तेमाल करता है, इसलिए दोबारा भेजा गया सबमिशन मूल रिक्वेस्ट ही लौटाता है और कोई शुल्क नहीं लगता।
क्या SDK स्टेबल हैं?
वे 0.x पर बीटा में हैं, इसलिए किसी माइनर वर्शन में उनमें बदलाव हो सकता है। API का वर्शन अलग से तय होता है और v1 के भीतर स्टेबल रहता है।
Mage API की कीमत कितनी है?
इसमें कोई सब्सक्रिप्शन या मासिक शुल्क नहीं है। हर जेनरेशन का भुगतान Gems में उस मॉडल की सूचीबद्ध कीमत पर होता है, और स्टैंडर्ड पैक में 1,000 Gems की कीमत $1 है। हर मॉडल पेज पर उसकी डिफ़ॉल्ट सेटिंग की कीमत दी गई है, और हर रिस्पॉन्स में सटीक चार्ज बताया जाता है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, लेकिन जिसे Mage की कंटेंट पॉलिसी ब्लॉक करे उसका नहीं। जो रिक्वेस्ट आपका बैलेंस कवर न कर सके, उसे कोई चार्ज लगने से पहले ही अस्वीकार कर दिया जाता है।
क्या API इस्तेमाल करने के लिए मुझे Mage मेंबरशिप चाहिए?
नहीं। API सिर्फ़ Gems से चलता है। मेंबरशिप प्लान और उनकी ऐप में अनलिमिटेड जेनरेशन API रिक्वेस्ट पर लागू नहीं होतीं, इसलिए Gems वाला कोई भी Mage अकाउंट इसे इस्तेमाल कर सकता है।
क्या मैं API के आउटपुट का व्यावसायिक उपयोग कर सकता/सकती हूँ?
हाँ। Mage से बनाया गया कंटेंट, API और MCP server के ज़रिए बनाया गया कंटेंट भी, व्यावसायिक रूप से इस्तेमाल किया जा सकता है। क्रेडिट देना अच्छा लगेगा, लेकिन ज़रूरी नहीं है।
Mage के साथ बनाना शुरू करें
एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।