Mage API · ऑडियो जनरेशन
वॉइस, म्यूज़िक और साउंड के लिए AI ऑडियो जनरेशन API
Seed Audio से एक ही प्रॉम्प्ट में स्पीच, नैरेशन, म्यूज़िक और साउंड इफ़ेक्ट पाएँ, साथ में वॉइस रेफ़रेंस और स्पीच, लाउडनेस व पिच कंट्रोल।
POST https://api.mage.space/v1/{model}/generateएक नज़र में
Mage ऑडियो जनरेशन API, https://api.mage.space/v1/seed_audio/generate पर Seed Audio चलाती है। टेक्स्ट प्रॉम्प्ट भेजें, चाहें तो वॉइस रेफ़रेंस या इमेज के साथ, और वॉइस, म्यूज़िक या साउंड इफ़ेक्ट वाली 120 सेकंड तक की ऑडियो फ़ाइल पाएँ। हर क्लिप का भुगतान Gems में होता है, कोई सब्सक्रिप्शन नहीं।
- 4ऑडियो मॉडल
- $0.019सबसे सस्ता डिफ़ॉल्ट, प्रति क्लिप
- 20एक साथ जनरेशन
- $0मासिक शुल्क
मॉडल
Mage API के सभी ऑडियो मॉडल
कीमतें प्रति जनरेशन, Gems में हैं। स्टैंडर्ड पैक पर 1,000 Gems की कीमत $1 है, और बड़े पैक में बोनस Gems मिलते हैं। कीमत मॉडल, रिज़ॉल्यूशन और अवधि पर निर्भर करती है; यहाँ डिफ़ॉल्ट सेटिंग की कीमत दिखाई गई है, और हर रिस्पॉन्स में सटीक शुल्क billing.gems_charged में बताया जाता है। जो जनरेशन फ़ेल होता है उसके Gems लौटा दिए जाते हैं; जिसे Mage की कंटेंट पॉलिसी ब्लॉक करती है, उसके नहीं।
| मॉडल | इनके लिए सबसे अच्छा | model_id मान | डिफ़ॉल्ट कीमत |
|---|---|---|---|
| Eleven Music | ElevenLabs के गाने, वोकल्स के साथ या उनके बिना | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: असली जैसी आवाज़, जिसे आप डायरेक्ट कर सकते हैं | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | आपके लिरिक्स से पूरे गाने, ओपन वेट्स | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | एक ही प्रॉम्प्ट से वॉइस, म्यूज़िक और साउंड इफ़ेक्ट | seed-audio-1.0 | 19 Gems ($0.019) |
क्विक स्टार्ट
Eleven Music v2.5 से ऑडियो जनरेट करें
MAGE_API_KEY सेट करें, रिक्वेस्ट सबमिट करें और पूरी होने तक पोल करें। URL में eleven_music की जगह ऊपर दिए किसी भी मॉडल को लगाएं।
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
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 से क्या बनाते हैं
नैरेशन और वॉइसओवर
वीडियो, एक्सप्लेनर और ऑडियोबुक के लिए नैरेशन बनाएँ, साथ में स्पीच रेट, लाउडनेस और पिच कंट्रोल।
एक जैसी आवाज़ें
वॉइस क्लिप को रेफ़रेंस के रूप में सेव करें और @handle से उसका ज़िक्र करें, ताकि सभी क्लिप में एक ही आवाज़ रहे।
साउंड इफ़ेक्ट
गेम और ऐप के लिए सिर्फ़ विवरण से एम्बिएंस, फ़ॉली और UI साउंड बनाएँ।
बैकग्राउंड म्यूज़िक
प्रॉम्प्ट से सोशल क्लिप और विज्ञापनों के लिए बैकग्राउंड म्यूज़िक बनाएँ।
जनरेट किए गए वीडियो के लिए साउंडट्रैक
Seed Audio को वीडियो API के साथ जोड़ें और बिना आवाज़ वाले मॉडल की क्लिप में साउंड जोड़ें।
बोलने वाले एजेंट
Claude, ChatGPT या अपने खुद के एजेंट से MCP सर्वर या REST API के ज़रिए ऑडियो बनवाएँ।
अक्सर पूछे जाने वाले सवाल
अक्सर पूछे जाने वाले सवाल
क्या ऑडियो API टेक्स्ट-टू-स्पीच कर सकती है?
जनरेट किया गया ऑडियो कितना लंबा हो सकता है?
Mage API की कीमत कितनी है?
क्या API इस्तेमाल करने के लिए मुझे Mage मेंबरशिप चाहिए?
क्या मैं API के आउटपुट का व्यावसायिक उपयोग कर सकता/सकती हूँ?
रेट लिमिट क्या हैं?
क्या मेरा AI एजेंट Mage API इस्तेमाल कर सकता है?
क्या Mage API के लिए कोई SDK है?
मेरे पास पहले से कोई दूसरी जनरेशन API है। मुझे क्या बदलना होगा?
Mage के साथ बनाना शुरू करें
एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।