ऑडिओ तयार करा
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 वापरा, मॉडेल आयडीमध्ये उपसर्ग म्हणून नाही. खाते आणि क्रेडेन्शियल निर्बंध अद्याप लागू होतात. |
परिणाम वाचा#
यशस्वी प्रतिसाद 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