Tengeneza sauti
Endpoint ya ShareAI inarudisha matokeo ya sauti ya JSON yenye mipaka.
Kwenye ukurasa huu
https://api.shareai.now/api/v1/audio/generationsTengeneza sauti
- URL ya Msingi
https://api.shareai.now- Uthibitishaji
- Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
- Upeo unaohitajika
inferenceormonetization_gateway
Endpoint ya ShareAI inarudisha matokeo ya sauti ya JSON yenye mipaka. Maombi ya kuzalisha sauti na modalities:["text","audio"] inaweza pia kutumia /api/v1/chat/completions. Ombi lako linaelekezwa kwenye operesheni ya sauti iliyoainishwa. Jibu hili la wakati halisi linakusanywa kabla ya kurudishwa; mitiririko ya watoa huduma isiyokamilika haihesabiwi kama matokeo yaliyofanikiwa na kutozwa ada. Miundo ya sauti inayotolewa ni mp3, wav, flac, pcm16 au pcm24, kulingana na mfano. PCM mbichi haiwezi kusaidia ada ya muda. Weka aidha max_tokens au max_completion_tokens ili kuweka mipaka ya tokeni zinazozalishwa; usitoe zote mbili.
Kabla ya kuanza#
Weka SHAREAI_API_KEY kwenye seva yako na badilisha nafasi ya mfano na mfano uliowezeshwa kwa sasa. Kamwe usifunue API key kwenye msimbo wa kivinjari. Mfano, akaunti, kitambulisho na mtoa huduma lazima vyote viruhusu operesheni hii. Mipangilio ya hiari hapa chini inahitaji msaada wa mfano; mipaka ya usalama ya API si ahadi kwamba kila mfano unasaidia kila thamani.
Tuma ombi#
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);Sehemu za ombi#
| Sehemu | Aina | Maana na mipaka |
|---|---|---|
model inahitajika | kamba | Kitambulisho halisi cha mfano wa umma uliowezeshwa. Lazima kitangaze operesheni hii na kuruhusiwa na kitambulisho chako. |
messages inahitajika | safu | Ujumbe wa mazungumzo 1–256 na jukumu/maudhui. Tumia tu njia za maudhui zinazoungwa mkono na mfano wa sauti ulioteuliwa. |
modalities | safu | Thamani moja au mbili za kipekee kutoka kwa maandishi na sauti; sauti inahitajika. Chaguomsingi ni sauti. Endpoint hii ya wakati halisi haikubali mtiririko. |
audio | kitu | Chaguo za matokeo za hiari: sauti na umbizo pekee. Umbizo ni mp3, wav, flac, pcm16 au pcm24, kulingana na msaada wa mfano. PCM mbichi haiendani na ada za muda. |
temperature | nambari | Joto la kizazi linaloungwa mkono na mfano (hiari). |
top_p | nambari | Thamani ya sampuli ya nucleus inayoungwa mkono na mfano (hiari). |
max_tokens | nambari kamili | Mipaka ya tokeni za matokeo ya hiari, 1–262144. Usichanganye na max_completion_tokens. |
max_completion_tokens | nambari kamili | Mipaka ya tokeni za matokeo ya hiari, 1–262144. Usichanganye na max_tokens. |
provider | kitu | Mapendeleo ya hiari ya uelekezaji wa mtoa huduma. Tumia provider.only kwa vitambulisho vya mtoa huduma vilivyokubaliwa, si kiambishi awali kwenye ID ya mfano. Vizuizi vya akaunti na kitambulisho bado vinatumika. |
Soma matokeo#
Mafanikio yanarudisha HTTP 200 na JSON. Endpoint ya ShareAI inarudisha matokeo ya sauti ya JSON yenye mipaka. Maombi ya kuzalisha sauti na modalities:["text","audio"] inaweza pia kutumia /api/v1/chat/completions. Ombi lako linaelekezwa kwenye operesheni ya sauti iliyoainishwa. Jibu hili la wakati halisi linakusanywa kabla ya kurudishwa; mitiririko ya watoa huduma isiyokamilika haihesabiwi kama matokeo yaliyofanikiwa na kutozwa ada. Miundo ya sauti inayotolewa ni mp3, wav, flac, pcm16 au pcm24, kulingana na mfano. PCM mbichi haiwezi kusaidia ada ya muda. Weka aidha max_tokens au max_completion_tokens ili kuweka mipaka ya tokeni zinazozalishwa; usitoe zote mbili.
Vitengo vya malipo#
Miundo ya sauti inaweza kuchapisha vipimo tofauti vya tokeni za maandishi na tokeni za sauti, muda, wimbo au viwango vya maombi. Jumla ya tokeni zilizojumuishwa hugawanywa katika kaunta za maandishi/sauti zisizoshirikiana; tokeni zile zile za sauti hazitozwi tena kama maandishi. Matumizi yasiyoungwa mkono au yaliyokosekana hayakadirwi kutoka kwa baiti zilizofichwa.
Chagua kitambulisho halisi cha mfano uliowezeshwa kutoka Console. Operesheni yake iliyotangazwa na uwezo wa pembejeo/pato lazima vilingane na endpoint hii; mfano wa mazungumzo ya maandishi hauwezi kubadilishwa kwa operesheni nyingine. Vizuizi vya kitambulisho, mtoa huduma na akaunti yako bado vinatumika.
Bei na matumizi#
Viwango vinachapishwa kwa EUR AI credits kwa mfano ulioteuliwa, mtoa huduma, vitengo na tofauti. Vipimo tu katika ada yake inayotumika vinatozwa. Makadirio yanahifadhi credits kabla ya utekelezaji; malipo ya mwisho hutumia matumizi yaliyopimwa. Bei zinaweza kutegemea azimio, muundo wa pato au kiwango cha matumizi. Angalia Console Usage kwa deni la mwisho la ShareAI. Sehemu za gharama za juu na baiti za vyombo vya habari hazibadilishwi kuwa hesabu za tokeni zilizobuniwa.
Ufikiaji na makosa#
Tumia inference kwa inference ya gharama ya mtandao iliyokubaliwa au monetization_gateway kwa markup ya Builder iliyokubaliwa na masharti ya malipo yaliyokubaliwa. Ufikiaji wa kitambulisho pekee hauidhinishi matumizi. Uthibitishaji, idhini ya mfano, credits zisizotosha, mipaka ya kiwango na kushindwa kwa utekelezaji hurudisha error. Baada ya muda wa kusubiri au uwasilishaji usio na uhakika, kagua Usage au kazi ya video kabla ya kuunda ombi lingine linaloweza kulipwa.
Ilisasishwa mwisho Novemba 3, 2026