Bumuo ng audio
Ang ShareAI endpoint ay nagbabalik ng bounded JSON audio na resulta.
Sa pahinang ito
https://api.shareai.now/api/v1/audio/generationsBumuo ng audio
- Base URL
https://api.shareai.now- Pagpapatunay
- Bearer API key o aprubadong OAuth access token
- Kinakailangang scope
inferenceormonetization_gateway
Ang ShareAI endpoint ay nagbabalik ng bounded JSON audio result. Ang mga kahilingan para sa pagbuo ng audio na may modalities:["text","audio"] maaari ring gumamit /api/v1/chat/completions. Ang iyong kahilingan ay idinadaan sa tinukoy na audio operation. Ang synchronous na tugon na ito ay kinokolekta bago ibalik; ang mga hindi kumpletong provider streams ay hindi nagiging matagumpay na sinisingil na resulta. Ang mga format ng audio output ay mp3, wav, flac, pcm16 o pcm24, depende sa modelo. Ang raw PCM ay hindi maaaring suportahan ang duration tariff. Itakda ang alinman sa max_tokens o max_completion_tokens upang limitahan ang mga generated tokens; huwag magbigay ng pareho.
Bago ka magsimula#
Itakda ang SHAREAI_API_KEY sa iyong server at palitan ang placeholder ng modelo ng kasalukuyang pinapaganang modelo. Huwag kailanman ilantad ang API key sa browser code. Ang modelo, account, kredensyal, at provider ay dapat lahat pahintulutan ang operasyong ito. Ang mga opsyonal na setting sa ibaba ay nangangailangan ng suporta ng modelo; ang mga hangganan ng kaligtasan ng API ay hindi pangako na ang bawat modelo ay sumusuporta sa bawat halaga.
Magpadala ng kahilingan#
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);Mga field ng kahilingan#
| Patlang | Uri | Kahulugan at mga limitasyon |
|---|---|---|
model kinakailangan | string | Eksaktong pinapaganang pampublikong identifier ng modelo. Dapat ideklara ang operasyong ito at pahintulutan ng iyong kredensyal. |
messages kinakailangan | array | 1–256 na mga mensahe ng pag-uusap na may role/content. Gumamit lamang ng mga content modalities na sinusuportahan ng napiling audio model. |
modalities | array | Isa o dalawang natatanging halaga mula sa text at audio; kinakailangan ang audio. Default sa audio. Ang synchronous endpoint na ito ay hindi tumatanggap ng stream. |
audio | bagay | Opsyonal na mga output option: voice at format lamang. Ang format ay mp3, wav, flac, pcm16 o pcm24, depende sa suporta ng modelo. Ang raw PCM ay hindi tugma sa duration tariffs. |
temperature | numero | Opsyonal na temperatura para sa generation na sinusuportahan ng modelo. |
top_p | numero | Opsyonal na nucleus sampling value na sinusuportahan ng modelo. |
max_tokens | integer | Opsyonal na output-token bound, 1–262144. Huwag pagsamahin sa max_completion_tokens. |
max_completion_tokens | integer | Opsyonal na output-token bound, 1–262144. Huwag pagsamahin sa max_tokens. |
provider | bagay | Opsyonal na mga kagustuhan sa pag-route ng provider. Gamitin ang provider.only para sa mga tinatanggap na tag ng provider, hindi isang prefix sa model ID. Ang mga paghihigpit sa account at kredensyal ay nalalapat pa rin. |
Basahin ang resulta#
Ang matagumpay na tugon ay nagbabalik ng HTTP 200 na may JSON. Ang ShareAI endpoint ay nagbabalik ng bounded JSON audio result. Ang mga kahilingan para sa pagbuo ng audio na may modalities:["text","audio"] maaari ring gumamit /api/v1/chat/completions. Ang iyong kahilingan ay idinadaan sa tinukoy na audio operation. Ang synchronous na tugon na ito ay kinokolekta bago ibalik; ang mga hindi kumpletong provider streams ay hindi nagiging matagumpay na sinisingil na resulta. Ang mga format ng audio output ay mp3, wav, flac, pcm16 o pcm24, depende sa modelo. Ang raw PCM ay hindi maaaring suportahan ang duration tariff. Itakda ang alinman sa max_tokens o max_completion_tokens upang limitahan ang mga generated tokens; huwag magbigay ng pareho.
Mga yunit ng pagsingil#
Ang mga audio model ay maaaring mag-publish ng magkahiwalay na text-token at audio-token dimensions, duration, song o request rates. Ang kabuuang inclusive token ay hinahati sa magkakahiwalay na text/audio counters; ang parehong audio tokens ay hindi kailanman sinisingil muli bilang text. Ang hindi sinusuportahan o nawawalang paggamit ay hindi tinatantya mula sa encoded bytes.
Piliin ang eksaktong pinapaganang identifier ng modelo mula sa Console. Ang idineklarang operasyon nito at mga kakayahan sa input/output ay dapat tumugma sa endpoint na ito; ang isang text chat model ay hindi maaaring palitan para sa ibang operasyon. Ang iyong kredensyal, provider, at mga paghihigpit sa account ay nalalapat pa rin.
Pagpepresyo at paggamit#
Ang mga rate ay inilathala sa EUR AI credits para sa napiling modelo, provider, mga yunit, at mga variant. Ang mga sukat lamang sa aktibong taripa nito ang sinisingil. Ang isang pagtatantya ay nagrereserba ng mga kredito bago ang pagpapatupad; ang mga huling singil ay gumagamit ng nasukat na paggamit. Ang mga presyo ay maaaring depende sa resolusyon, format ng output, o isang banda ng paggamit. Suriin ang Console Usage para sa huling ShareAI debit. Ang mga field ng gastos sa upstream at media bytes ay hindi iko-convert sa mga imbentong bilang ng token.
Pag-access at mga error#
Gamitin inference para sa aprubadong inference ng network-cost o monetization_gateway para sa isang aprubadong markup ng Builder at tinatanggap na mga tuntunin sa pagsingil. Ang access na identity-only ay hindi nagbibigay ng awtorisasyon sa paggastos. Ang validation, awtorisasyon ng modelo, hindi sapat na kredito, mga limitasyon sa rate, at mga pagkabigo sa pagpapatupad ay nagbabalik ng structured error. Pagkatapos ng timeout o hindi tiyak na pagsusumite, suriin ang Usage o ang video job bago lumikha ng isa pang posibleng bayad na kahilingan.
Huling na-update Nobyembre 3, 2026