ऑडियो उत्पन्न करें
ShareAI एंडपॉइंट एक सीमित JSON ऑडियो परिणाम लौटाता है।.
इस पेज पर
https://api.shareai.now/api/v1/audio/generationsऑडियो उत्पन्न करें
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API कुंजी या स्वीकृत OAuth एक्सेस टोकन
- आवश्यक स्कोप
inferenceormonetization_gateway
ShareAI एंडपॉइंट एक सीमित JSON ऑडियो परिणाम लौटाता है। ऑडियो-जनरेटिंग अनुरोधों के साथ modalities:["text","audio"] का उपयोग भी कर सकते हैं /api/v1/chat/completions. । आपका अनुरोध घोषित ऑडियो ऑपरेशन पर रूट किया जाता है। यह सिंक्रोनस प्रतिक्रिया लौटने से पहले एकत्र की जाती है; अधूरी प्रोवाइडर स्ट्रीम सफल बिल्ड परिणाम नहीं बनती हैं। ऑडियो आउटपुट फॉर्मेट mp3, wav, flac, pcm16 या pcm24 हैं, जो मॉडल पर निर्भर करते हैं। रॉ PCM अवधि शुल्क का समर्थन नहीं कर सकता। जनरेट किए गए टोकन को सीमित करने के लिए या तो max_tokens या max_completion_tokens सेट करें; दोनों को न दें।.
शुरू करने से पहले#
अपने सर्वर पर SHAREAI_API_KEY सेट करें और मॉडल प्लेसहोल्डर को वर्तमान में सक्षम मॉडल से बदलें। ब्राउज़र कोड में कभी भी API कुंजी को उजागर न करें। मॉडल, खाता, क्रेडेंशियल और प्रोवाइडर सभी को इस ऑपरेशन की अनुमति देनी चाहिए। नीचे दिए गए वैकल्पिक सेटिंग्स के लिए मॉडल समर्थन की आवश्यकता है; API सुरक्षा सीमाएँ यह वादा नहीं करतीं कि हर मॉडल हर मान का समर्थन करेगा।.
एक अनुरोध भेजें#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);अनुरोध फ़ील्ड्स#
| फ़ील्ड | प्रकार | अर्थ और सीमाएँ |
|---|---|---|
model आवश्यक | स्ट्रिंग | सटीक सक्षम सार्वजनिक मॉडल पहचानकर्ता। इस ऑपरेशन को घोषित करना चाहिए और आपके क्रेडेंशियल द्वारा अनुमत होना चाहिए।. |
messages आवश्यक | ऐरे | 1–256 बातचीत संदेश भूमिका/सामग्री के साथ। केवल चयनित ऑडियो मॉडल द्वारा समर्थित सामग्री मोडालिटी का उपयोग करें।. |
modalities | ऐरे | टेक्स्ट और ऑडियो से एक या दो अद्वितीय मान; ऑडियो आवश्यक है। डिफ़ॉल्ट ऑडियो है। यह सिंक्रोनस एंडपॉइंट स्ट्रीम स्वीकार नहीं करता।. |
audio | ऑब्जेक्ट | वैकल्पिक आउटपुट विकल्प: केवल वॉयस और फॉर्मेट। फॉर्मेट mp3, wav, flac, pcm16 या pcm24 है, जो मॉडल समर्थन पर निर्भर करता है। रॉ PCM अवधि शुल्क के साथ असंगत है।. |
temperature | संख्या | वैकल्पिक मॉडल-समर्थित जनरेशन तापमान।. |
top_p | संख्या | वैकल्पिक मॉडल-समर्थित न्यूक्लियस सैंपलिंग मान।. |
max_tokens | पूर्णांक | वैकल्पिक आउटपुट-टोकन सीमा, 1–262144। इसे max_completion_tokens के साथ संयोजित न करें।. |
max_completion_tokens | पूर्णांक | वैकल्पिक आउटपुट-टोकन सीमा, 1–262144। इसे max_tokens के साथ संयोजित न करें।. |
provider | ऑब्जेक्ट | वैकल्पिक प्रोवाइडर रूटिंग प्राथमिकताएँ। स्वीकृत प्रोवाइडर टैग के लिए provider.only का उपयोग करें, मॉडल ID में प्रीफिक्स के रूप में नहीं। खाता और क्रेडेंशियल प्रतिबंध अभी भी लागू होते हैं।. |
परिणाम पढ़ें#
सफलता HTTP 200 के साथ JSON लौटाती है। ShareAI एंडपॉइंट एक सीमित JSON ऑडियो परिणाम लौटाता है। ऑडियो-जनरेटिंग अनुरोधों के साथ modalities:["text","audio"] का उपयोग भी कर सकते हैं /api/v1/chat/completions. । आपका अनुरोध घोषित ऑडियो ऑपरेशन पर रूट किया जाता है। यह सिंक्रोनस प्रतिक्रिया लौटने से पहले एकत्र की जाती है; अधूरी प्रोवाइडर स्ट्रीम सफल बिल्ड परिणाम नहीं बनती हैं। ऑडियो आउटपुट फॉर्मेट mp3, wav, flac, pcm16 या pcm24 हैं, जो मॉडल पर निर्भर करते हैं। रॉ PCM अवधि शुल्क का समर्थन नहीं कर सकता। जनरेट किए गए टोकन को सीमित करने के लिए या तो max_tokens या max_completion_tokens सेट करें; दोनों को न दें।.
बिलिंग इकाइयाँ#
ऑडियो मॉडल अलग-अलग टेक्स्ट-टोकन और ऑडियो-टोकन आयाम, अवधि, गाना या अनुरोध दरें प्रकाशित कर सकते हैं। समावेशी टोकन कुल को असंबद्ध टेक्स्ट/ऑडियो काउंटर्स में विभाजित किया जाता है; वही ऑडियो टोकन कभी भी टेक्स्ट के रूप में फिर से चार्ज नहीं किए जाते। असमर्थित या गायब उपयोग को एन्कोडेड बाइट्स से अनुमानित नहीं किया जाता।.
Console से सटीक सक्षम मॉडल पहचानकर्ता चुनें। इसका घोषित ऑपरेशन और इनपुट/आउटपुट क्षमताएँ इस एंडपॉइंट से मेल खानी चाहिए; एक टेक्स्ट चैट मॉडल को किसी अन्य ऑपरेशन के लिए प्रतिस्थापित नहीं किया जा सकता। आपके क्रेडेंशियल, प्रोवाइडर और खाता प्रतिबंध अभी भी लागू होते हैं।.
मूल्य निर्धारण और उपयोग#
दरें चयनित मॉडल, प्रोवाइडर, इकाइयों और वेरिएंट के लिए EUR AI क्रेडिट में प्रकाशित की जाती हैं। केवल इसकी सक्रिय टैरिफ में शामिल आयामों का शुल्क लिया जाता है। एक अनुमान निष्पादन से पहले क्रेडिट आरक्षित करता है; अंतिम शुल्क मापे गए उपयोग का उपयोग करते हैं। कीमतें रिज़ॉल्यूशन, आउटपुट फॉर्मेट या उपयोग बैंड पर निर्भर हो सकती हैं। अंतिम ShareAI डेबिट के लिए Console Usage की जाँच करें। अपस्ट्रीम लागत फ़ील्ड और मीडिया बाइट्स को आविष्कृत टोकन गिनती में परिवर्तित नहीं किया जाता।.
एक्सेस और त्रुटियाँ#
उपयोग करें inference अनुमोदित नेटवर्क-लागत इन्फरेंस के लिए monetization_gateway अनुमोदित Builder मार्कअप और स्वीकृत बिलिंग शर्तों के लिए। केवल पहचान-आधारित एक्सेस खर्च को अधिकृत नहीं करता। सत्यापन, मॉडल प्राधिकरण, अपर्याप्त क्रेडिट, दर सीमाएँ और निष्पादन विफलताएँ एक संरचित error. लौटाती हैं। टाइमआउट या अनिश्चित सबमिशन के बाद, Usage या वीडियो जॉब का निरीक्षण करें इससे पहले कि आप एक और संभावित भुगतान अनुरोध बनाएँ।.
अंतिम अपडेट नवम्बर 3, 2026