सीधे कंटेंट पर जाएँ

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 MusicElevenLabs के गाने, वोकल्स के साथ या उनके बिनाeleven-music-v2.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4: असली जैसी आवाज़, जिसे आप डायरेक्ट कर सकते हैंeleven-v430 Gems ($0.03)
MiniMax Music 3आपके लिरिक्स से पूरे गाने, ओपन वेट्सminimax-music-3125 Gems ($0.125)
Seed Audioएक ही प्रॉम्प्ट से वॉइस, म्यूज़िक और साउंड इफ़ेक्टseed-audio-1.019 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 की से तैयार मीडिया तक, सिर्फ तीन कॉल में

हर मॉडल में एक ही ऑथेंटिकेशन स्कीम, एक ही एसिंक्रोनस रिक्वेस्ट लाइफ़साइकल और एक जैसे फ़ील्ड नाम हैं।

  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 के हर रिक्वेस्ट को क्या मिलता है

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

    एक 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 टेक्स्ट-टू-स्पीच कर सकती है?
हाँ। Seed Audio किसी बताई गई आवाज़ में, या सेव किए गए वॉइस रेफ़रेंस में स्क्रिप्ट पढ़ती है, और स्पीच रेट, लाउडनेस व पिच सेटिंग देती है। यह उसी प्रॉम्प्ट फ़ील्ड से म्यूज़िक और साउंड इफ़ेक्ट भी बनाती है।
जनरेट किया गया ऑडियो कितना लंबा हो सकता है?
Seed Audio 120 सेकंड तक की क्लिप बनाती है।
Mage API की कीमत कितनी है?
इसमें कोई सब्सक्रिप्शन या मासिक शुल्क नहीं है। हर जेनरेशन का भुगतान Gems में उस मॉडल की सूचीबद्ध कीमत पर होता है, और स्टैंडर्ड पैक में 1,000 Gems की कीमत $1 है। हर मॉडल पेज पर उसकी डिफ़ॉल्ट सेटिंग की कीमत दी गई है, और हर रिस्पॉन्स में सटीक चार्ज बताया जाता है। फ़ेल हुई जेनरेशन का रिफ़ंड मिलता है, लेकिन जिसे Mage की कंटेंट पॉलिसी ब्लॉक करे उसका नहीं। जो रिक्वेस्ट आपका बैलेंस कवर न कर सके, उसे कोई चार्ज लगने से पहले ही अस्वीकार कर दिया जाता है।
क्या API इस्तेमाल करने के लिए मुझे Mage मेंबरशिप चाहिए?
नहीं। API सिर्फ़ Gems से चलती है। मेंबरशिप प्लान और उनके साथ मिलने वाला अनलिमिटेड इन-ऐप जनरेशन API रिक्वेस्ट पर लागू नहीं होता। इसके लिए अकाउंट में पहले एक सफल पेमेंट होना ज़रूरी है, चाहे वह किसी भी Gem पैक या प्लान का हो। साइनअप बोनस 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 बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।

Charactersकम्युनिटी