ShareAI Platform Docs

Tengeneza sauti

Endpoint ya ShareAI inarudisha matokeo ya sauti ya JSON yenye mipaka.

Tazama kama Markdown
Kwenye ukurasa huu
POST https://api.shareai.now/api/v1/audio/generations

Tengeneza sauti

URL ya Msingi
https://api.shareai.now
Uthibitishaji
Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
Upeo unaohitajika
inference or monetization_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
}'

Sehemu za ombi#

SehemuAinaMaana na mipaka
model inahitajikakambaKitambulisho halisi cha mfano wa umma uliowezeshwa. Lazima kitangaze operesheni hii na kuruhusiwa na kitambulisho chako.
messages inahitajikasafuUjumbe wa mazungumzo 1–256 na jukumu/maudhui. Tumia tu njia za maudhui zinazoungwa mkono na mfano wa sauti ulioteuliwa.
modalitiessafuThamani moja au mbili za kipekee kutoka kwa maandishi na sauti; sauti inahitajika. Chaguomsingi ni sauti. Endpoint hii ya wakati halisi haikubali mtiririko.
audiokituChaguo 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.
temperaturenambariJoto la kizazi linaloungwa mkono na mfano (hiari).
top_pnambariThamani ya sampuli ya nucleus inayoungwa mkono na mfano (hiari).
max_tokensnambari kamiliMipaka ya tokeni za matokeo ya hiari, 1–262144. Usichanganye na max_completion_tokens.
max_completion_tokensnambari kamiliMipaka ya tokeni za matokeo ya hiari, 1–262144. Usichanganye na max_tokens.
providerkituMapendeleo 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

Nyaraka za Jukwaa la ShareAI
Nyaraka zote

Tafuta kwa kichwa au maudhui.

Uliza kuhusu ukurasa huu

Chagua msaidizi wa kuchunguza ukurasa huu. Unaweza pia kunakili ukurasa na kuubandika kwenye mazungumzo yako.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI