भाषण उत्पन्न करें
सफल प्रतिक्रिया बाइनरी ऑडियो है, JSON नहीं।.
इस पेज पर
https://api.shareai.now/api/v1/audio/speechभाषण उत्पन्न करें
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API कुंजी या स्वीकृत OAuth एक्सेस टोकन
- आवश्यक स्कोप
inferenceormonetization_gateway
सफल प्रतिक्रिया बाइनरी ऑडियो है, JSON नहीं। इसे सहेजें curl --output speech.mp3 या अपने SDK में प्रतिक्रिया बाइट्स पढ़ें। एक समर्थित मॉडल वॉइस और आउटपुट फॉर्मेट चुनें; गति 0.25 से 4 के बीच सीमित है। इनपुट सीमा 256 KiB है और सिंक्रोनस प्रतिक्रिया सीमा 2 MiB है।.
शुरू करने से पहले#
अपने सर्वर पर SHAREAI_API_KEY सेट करें और मॉडल प्लेसहोल्डर को वर्तमान में सक्षम मॉडल से बदलें। ब्राउज़र कोड में कभी भी API कुंजी को उजागर न करें। मॉडल, खाता, क्रेडेंशियल और प्रोवाइडर सभी को इस ऑपरेशन की अनुमति देनी चाहिए। नीचे दिए गए वैकल्पिक सेटिंग्स के लिए मॉडल समर्थन की आवश्यकता है; API सुरक्षा सीमाएँ यह वादा नहीं करतीं कि हर मॉडल हर मान का समर्थन करेगा।.
एक अनुरोध भेजें#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));अनुरोध फ़ील्ड्स#
| फ़ील्ड | प्रकार | अर्थ और सीमाएँ |
|---|---|---|
model आवश्यक | स्ट्रिंग | सटीक सक्षम सार्वजनिक मॉडल पहचानकर्ता। इस ऑपरेशन को घोषित करना चाहिए और आपके क्रेडेंशियल द्वारा अनुमत होना चाहिए।. |
input आवश्यक | स्ट्रिंग | आवश्यक गैर-खाली स्पीच टेक्स्ट, अधिकतम 256 KiB UTF-8। कैरेक्टर टैरिफ यूनिकोड कैरेक्टर गिनते हैं, न कि एन्कोडेड बाइट्स।. |
voice | स्ट्रिंग | चयनित स्पीच मॉडल द्वारा समर्थित वैकल्पिक वॉइस, अधिकतम 100 कैरेक्टर।. |
response_format | स्ट्रिंग | वैकल्पिक समर्थित ऑडियो एन्कोडिंग जैसे mp3। सफल प्रतिक्रिया बाइनरी है, JSON नहीं। अवधि-आधारित रूटिंग के लिए स्व-वर्णनात्मक MP3, WAV या FLAC की आवश्यकता होती है।. |
speed | संख्या | वैकल्पिक स्पीच गति 0.25 से 4; मॉडल संकीर्ण सीमाएँ लगा सकता है।. |
provider | ऑब्जेक्ट | वैकल्पिक प्रोवाइडर रूटिंग प्राथमिकताएँ। स्वीकृत प्रोवाइडर टैग के लिए provider.only का उपयोग करें, मॉडल ID में प्रीफिक्स के रूप में नहीं। खाता और क्रेडेंशियल प्रतिबंध अभी भी लागू होते हैं।. |
परिणाम पढ़ें#
सफलता HTTP 200 के साथ बाइनरी ऑडियो लौटाती है। सफल प्रतिक्रिया बाइनरी ऑडियो है, JSON नहीं। इसे सहेजें curl --output speech.mp3 या अपने SDK में प्रतिक्रिया बाइट्स पढ़ें। एक समर्थित मॉडल वॉइस और आउटपुट फॉर्मेट चुनें; गति 0.25 से 4 के बीच सीमित है। इनपुट सीमा 256 KiB है और सिंक्रोनस प्रतिक्रिया सीमा 2 MiB है।.
बिलिंग इकाइयाँ#
स्पीच को इनपुट कैरेक्टर, प्रोवाइडर-रिपोर्टेड टोकन या उत्पन्न सेकंड के आधार पर मूल्य निर्धारण किया जा सकता है, जो मॉडल पर निर्भर करता है। कैरेक्टर गिनती यूनिकोड कैरेक्टर का उपयोग करती है। अवधि मूल्य निर्धारण के लिए समर्थित स्व-वर्णनात्मक MP3, WAV या FLAC परिणाम की आवश्यकता होती है। एक कच्चे PCM परिणाम में अनुमानित सैंपल दर नहीं होती। टोकन-आधारित रूटिंग के लिए एक विश्वसनीय उपयोग रसीद की आवश्यकता होती है।.
Console से सटीक सक्षम मॉडल पहचानकर्ता चुनें। इसका घोषित ऑपरेशन और इनपुट/आउटपुट क्षमताएँ इस एंडपॉइंट से मेल खानी चाहिए; एक टेक्स्ट चैट मॉडल को किसी अन्य ऑपरेशन के लिए प्रतिस्थापित नहीं किया जा सकता। आपके क्रेडेंशियल, प्रोवाइडर और खाता प्रतिबंध अभी भी लागू होते हैं।.
मूल्य निर्धारण और उपयोग#
दरें चयनित मॉडल, प्रोवाइडर, इकाइयों और वेरिएंट के लिए EUR AI क्रेडिट में प्रकाशित की जाती हैं। केवल इसकी सक्रिय टैरिफ में शामिल आयामों का शुल्क लिया जाता है। एक अनुमान निष्पादन से पहले क्रेडिट आरक्षित करता है; अंतिम शुल्क मापे गए उपयोग का उपयोग करते हैं। कीमतें रिज़ॉल्यूशन, आउटपुट फॉर्मेट या उपयोग बैंड पर निर्भर हो सकती हैं। अंतिम ShareAI डेबिट के लिए Console Usage की जाँच करें। अपस्ट्रीम लागत फ़ील्ड और मीडिया बाइट्स को आविष्कृत टोकन गिनती में परिवर्तित नहीं किया जाता।.
एक्सेस और त्रुटियाँ#
उपयोग करें inference अनुमोदित नेटवर्क-लागत इन्फरेंस के लिए monetization_gateway अनुमोदित Builder मार्कअप और स्वीकृत बिलिंग शर्तों के लिए। केवल पहचान-आधारित एक्सेस खर्च को अधिकृत नहीं करता। सत्यापन, मॉडल प्राधिकरण, अपर्याप्त क्रेडिट, दर सीमाएँ और निष्पादन विफलताएँ एक संरचित error. लौटाती हैं। टाइमआउट या अनिश्चित सबमिशन के बाद, Usage या वीडियो जॉब का निरीक्षण करें इससे पहले कि आप एक और संभावित भुगतान अनुरोध बनाएँ।.
अंतिम अपडेट नवम्बर 3, 2026