भाषण तयार करा
यशस्वी प्रतिसाद बायनरी ऑडिओ आहे, 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. वर्ण शुल्क Unicode वर्ण मोजतात, एन्कोड केलेल्या बाइट्स नाहीत. |
voice | स्ट्रिंग | निवडलेल्या भाषण मॉडेलद्वारे समर्थित ऐच्छिक आवाज, जास्तीत जास्त 100 वर्ण. |
response_format | स्ट्रिंग | mp3 सारख्या समर्थित ऑडिओ एन्कोडिंगचे पर्याय. यशस्वी प्रतिसाद बायनरी आहे, JSON नाही. कालावधी-आधारित मार्गांना स्वतःचे वर्णन करणारे MP3, WAV किंवा FLAC आवश्यक आहे. |
speed | संख्या | 0.25 ते 4 पर्यंत ऐच्छिक भाषण गती; मॉडेल अधिक अरुंद मर्यादा लागू करू शकते. |
provider | ऑब्जेक्ट | पर्यायी प्रोव्हायडर रूटिंग प्राधान्ये. स्वीकारलेल्या प्रोव्हायडर टॅगसाठी provider.only वापरा, मॉडेल आयडीमध्ये उपसर्ग म्हणून नाही. खाते आणि क्रेडेन्शियल निर्बंध अद्याप लागू होतात. |
परिणाम वाचा#
यशस्वीतेसाठी HTTP 200 बायनरी ऑडिओसह परत करते. यशस्वी प्रतिसाद बायनरी ऑडिओ आहे, JSON नाही. हे जतन करा curl --output speech.mp3 किंवा तुमच्या SDK मध्ये प्रतिसाद बाइट्स वाचा. समर्थित मॉडेल आवाज आणि आउटपुट स्वरूप निवडा; गती 0.25 ते 4 पर्यंत मर्यादित आहे. इनपुट मर्यादा 256 KiB आहे आणि समकालीन प्रतिसाद मर्यादा 2 MiB आहे.
बिलिंग युनिट्स#
भाषण इनपुट वर्ण, प्रदाता-नोंदवलेले टोकन किंवा व्युत्पन्न सेकंदांनुसार किंमत आकारली जाऊ शकते, मॉडेलवर अवलंबून. वर्ण मोजणी Unicode वर्ण वापरते. कालावधी किंमत समर्थित स्वतःचे वर्णन करणारे MP3, WAV किंवा FLAC परिणाम आवश्यक आहे. कच्च्या PCM परिणामामध्ये कोणताही अंदाजित नमुना दर नसतो. टोकन-आधारित मार्गांना विश्वासार्ह वापर पावतीची आवश्यकता असते.
Console मधून अचूक सक्षम मॉडेल आयडेंटिफायर निवडा. त्याची जाहीर ऑपरेशन आणि इनपुट/आउटपुट क्षमता या एन्डपॉइंटशी जुळली पाहिजे; टेक्स्ट चॅट मॉडेल दुसऱ्या ऑपरेशनसाठी बदलले जाऊ शकत नाही. तुमचे क्रेडेन्शियल, प्रोव्हायडर आणि खाते निर्बंध अद्याप लागू होतात.
किंमत आणि वापर#
दर निवडलेल्या मॉडेल, प्रोव्हायडर, युनिट्स आणि प्रकारांसाठी EUR AI क्रेडिट्समध्ये प्रकाशित केले जातात. फक्त त्याच्या सक्रिय शुल्कातील परिमाणे आकारली जातात. अंदाज कार्यवाहीपूर्वी क्रेडिट्स राखून ठेवतो; अंतिम शुल्क मोजलेल्या वापरावर आधारित असते. किंमती रिझोल्यूशन, आउटपुट स्वरूप किंवा वापर बँडवर अवलंबून असू शकतात. अंतिम ShareAI डेबिटसाठी Console Usage तपासा. अपस्ट्रीम खर्च फील्ड्स आणि मीडिया बाइट्स काल्पनिक टोकन संख्यांमध्ये रूपांतरित केले जात नाहीत.
प्रवेश आणि त्रुटी#
वापरा inference मान्य नेटवर्क-खर्च अनुमानासाठी किंवा monetization_gateway मान्य Builder मार्कअप आणि स्वीकारलेले बिलिंग अटींसाठी. फक्त ओळख-आधारित प्रवेश खर्च अधिकृत करत नाही. सत्यापन, मॉडेल अधिकृतता, अपुरी क्रेडिट्स, दर मर्यादा आणि कार्य अयशस्वी झाल्यास संरचित error. परत येते. टाइमआउट किंवा अनिश्चित सबमिशननंतर, Usage किंवा व्हिडिओ जॉब तपासा, दुसरा संभाव्यतः सशुल्क विनंती तयार करण्यापूर्वी.
शेवटचे अद्यतनित नोव्हेंबर 3, 2026