Mage API · इमेज जनरेशन
हर मॉडल के लिए AI इमेज जनरेशन API
Mage के फ़्लैगशिप Mango 4 समेत 18 मॉडल से टेक्स्ट से इमेज, इमेज एडिटिंग और एक जैसे कैरेक्टर, एक की और एक बैलेंस के साथ।
POST https://api.mage.space/v1/{model}/generateएक नज़र में
Mage इमेज जनरेशन API https://api.mage.space/v1 पर मौजूद एक REST API है, जो टेक्स्ट से इमेज और इमेज एडिटिंग के 18 मॉडल चलाती है, जिनमें Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 और Krea 2 शामिल हैं। आप /{model}/generate पर प्रॉम्प्ट POST करते हैं, रिक्वेस्ट को पोल करते हैं और इमेज डाउनलोड करते हैं। हर इमेज का भुगतान Gems में होता है, कोई सब्सक्रिप्शन नहीं।
- 18इमेज मॉडल
- $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, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, दो टियर में | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| 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, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | नेटिव 16-मेगापिक्सल इमेज, ओपन वेट्स | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | लंबे प्रॉम्प्ट और दो भाषाओं में टेक्स्ट, ओपन वेट्स | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | साफ़, पढ़ने लायक टेक्स्ट, 4K तक | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL, जिसमें चेहरे और हाथ ठीक किए गए हैं | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, सख़्त फ़िल्टर के साथ | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| 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 के हर रिक्वेस्ट को क्या मिलता है
एक की, सारे मॉडल
एक REST API और एक Gems बैलेंस के पीछे 37 इमेज, वीडियो और ऑडियो मॉडल। बस URL पाथ बदलकर मॉडल बदलें।
हर जेनरेशन के हिसाब से भुगतान
कोई सब्सक्रिप्शन नहीं और कोई न्यूनतम खर्च नहीं। आप Gems खरीदते हैं, और हर रिक्वेस्ट पर उसकी सूचीबद्ध कीमत लगती है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, सिवाय उसके जिसे Mage की कंटेंट पॉलिसी ने ब्लॉक किया हो।
सुरक्षित रीट्राई
Idempotency की की मदद से दोबारा भेजा गया सबमिट दोबारा चार्ज किए बिना मूल रिक्वेस्ट ही लौटाता है।
एक जैसे कैरेक्टर
कैरेक्टर या रेफ़रेंस को एक बार सेव करें, फिर किसी भी प्रॉम्प्ट में @handle लिखकर उसे हर समर्थित मॉडल के साथ इस्तेमाल करें।
बड़े इनपुट
इमेज, वीडियो और ऑडियो इनपुट URL या डेटा URL के रूप में भेजें, या साइंड अपलोड के ज़रिए 100 MB तक की फ़ाइलें अपलोड करें।
एक साथ 20 जेनरेशन
हर अकाउंट एक साथ 20 जेनरेशन चला सकता है, और आपकी ज़रूरत के हिसाब से यह सीमा बढ़ाई जा सकती है। अस्वीकृत रिक्वेस्ट पर कभी चार्ज नहीं लगता।
उपयोग के मामले
डेवलपर इमेज API से क्या बनाते हैं
प्रोडक्ट और मार्केटिंग इमेज
प्रोडक्ट शॉट, विज्ञापन के अलग-अलग वर्शन और सोशल पोस्ट ज़रूरत के हिसाब से बनाएं, GPT Image 2.6 या Nano Banana 2 से साफ़ पढ़े जाने वाले टेक्स्ट के साथ।
एक जैसे कैरेक्टर
कैरेक्टर को एक बार सेव करें और Mango 4, Guava 2 Pro और @handle मेंशन लेने वाले दूसरे मॉडल के साथ पूरे सेट में एक ही चेहरा बनाए रखें।
इमेज एडिटिंग पाइपलाइन
सोर्स इमेज के साथ एक निर्देश भेजें, ताकि बस वही बदले जो आपने कहा है और बाकी सब जैसा है वैसा रहे।
ऐप्स और गेम्स
एक भी GPU होस्ट किए बिना अपने प्रोडक्ट में अवतार, स्टिकर, कार्ड और सीन जनरेट करें।
फोटोरियल पोर्ट्रेट
Guava 2 Pro पोर्ट्रेट, फैशन और लाइफस्टाइल शॉट्स को असली जैसी त्वचा, कपड़े और रोशनी के साथ रेंडर करता है।
बड़े पैमाने पर तेज़ ड्राफ्ट
Z-Image Turbo और Krea 2 बड़ी संख्या में थंबनेल और पहले ड्राफ्ट के लिए कीमतें कम रखते हैं।
अक्सर पूछे जाने वाले सवाल
अक्सर पूछे जाने वाले सवाल
सबसे अच्छा AI इमेज जनरेशन API कौन सा है?
क्या इमेज API इमेज एडिटिंग और रेफ़रेंस इमेज को सपोर्ट करता है?
इमेज API कौन-कौन से रिज़ॉल्यूशन सपोर्ट करता है?
Mage API की कीमत कितनी है?
क्या API इस्तेमाल करने के लिए मुझे Mage मेंबरशिप चाहिए?
क्या मैं API के आउटपुट का व्यावसायिक उपयोग कर सकता/सकती हूँ?
रेट लिमिट क्या हैं?
क्या मेरा AI एजेंट Mage API इस्तेमाल कर सकता है?
क्या Mage API के लिए कोई SDK है?
मेरे पास पहले से कोई दूसरी जनरेशन API है। मुझे क्या बदलना होगा?
Mage के साथ बनाना शुरू करें
एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।