सीधे कंटेंट पर जाएँ

Mage API · SDK

Mage API के आधिकारिक SDK

TypeScript और Python के लिए टाइप्ड क्लाइंट, और ComfyUI के लिए Mage नोड्स। हर इमेज, वीडियो और ऑडियो मॉडल बस कुछ लाइनों के कोड में।

एक नज़र में

Mage अपने API के लिए ओपन-सोर्स SDK देता है: TypeScript और JavaScript के लिए npm पर @mage-space/sdk, Python के लिए PyPI पर mage-space, और ComfyUI के लिए comfyui-mage नोड पैक। हर एक REST API को सभी 37 मॉडल के टाइप्ड कॉन्फ़िग, ऑटोमैटिक पोलिंग, आइडेम्पोटेंट रीट्राई और अपलोड के साथ रैप करता है।

  • 3SDK और इंटीग्रेशन
  • 37टाइप्ड मॉडल
  • 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-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 जनरेशन सबमिट करता है, API के सुझाए बैकऑफ़ के साथ पोल करता है और पूरा हुआ रिक्वेस्ट result.url के साथ लौटाता है।

  • ऐसे रीट्राई जिनमें दोबारा पैसे नहीं लगते

    हर सबमिशन के साथ एक आइडेम्पोटेंसी की जाती है। नेटवर्क और सर्वर एरर पर बैकऑफ़ के साथ रीट्राई होता है, और दोबारा भेजे गए सबमिशन का शुल्क कभी दोबारा नहीं लगता।

  • एक कॉल में अपलोड

    डेटा URL के लिए बहुत बड़ी फ़ाइलें साइन्ड अपलोड से जाती हैं, जिसमें टिकट, PUT और साइज़ की जाँच आपके लिए संभाली जाती है।

  • साफ़ एरर

    API के इनकार के साथ HTTP स्टेटस, एरर कोड और रिक्वेस्ट id मिलता है; फ़ेल या रद्द हुए जनरेशन और टाइमआउट के अपने अलग एरर टाइप हैं।

पैकेज

इन्हें कहाँ से पाएं

SDKपैकेजइंस्टॉलसोर्स
TypeScript SDK@mage-space/sdknpm install @mage-space/sdkGitHub
Python SDKmage-spacepip install mage-spaceGitHub
ComfyUI के लिए Magecomfyui-magecomfy node install comfyui-mageGitHub

अक्सर पूछे जाने वाले सवाल

अक्सर पूछे जाने वाले सवाल

क्या 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 रिक्वेस्ट पर लागू नहीं होता। इसके लिए अकाउंट में पहले एक सफल पेमेंट होना ज़रूरी है, चाहे वह किसी भी Gem पैक या प्लान का हो। साइनअप बोनस Gems सिर्फ़ Mage ऐप में काम करते हैं।
क्या मैं API के आउटपुट का व्यावसायिक उपयोग कर सकता/सकती हूँ?
हाँ। Mage से बनाया गया कंटेंट, API और MCP server के ज़रिए बनाया गया कंटेंट भी, व्यावसायिक रूप से इस्तेमाल किया जा सकता है। क्रेडिट देना अच्छा लगेगा, लेकिन ज़रूरी नहीं है।

Mage के साथ बनाना शुरू करें

एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।

Charactersकम्युनिटी