Mage API · वीडियो जनरेशन

AI वीडियो जनरेशन API, टेक्स्ट या इमेज से

12 मॉडल से टेक्स्ट-टू-वीडियो, इमेज-टू-वीडियो, पहले-और-आखिरी-फ्रेम और रेफ़रेंस-टू-वीडियो, जिनमें Mage का फ़्लैगशिप Cherry 2 Pro सबसे आगे है, और कई क्लिप में ऑडियो के साथ।

API की पाएंAPI डॉक्स पढ़ें
POST https://api.mage.space/v1/{model}/generate

एक नज़र में

Mage वीडियो जनरेशन API https://api.mage.space/v1 पर एक REST API है, जो Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video और Wan समेत 12 टेक्स्ट-टू-वीडियो और इमेज-टू-वीडियो मॉडल चलाता है। प्रॉम्प्ट और वैकल्पिक फ्रेम या रेफ़रेंस सबमिट करें, रिक्वेस्ट को पोल करें और MP4 डाउनलोड करें। हर क्लिप का भुगतान मॉडल, रिज़ॉल्यूशन और अवधि के हिसाब से Gems में होता है।

मॉडल

Mage API के सभी वीडियो मॉडल

कीमतें प्रति जनरेशन, Gems में हैं। स्टैंडर्ड पैक पर 1,000 Gems की कीमत $1 है, और बड़े पैक में बोनस Gems मिलते हैं। कीमत मॉडल, रिज़ॉल्यूशन और अवधि पर निर्भर करती है; यहाँ डिफ़ॉल्ट सेटिंग की कीमत दिखाई गई है, और हर रिस्पॉन्स में सटीक शुल्क billing.gems_charged में बताया जाता है। जो जनरेशन फ़ेल होता है उसके Gems लौटा दिए जाते हैं; जिसे Mage की कंटेंट पॉलिसी ब्लॉक करती है, उसके नहीं।

मॉडलइनके लिए सबसे अच्छाmodel_id मानडिफ़ॉल्ट कीमत
Berryऐसा वीडियो जो आपके रेफ़रेंस के प्रति सच्चा रहेberry, berry-2189 Gems ($0.189)
Blueberryपहला और आखिरी फ्रेम तय करेंblueberry, blueberry-v2360 Gems ($0.36)
Cherryहमारी फ़्लैगशिप वीडियो फ़ैमिलीcherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine, मोशन मेंgrok-imagine-video375 Gems ($0.375)
Kiwiरोज़मर्रा के वीडियो, बिना किसी सेटअप केkiwi270 Gems ($0.27)
Lemonवीडियो के सारे फ़ीचर, बेहतर कीमत परlemon245 Gems ($0.245)
LTX Videoइटरेशन के लिए तेज़ ओपन-वेट्स वीडियोltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
Melonमोशन में एनीमे, वैकल्पिक ऑडियो के साथmelon, melon-pro147 Gems ($0.147)
MiniMax-H3स्टीरियो साउंड के साथ तेज़ ओपन वीडियोminimax-h3-turbo, minimax-h330 Gems ($0.03)
Plumहर क्लिप में साउंड, 2K तकplum, plum-max338 Gems ($0.338)
Raspberryपहले फ्रेम से जीवित होते किरदारraspberry360 Gems ($0.36)
Wan Video v2.2Lightning वेरिएंट वाला ओपन-वेट्स वीडियोwan22-video, wan22-video-lightning40 Gems ($0.04)

क्विक स्टार्ट

Berry 2 से वीडियो जनरेट करें

MAGE_API_KEY सेट करें, रिक्वेस्ट सबमिट करें और पूरा होने तक पोल करें। URL में berry की जगह ऊपर दिए किसी भी मॉडल को रखें।

cURL
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"
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('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);
Python
# 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"])

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

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 दिनों तक रखी जाती है।

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

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

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

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

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

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

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

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

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

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

बड़े इनपुट

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

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

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

उपयोग के मामले

डेवलपर वीडियो API से क्या बनाते हैं

शॉर्ट-फ़ॉर्म और सोशल वीडियो

एक प्रॉम्प्ट या प्रोडक्ट इमेज से TikTok, Reels और Shorts के लिए वर्टिकल क्लिप बनाएँ।

स्टिल इमेज को एनिमेट करें

Lemon और Kiwi जैसे इमेज-टू-वीडियो मॉडल से एक पहले फ्रेम, या पहले और आखिरी फ्रेम को मोशन में बदलें।

किरदारों पर आधारित कहानियाँ

@handle किरदार लेने वाले रेफ़रेंस-टू-वीडियो मॉडल से सभी शॉट्स में एक ही किरदार बनाए रखें।

साउंड वाला वीडियो

Plum और अन्य मॉडल तस्वीर के साथ स्पीच, साउंड इफ़ेक्ट और माहौल की आवाज़ें जनरेट करते हैं, और आवाज़ों के लिए ऑडियो रेफ़रेंस भी लेते हैं।

विज्ञापन और प्रोडक्ट डेमो

किसी विज्ञापन के कई वैरिएंट जनरेट करें और सबसे अच्छा चुनें, आइडेम्पोटेंट सबमिट के साथ जो कभी दोबारा चार्ज नहीं करते।

मौजूदा क्लिप एडिट करें

Berry, Plum और Grok Video आपके भेजे सोर्स वीडियो को एडिट करते हैं; Lemon और MiniMax-H3 रेफ़रेंस वीडियो भी लेते हैं।

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

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

सबसे अच्छा AI वीडियो जनरेशन API कौन सा है?

Mage पर वीडियो के लिए Cherry 2 Pro डिफ़ॉल्ट है: यह किरदार, कई रेफ़रेंस इमेज, ऑडियो रेफ़रेंस, 480p से 1080p आउटपुट और 30 सेकंड तक की क्लिप सपोर्ट करता है। पहले-और-आखिरी फ्रेम के नियंत्रण के लिए Lemon चुनें, 2K तक जनरेट किए गए साउंड वाली क्लिप के लिए Plum, और सस्ते ड्राफ्ट के लिए Cherry Mini या Wan।

क्या वीडियो API इमेज-टू-वीडियो को सपोर्ट करता है?

हाँ। इमेज-टू-वीडियो मॉडल पहला फ्रेम लेते हैं, और कुछ आखिरी फ्रेम या रेफ़रेंस इमेज भी लेते हैं, URL, डेटा URL या अपलोड के रूप में। हर मॉडल के पेज पर उसके इनपुट और इमेज ज़रूरी है या नहीं, यह दिया होता है।

जनरेट किए गए वीडियो कितने लंबे हो सकते हैं?

यह मॉडल और रिज़ॉल्यूशन पर निर्भर करता है। कई मॉडल 4 से 15 सेकंड के वीडियो जनरेट करते हैं, और Cherry 2 Pro 20, 25 और 30 सेकंड तक जाता है। हर मॉडल के पेज पर उसकी अवधि दी होती है।

वीडियो जनरेट होने में कितना समय लगता है?

यह मॉडल, रिज़ॉल्यूशन और अवधि पर निर्भर करता है। API एसिंक्रोनस है: सबमिट करें, फिर बैकऑफ़ के साथ status_url को पोल करें, या अपने MCP क्लाइंट को get_request से इंतज़ार करने दें।

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 बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।

API की पाएंAPI डॉक्स पढ़ें

संबंधित