एक की, सारे मॉडल
28 इमेज, वीडियो और ऑडियो मॉडल, एक REST API और एक Gems बैलेंस के साथ। बस URL पाथ बदलकर मॉडल बदलें।
एक नज़र में
Mage वीडियो जनरेशन API https://api.mage.space/v1 पर एक REST API है, जो Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video और Wan समेत 12 टेक्स्ट-टू-वीडियो और इमेज-टू-वीडियो मॉडल चलाता है। प्रॉम्प्ट और वैकल्पिक फ्रेम या रेफ़रेंस सबमिट करें, रिक्वेस्ट को पोल करें और MP4 डाउनलोड करें। हर क्लिप का भुगतान मॉडल, रिज़ॉल्यूशन और अवधि के हिसाब से Gems में होता है।
12
वीडियो मॉडल
$0.02
सबसे सस्ता डिफ़ॉल्ट, प्रति क्लिप
20
एक साथ जनरेशन
$0
मासिक शुल्क
मॉडल
कीमतें प्रति जनरेशन, Gems में हैं। स्टैंडर्ड पैक पर 1,000 Gems की कीमत $1 है, और बड़े पैक में बोनस Gems मिलते हैं। कीमत मॉडल, रिज़ॉल्यूशन और अवधि पर निर्भर करती है; यहाँ डिफ़ॉल्ट सेटिंग की कीमत दिखाई गई है, और हर रिस्पॉन्स में सटीक शुल्क billing.gems_charged में बताया जाता है। जो जनरेशन फ़ेल होता है उसके Gems लौटा दिए जाते हैं; जिसे Mage की कंटेंट पॉलिसी ब्लॉक करती है, उसके नहीं।
| मॉडल | इनके लिए सबसे अच्छा | model_id मान | डिफ़ॉल्ट कीमत |
|---|---|---|---|
| Berry | ऐसा वीडियो जो आपके रेफ़रेंस के प्रति सच्चा रहे | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | पहला और आखिरी फ्रेम तय करें | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | हमारी फ़्लैगशिप वीडियो फ़ैमिली | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, मोशन में | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | रोज़मर्रा के वीडियो, बिना किसी सेटअप के | kiwi | 270 Gems ($0.27) |
| Lemon | वीडियो के सारे फ़ीचर, बेहतर कीमत पर | lemon | 245 Gems ($0.245) |
| LTX Video | इटरेशन के लिए तेज़ ओपन-वेट्स वीडियो | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | मोशन में एनीमे, वैकल्पिक ऑडियो के साथ | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | स्टीरियो साउंड के साथ तेज़ ओपन वीडियो | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | हर क्लिप में साउंड, 2K तक | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | पहले फ्रेम से जीवित होते किरदार | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Lightning वेरिएंट वाला ओपन-वेट्स वीडियो | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
क्विक स्टार्ट
MAGE_API_KEY सेट करें, रिक्वेस्ट सबमिट करें और पूरा होने तक पोल करें। URL में berry की जगह ऊपर दिए किसी भी मॉडल को रखें।
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])यह कैसे काम करता है
हर मॉडल में एक ही ऑथेंटिकेशन स्कीम, एक ही एसिंक्रोनस रिक्वेस्ट लाइफ़साइकल और एक जैसे फ़ील्ड नाम हैं।
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 दिनों तक रखी जाती है।
प्रोडक्शन के लिए बना
28 इमेज, वीडियो और ऑडियो मॉडल, एक REST API और एक Gems बैलेंस के साथ। बस URL पाथ बदलकर मॉडल बदलें।
कोई सब्सक्रिप्शन नहीं और कोई न्यूनतम खर्च नहीं। आप Gems खरीदते हैं, और हर रिक्वेस्ट पर उसकी सूचीबद्ध कीमत लगती है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, सिवाय उसके जिसे Mage की कंटेंट पॉलिसी ने ब्लॉक किया हो।
Idempotency की की मदद से दोबारा भेजा गया सबमिट दोबारा चार्ज किए बिना मूल रिक्वेस्ट ही लौटाता है।
कैरेक्टर या रेफ़रेंस को एक बार सेव करें, फिर किसी भी प्रॉम्प्ट में @handle लिखकर उसे हर समर्थित मॉडल के साथ इस्तेमाल करें।
इमेज, वीडियो और ऑडियो इनपुट URL या डेटा URL के रूप में भेजें, या साइंड अपलोड के ज़रिए 100 MB तक की फ़ाइलें अपलोड करें।
हर अकाउंट एक साथ 20 जेनरेशन चला सकता है, और आपकी ज़रूरत के हिसाब से यह सीमा बढ़ाई जा सकती है। अस्वीकृत रिक्वेस्ट पर कभी चार्ज नहीं लगता।
उपयोग के मामले
एक प्रॉम्प्ट या प्रोडक्ट इमेज से TikTok, Reels और Shorts के लिए वर्टिकल क्लिप बनाएँ।
Lemon और Kiwi जैसे इमेज-टू-वीडियो मॉडल से एक पहले फ्रेम, या पहले और आखिरी फ्रेम को मोशन में बदलें।
@handle किरदार लेने वाले रेफ़रेंस-टू-वीडियो मॉडल से सभी शॉट्स में एक ही किरदार बनाए रखें।
Plum और अन्य मॉडल तस्वीर के साथ स्पीच, साउंड इफ़ेक्ट और माहौल की आवाज़ें जनरेट करते हैं, और आवाज़ों के लिए ऑडियो रेफ़रेंस भी लेते हैं।
किसी विज्ञापन के कई वैरिएंट जनरेट करें और सबसे अच्छा चुनें, आइडेम्पोटेंट सबमिट के साथ जो कभी दोबारा चार्ज नहीं करते।
Berry, Plum और Grok Video आपके भेजे सोर्स वीडियो को एडिट करते हैं; Lemon और MiniMax-H3 रेफ़रेंस वीडियो भी लेते हैं।
अक्सर पूछे जाने वाले सवाल
Mage पर वीडियो के लिए Cherry 2 Pro डिफ़ॉल्ट है: यह किरदार, कई रेफ़रेंस इमेज, ऑडियो रेफ़रेंस, 480p से 1080p आउटपुट और 30 सेकंड तक की क्लिप सपोर्ट करता है। पहले-और-आखिरी फ्रेम के नियंत्रण के लिए Lemon चुनें, 2K तक जनरेट किए गए साउंड वाली क्लिप के लिए Plum, और सस्ते ड्राफ्ट के लिए Cherry Mini या Wan।
हाँ। इमेज-टू-वीडियो मॉडल पहला फ्रेम लेते हैं, और कुछ आखिरी फ्रेम या रेफ़रेंस इमेज भी लेते हैं, URL, डेटा URL या अपलोड के रूप में। हर मॉडल के पेज पर उसके इनपुट और इमेज ज़रूरी है या नहीं, यह दिया होता है।
यह मॉडल और रिज़ॉल्यूशन पर निर्भर करता है। कई मॉडल 4 से 15 सेकंड के वीडियो जनरेट करते हैं, और Cherry 2 Pro 20, 25 और 30 सेकंड तक जाता है। हर मॉडल के पेज पर उसकी अवधि दी होती है।
यह मॉडल, रिज़ॉल्यूशन और अवधि पर निर्भर करता है। API एसिंक्रोनस है: सबमिट करें, फिर बैकऑफ़ के साथ status_url को पोल करें, या अपने MCP क्लाइंट को get_request से इंतज़ार करने दें।
इसमें कोई सब्सक्रिप्शन या मासिक शुल्क नहीं है। हर जेनरेशन का भुगतान Gems में उस मॉडल की सूचीबद्ध कीमत पर होता है, और स्टैंडर्ड पैक में 1,000 Gems की कीमत $1 है। हर मॉडल पेज पर उसकी डिफ़ॉल्ट सेटिंग की कीमत दी गई है, और हर रिस्पॉन्स में सटीक चार्ज बताया जाता है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, लेकिन जिसे Mage की कंटेंट पॉलिसी ब्लॉक करे उसका नहीं। जो रिक्वेस्ट आपका बैलेंस कवर न कर सके, उसे कोई चार्ज लगने से पहले ही अस्वीकार कर दिया जाता है।
नहीं। API सिर्फ़ Gems से चलता है। मेंबरशिप प्लान और उनकी ऐप में अनलिमिटेड जेनरेशन API रिक्वेस्ट पर लागू नहीं होतीं, इसलिए Gems वाला कोई भी Mage अकाउंट इसे इस्तेमाल कर सकता है।
हाँ। Mage से बनाया गया कंटेंट, API और MCP server के ज़रिए बनाया गया कंटेंट भी, व्यावसायिक रूप से इस्तेमाल किया जा सकता है। क्रेडिट देना अच्छा लगेगा, लेकिन ज़रूरी नहीं है।
एक अकाउंट में एक समय पर 20 जनरेशन कतार में या चल रहे हो सकते हैं। इससे ज़्यादा सबमिट करने पर 429 के साथ अस्वीकार हो जाता है और कोई शुल्क नहीं लगता। अपने उपयोग के लिए सीमा बढ़वाने हेतु [email protected] पर लिखें।
हाँ। एजेंट key के साथ REST API कॉल कर सकते हैं, या Mage MCP server से जुड़ सकते हैं, जो Claude, ChatGPT, Claude Code, Grok और Cursor को मॉडल चुनने, कीमत जानने, जनरेट करने और नतीजा पाने के लिए सोलह तैयार टूल देता है। देखें MCP server।
हाँ। npm पर आधिकारिक @mage-space/sdk पैकेज और PyPI पर mage-space ओपन सोर्स हैं और हर मॉडल के लिए टाइप्ड हैं। ये आपके लिए सबमिट करते हैं, नतीजे का इंतज़ार करते हैं, सुरक्षित तरीके से रीट्राई करते हैं और फ़ाइलें अपलोड करते हैं। ComfyUI यूज़र comfyui-mage नोड पैक इंस्टॉल कर सकते हैं। देखें Mage SDKs।
अपने क्लाइंट को https://api.mage.space/v1 पर पॉइंट करें, अपनी Mage key को Bearer टोकन के रूप में भेजें, और अपने फ़ील्ड मॉडल पेज से मैप करें: prompt, aspect_ratio, resolution, duration और model_id हर Mage मॉडल में एक जैसे काम करते हैं। रिक्वेस्ट एसिंक्रोनस होती हैं, इसलिए सबमिट करें और फिर status_url को पोल करें।
एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।