एक की, सारे मॉडल
28 इमेज, वीडियो और ऑडियो मॉडल, एक REST API और एक Gems बैलेंस के साथ। बस URL पाथ बदलकर मॉडल बदलें।
एक नज़र में
Mage डेवलपर्स को https://api.mage.space/v1 पर एक REST API और https://mcp.mage.space/mcp पर एक रिमोट MCP सर्वर देता है। दोनों एक ही अकाउंट पर वही 28 इमेज, वीडियो और ऑडियो मॉडल चलाते हैं, जिनमें सिर्फ Mage पर मिलने वाले Mango 3 और Cherry 2 Pro भी शामिल हैं। हर जनरेशन का भुगतान Gems में होता है, कोई सब्सक्रिप्शन नहीं।
28
मॉडल
3
मीडिया के प्रकार
16
MCP टूल
$0
मासिक शुल्क
इस्तेमाल के तरीके
कोड, अपने असिस्टेंट या ComfyUI से कॉल करें
REST API
Mage API
की के साथ अपने कोड से जनरेशन सबमिट करें। एसिंक्रोनस रिक्वेस्ट, सुरक्षित रीट्राई, 100 MB तक के अपलोड और एक साथ 20 जनरेशन।
SDK
TypeScript और Python SDK
आधिकारिक टाइप्ड क्लाइंट, जो कुछ ही लाइनों में सबमिट करते हैं, नतीजे का इंतज़ार करते हैं, सुरक्षित रीट्राई करते हैं और फ़ाइलें अपलोड करते हैं।
MCP सर्वर
Mage MCP सर्वर
साइन-इन करके Claude, ChatGPT, Claude Code, Grok या Cursor कनेक्ट करें, और आसान शब्दों में इमेज, वीडियो और ऑडियो मांगें।
ComfyUI
ComfyUI के लिए Mage
Mango, Cherry, Seed Audio और Mage के बाकी सभी मॉडल ComfyUI नोड्स के रूप में। न GPU चाहिए, न मॉडल डाउनलोड।
मीडिया के प्रकार के अनुसार
जनरेशन 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 एक्टिव की रखी जा सकती हैं।
जनरेशन सबमिट करें
Authorization: Bearer हेडर के साथ https://api.mage.space/v1/{model}/generate पर JSON बॉडी POST करें। जवाब तुरंत मिलता है, जिसमें request_id, status और status_url होते हैं। Idempotency-Key हेडर भेजें, ताकि रीट्राई करने पर दोबारा भुगतान न हो।
पोल करें और डाउनलोड करें
status_url को तब तक पोल करें, जब तक status completed, failed या cancelled न हो जाए। पूरी हुई रिक्वेस्ट में result.url होता है, जिसमें इमेज, वीडियो या ऑडियो फ़ाइल 30 दिनों तक रखी जाती है।
MCP
आपके AI असिस्टेंट में Mage
Claude में Mage
Claude में वेब, डेस्कटॉप ऐप, मोबाइल ऐप और Cowork पर इमेज, वीडियो और ऑडियो जनरेट करें।
ChatGPT में Mage
ChatGPT में पर्सनल MCP ऐप के रूप में इमेज, वीडियो और ऑडियो जनरेट करें।
Claude Code में Mage
अपने टर्मिनल और एडिटर में Claude Code के अंदर इमेज, वीडियो और ऑडियो जेनरेट करें।
Grok में Mage
कस्टम कनेक्टर के रूप में Grok में इमेज, वीडियो और ऑडियो जेनरेट करें।
Cursor में Mage
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 की की मदद से दोबारा भेजा गया सबमिट दोबारा चार्ज किए बिना मूल रिक्वेस्ट ही लौटाता है।
एक जैसे कैरेक्टर
कैरेक्टर या रेफ़रेंस को एक बार सेव करें, फिर किसी भी प्रॉम्प्ट में @handle लिखकर उसे हर समर्थित मॉडल के साथ इस्तेमाल करें।
बड़े इनपुट
इमेज, वीडियो और ऑडियो इनपुट URL या डेटा URL के रूप में भेजें, या साइंड अपलोड के ज़रिए 100 MB तक की फ़ाइलें अपलोड करें।
एक साथ 20 जेनरेशन
हर अकाउंट एक साथ 20 जेनरेशन चला सकता है, और आपकी ज़रूरत के हिसाब से यह सीमा बढ़ाई जा सकती है। अस्वीकृत रिक्वेस्ट पर कभी चार्ज नहीं लगता।
अक्सर पूछे जाने वाले सवाल
अक्सर पूछे जाने वाले सवाल
Mage API क्या है?
Mage API एक REST API है (https://api.mage.space/v1), जिससे आप अपने कोड से 28 मॉडल के साथ इमेज, वीडियो और ऑडियो जेनरेट कर सकते हैं। रिक्वेस्ट एसिंक्रोनस होती हैं और भुगतान हर जेनरेशन के हिसाब से Gems में होता है।
Mage MCP सर्वर क्या है?
यह https://mcp.mage.space/mcp पर एक रिमोट Model Context Protocol सर्वर है, जिससे AI असिस्टेंट आपके Mage अकाउंट पर इमेज, वीडियो और ऑडियो जेनरेट कर सकते हैं। असिस्टेंट को 16 टूल मिलते हैं, जिनसे वह मॉडल चुन सकता है, कीमत बता सकता है, जेनरेट कर सकता है, नतीजे का इंतज़ार कर सकता है, और आपके सेव किए कैरेक्टर, रेफ़रेंस और हिस्ट्री इस्तेमाल कर सकता है।
क्या MCP सर्वर इस्तेमाल करने के लिए मुझे API की चाहिए?
नहीं। Claude, ChatGPT, Grok, Cursor और Claude Code, OAuth के ज़रिए Mage में साइन इन करके कनेक्ट होते हैं। API की वैकल्पिक है, और CI जैसे हेडलेस सेटअप के लिए होती है।
Mage API की कीमत कितनी है?
इसमें कोई सब्सक्रिप्शन या मासिक शुल्क नहीं है। हर जेनरेशन का भुगतान Gems में उस मॉडल की सूचीबद्ध कीमत पर होता है, और स्टैंडर्ड पैक में 1,000 Gems की कीमत $1 है। हर मॉडल पेज पर उसकी डिफ़ॉल्ट सेटिंग की कीमत दी गई है, और हर रिस्पॉन्स में सटीक चार्ज बताया जाता है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, लेकिन जिसे Mage की कंटेंट पॉलिसी ब्लॉक करे उसका नहीं। जो रिक्वेस्ट आपका बैलेंस कवर न कर सके, उसे कोई चार्ज लगने से पहले ही अस्वीकार कर दिया जाता है।
क्या API इस्तेमाल करने के लिए मुझे Mage मेंबरशिप चाहिए?
नहीं। API सिर्फ़ Gems से चलता है। मेंबरशिप प्लान और उनकी ऐप में अनलिमिटेड जेनरेशन API रिक्वेस्ट पर लागू नहीं होतीं, इसलिए Gems वाला कोई भी Mage अकाउंट इसे इस्तेमाल कर सकता है।
क्या मैं API के आउटपुट का व्यावसायिक उपयोग कर सकता/सकती हूँ?
हाँ। Mage से बनाया गया कंटेंट, API और MCP server के ज़रिए बनाया गया कंटेंट भी, व्यावसायिक रूप से इस्तेमाल किया जा सकता है। क्रेडिट देना अच्छा लगेगा, लेकिन ज़रूरी नहीं है।
रेट लिमिट क्या हैं?
एक अकाउंट में एक समय पर 20 जनरेशन कतार में या चल रहे हो सकते हैं। इससे ज़्यादा सबमिट करने पर 429 के साथ अस्वीकार हो जाता है और कोई शुल्क नहीं लगता। अपने उपयोग के लिए सीमा बढ़वाने हेतु [email protected] पर लिखें।
क्या मेरा AI एजेंट Mage API इस्तेमाल कर सकता है?
हाँ। एजेंट key के साथ REST API कॉल कर सकते हैं, या Mage MCP server से जुड़ सकते हैं, जो Claude, ChatGPT, Claude Code, Grok और Cursor को मॉडल चुनने, कीमत जानने, जनरेट करने और नतीजा पाने के लिए सोलह तैयार टूल देता है। देखें MCP server।
क्या Mage API के लिए कोई SDK है?
हाँ। npm पर आधिकारिक @mage-space/sdk पैकेज और PyPI पर mage-space ओपन सोर्स हैं और हर मॉडल के लिए टाइप्ड हैं। ये आपके लिए सबमिट करते हैं, नतीजे का इंतज़ार करते हैं, सुरक्षित तरीके से रीट्राई करते हैं और फ़ाइलें अपलोड करते हैं। ComfyUI यूज़र comfyui-mage नोड पैक इंस्टॉल कर सकते हैं। देखें Mage SDKs।
मेरे पास पहले से कोई दूसरी जनरेशन API है। मुझे क्या बदलना होगा?
अपने क्लाइंट को https://api.mage.space/v1 पर पॉइंट करें, अपनी Mage key को Bearer टोकन के रूप में भेजें, और अपने फ़ील्ड मॉडल पेज से मैप करें: prompt, aspect_ratio, resolution, duration और model_id हर Mage मॉडल में एक जैसे काम करते हैं। रिक्वेस्ट एसिंक्रोनस होती हैं, इसलिए सबमिट करें और फिर status_url को पोल करें।
Mage के साथ बनाना शुरू करें
एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।