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

Mage API · आपके अगले आइडिया के लिए

एक API। अनगिनत संभावनाएं।

Mage की बेहतरीन खूबियां अपने प्रोडक्ट और AI असिस्टेंट में लाएं। एक ही API की या एक ही MCP कनेक्शन से इमेज, वीडियो और ऑडियो जनरेट करें।

https://api.mage.space/v1

एक नज़र में

Mage डेवलपर्स को https://api.mage.space/v1 पर एक REST API और https://mcp.mage.space/mcp पर एक रिमोट MCP सर्वर देता है। दोनों एक ही अकाउंट पर वही 37 इमेज, वीडियो और ऑडियो मॉडल चलाते हैं, जिनमें Mage के खास Mango 4 और Cherry 2 Pro भी हैं। हर जनरेशन का भुगतान Gems में होता है, कोई सब्सक्रिप्शन नहीं।

  • 37मॉडल
  • 3मीडिया के प्रकार
  • 16MCP टूल
  • $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-v4"
}' | 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-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"])

यह कैसे काम करता है

API की से तैयार मीडिया तक, सिर्फ तीन कॉल में

हर मॉडल में एक ही ऑथेंटिकेशन स्कीम, एक ही एसिंक्रोनस रिक्वेस्ट लाइफ़साइकल और एक जैसे फ़ील्ड नाम हैं।

  1. API की बनाएं

    Mage में साइन इन करें, API → API Keys खोलें और एक की बनाएं। वह mage_sk_ से शुरू होती है और सिर्फ एक बार दिखाई जाती है। एक अकाउंट में 10 एक्टिव की रखी जा सकती हैं।

  2. जनरेशन सबमिट करें

    Authorization: Bearer हेडर के साथ https://api.mage.space/v1/{model}/generate पर JSON बॉडी POST करें। जवाब तुरंत मिलता है, जिसमें request_id, status और status_url होते हैं। Idempotency-Key हेडर भेजें, ताकि रीट्राई करने पर दोबारा भुगतान न हो।

  3. पोल करें और डाउनलोड करें

    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

    ऐसी फ़ोटोरियलिज़्म जो असली तस्वीर जैसी लगे

  • इमेज · 42 Gems से शुरू

    Mango API

    हमारी फ़्लैगशिप इमेज फ़ैमिली

  • इमेज · 51 Gems से शुरू

    Nano Banana 2 API

    साफ़, पढ़ने योग्य टेक्स्ट, 4K तक

  • वीडियो · 618 Gems से शुरू

    Cherry API

    हमारी फ़्लैगशिप वीडियो फ़ैमिली

  • वीडियो · 245 Gems से शुरू

    Lemon API

    वीडियो के सारे फ़ीचर, किफ़ायती दाम पर

  • वीडियो · 173 Gems से शुरू

    Plum API

    हर क्लिप में आवाज़, 2K तक

  • ऑडियो · 19 Gems से शुरू

    Seed Audio API

    एक ही प्रॉम्प्ट से आवाज़ें, संगीत और साउंड इफ़ेक्ट

प्रोडक्शन के लिए बना

Mage API के हर रिक्वेस्ट को क्या मिलता है

  • एक की, सारे मॉडल

    एक REST API और एक Gems बैलेंस के पीछे 37 इमेज, वीडियो और ऑडियो मॉडल। बस URL पाथ बदलकर मॉडल बदलें।

  • हर जेनरेशन के हिसाब से भुगतान

    कोई सब्सक्रिप्शन नहीं और कोई न्यूनतम खर्च नहीं। आप Gems खरीदते हैं, और हर रिक्वेस्ट पर उसकी सूचीबद्ध कीमत लगती है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, सिवाय उसके जिसे Mage की कंटेंट पॉलिसी ने ब्लॉक किया हो।

  • सुरक्षित रीट्राई

    Idempotency की की मदद से दोबारा भेजा गया सबमिट दोबारा चार्ज किए बिना मूल रिक्वेस्ट ही लौटाता है।

  • एक जैसे कैरेक्टर

    कैरेक्टर या रेफ़रेंस को एक बार सेव करें, फिर किसी भी प्रॉम्प्ट में @handle लिखकर उसे हर समर्थित मॉडल के साथ इस्तेमाल करें।

  • बड़े इनपुट

    इमेज, वीडियो और ऑडियो इनपुट URL या डेटा URL के रूप में भेजें, या साइंड अपलोड के ज़रिए 100 MB तक की फ़ाइलें अपलोड करें।

  • एक साथ 20 जेनरेशन

    हर अकाउंट एक साथ 20 जेनरेशन चला सकता है, और आपकी ज़रूरत के हिसाब से यह सीमा बढ़ाई जा सकती है। अस्वीकृत रिक्वेस्ट पर कभी चार्ज नहीं लगता।

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

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

Mage API क्या है?
Mage API, https://api.mage.space/v1 पर एक REST API है, जिससे आप अपने कोड से 37 मॉडल के साथ इमेज, वीडियो और ऑडियो जनरेट कर सकते हैं। रिक्वेस्ट एसिंक्रोनस होती हैं और हर जनरेशन का भुगतान 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 रिक्वेस्ट पर लागू नहीं होता। इसके लिए अकाउंट में पहले एक सफल पेमेंट होना ज़रूरी है, चाहे वह किसी भी Gem पैक या प्लान का हो। साइनअप बोनस 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 बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।

Charactersकम्युनिटी