एक की, सारे मॉडल
28 इमेज, वीडियो और ऑडियो मॉडल, एक REST API और एक Gems बैलेंस के साथ। बस URL पाथ बदलकर मॉडल बदलें।
एक नज़र में
Mage इमेज जनरेशन API https://api.mage.space/v1 पर एक REST API है, जो Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 और Krea 2 समेत 15 टेक्स्ट-टू-इमेज और इमेज-एडिटिंग मॉडल चलाती है। आप /{model}/generate पर प्रॉम्प्ट POST करते हैं, रिक्वेस्ट को पोल करते हैं और इमेज डाउनलोड करते हैं। हर इमेज का भुगतान Gems में होता है, कोई सबस्क्रिप्शन नहीं।
15
इमेज मॉडल
$0.009
प्रति इमेज सबसे सस्ता डिफ़ॉल्ट
20
एक साथ जनरेशन
$0
मासिक शुल्क
मॉडल
Mage API में हर इमेज मॉडल
कीमतें प्रति जनरेशन, Gems में हैं। स्टैंडर्ड पैक पर 1,000 Gems की कीमत $1 है, और बड़े पैक में बोनस Gems मिलते हैं। कीमत मॉडल, रिज़ॉल्यूशन और अवधि पर निर्भर करती है; यहाँ डिफ़ॉल्ट सेटिंग की कीमत दिखाई गई है, और हर रिस्पॉन्स में सटीक शुल्क billing.gems_charged में बताया जाता है। जो जनरेशन फ़ेल होता है उसके Gems लौटा दिए जाते हैं; जिसे Mage की कंटेंट पॉलिसी ब्लॉक करती है, उसके नहीं।
| मॉडल | इनके लिए सबसे अच्छा | model_id मान | डिफ़ॉल्ट कीमत |
|---|---|---|---|
| Anima | एनीमे के लिए खास तौर पर बना | anima-v1 | 20 Gems ($0.02) |
| Chroma | ओपन-वेट्स, Flux पर आधारित | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | लंबे प्रॉम्प्ट और कई रेफ़रेंस वाले एडिट | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | सटीक प्रॉम्प्ट और पढ़ने लायक टेक्स्ट | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, तीन क्वालिटी टियर में | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | ऐसा फ़ोटोरियलिज़्म जो असली फ़ोटो जैसा लगे | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | तेज़ और बहुमुखी, नेगेटिव प्रॉम्प्ट के साथ | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | सेकंडों में शानदार सौंदर्य | krea-2-turbo | 20 Gems ($0.02) |
| Mango | हमारा फ़्लैगशिप इमेज परिवार | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | साफ़, पढ़ने लायक टेक्स्ट, 4K तक | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL, जिसमें चेहरे और हाथ ठीक किए गए हैं | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | क्लासिक, कम बजट में | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | वह Stable Diffusion जो आपकी बात सबसे अच्छी तरह सुनता है | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | फ़ोटोरियल के लिए ट्यून किया गया SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Mage का सबसे तेज़ इमेज मॉडल | z-image-turbo | 10 Gems ($0.01) |
क्विक स्टार्ट
Anima v1 से इमेज जनरेट करें
MAGE_API_KEY सेट करें, रिक्वेस्ट सबमिट करें और पूरा होने तक पोल करें। URL में anima की जगह ऊपर दिए किसी भी मॉडल को रख दें।
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
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 दिनों तक रखी जाती है।
प्रोडक्शन के लिए बना
Mage API के हर रिक्वेस्ट को क्या मिलता है
हर जेनरेशन के हिसाब से भुगतान
कोई सब्सक्रिप्शन नहीं और कोई न्यूनतम खर्च नहीं। आप Gems खरीदते हैं, और हर रिक्वेस्ट पर उसकी सूचीबद्ध कीमत लगती है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, सिवाय उसके जिसे Mage की कंटेंट पॉलिसी ने ब्लॉक किया हो।
सुरक्षित रीट्राई
Idempotency की की मदद से दोबारा भेजा गया सबमिट दोबारा चार्ज किए बिना मूल रिक्वेस्ट ही लौटाता है।
एक जैसे कैरेक्टर
कैरेक्टर या रेफ़रेंस को एक बार सेव करें, फिर किसी भी प्रॉम्प्ट में @handle लिखकर उसे हर समर्थित मॉडल के साथ इस्तेमाल करें।
बड़े इनपुट
इमेज, वीडियो और ऑडियो इनपुट URL या डेटा URL के रूप में भेजें, या साइंड अपलोड के ज़रिए 100 MB तक की फ़ाइलें अपलोड करें।
एक साथ 20 जेनरेशन
हर अकाउंट एक साथ 20 जेनरेशन चला सकता है, और आपकी ज़रूरत के हिसाब से यह सीमा बढ़ाई जा सकती है। अस्वीकृत रिक्वेस्ट पर कभी चार्ज नहीं लगता।
उपयोग के मामले
डेवलपर इमेज API से क्या बनाते हैं
प्रोडक्ट और मार्केटिंग इमेज
प्रोडक्ट शॉट, विज्ञापन के वैरिएंट और सोशल पोस्ट ज़रूरत पड़ने पर रेंडर करें, GPT Image 2.5 या Nano Banana 2 के पढ़ने लायक टेक्स्ट के साथ।
एक जैसे कैरेक्टर
एक बार कैरेक्टर सेव करें और Mango 3, Guava 2 Pro और @handle मेंशन लेने वाले दूसरे मॉडल के साथ पूरे सेट में वही चेहरा बनाए रखें।
इमेज एडिटिंग पाइपलाइन
सोर्स इमेज के साथ एक निर्देश भेजें, ताकि बस वही बदले जो आपने कहा है और बाकी सब जैसा है वैसा रहे।
ऐप्स और गेम्स
एक भी GPU होस्ट किए बिना अपने प्रोडक्ट में अवतार, स्टिकर, कार्ड और सीन जनरेट करें।
फोटोरियल पोर्ट्रेट
Guava 2 Pro पोर्ट्रेट, फैशन और लाइफस्टाइल शॉट्स को असली जैसी त्वचा, कपड़े और रोशनी के साथ रेंडर करता है।
बड़े पैमाने पर तेज़ ड्राफ्ट
Z-Image Turbo और Krea 2 बड़ी संख्या में थंबनेल और पहले ड्राफ्ट के लिए कीमतें कम रखते हैं।
अक्सर पूछे जाने वाले सवाल
अक्सर पूछे जाने वाले सवाल
सबसे अच्छा AI इमेज जनरेशन API कौन सा है?
यह काम पर निर्भर करता है। Mage पर ज़्यादातर इमेज के लिए Mango 3 डिफ़ॉल्ट है: यह सटीक निर्देशों का पालन करता है, किरदारों को एक जैसा रखता है और इमेज के बाकी हिस्से को छेड़े बिना एडिट करता है। फोटोरियलिज़्म के लिए Guava 2 Pro सबसे अच्छा है, इमेज में टेक्स्ट के लिए GPT Image 2.5 और Nano Banana 2, और तेज़, कम लागत वाले ड्राफ्ट के लिए Z-Image Turbo या Krea 2। ये सभी एक ही API से चलते हैं।
क्या इमेज API इमेज एडिटिंग और रेफ़रेंस इमेज को सपोर्ट करता है?
हाँ। इमेज स्वीकार करने वाले मॉडल उन्हें image और additional_images फ़ील्ड में URL, डेटा URL या अपलोड के रूप में लेते हैं। हर मॉडल के पेज पर उसके इनपुट और वह कितनी रेफ़रेंस इमेज लेता है, यह दिया होता है।
इमेज API कौन-कौन से रिज़ॉल्यूशन सपोर्ट करता है?
यह मॉडल पर निर्भर करता है: ज़्यादातर मॉडल पर 1K और 2K, Mango 3S पर 3K, और Mango 2 व Nano Banana 2 पर 4K तक। हर मॉडल के पेज पर उसके रिज़ॉल्यूशन और आस्पेक्ट रेशियो के विकल्प दिए होते हैं।
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 बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।