ఆడియోను సృష్టించండి
ShareAI ఎండ్పాయింట్ ఒక పరిమిత JSON ఆడియో ఫలితాన్ని తిరిగి ఇస్తుంది.
ఈ పేజీలో
https://api.shareai.now/api/v1/audio/generationsఆడియోను సృష్టించండి
- బేస్ URL
https://api.shareai.now- authentication
- Bearer API కీ లేదా ఆమోదించిన OAuth యాక్సెస్ టోకెన్
- అవసరమైన scope
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 | ఆబ్జెక్ట్ | ఐచ్ఛిక ప్రొవైడర్ రూటింగ్ ప్రాధాన్యతలు. మోడల్ 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