Ƙirƙiri sauti
ShareAI endpoint yana dawowa da iyakantaccen sakamakon JSON audio.
A wannan shafin
https://api.shareai.now/api/v1/audio/generationsƘirƙiri sauti
- URL na Asali
https://api.shareai.now- Tantancewa
- Maɓallin API na Bearer ko takardar izinin shiga OAuth da aka amince da ita
- Dole ne a sami izini
inferenceormonetization_gateway
Mashigar ShareAI yana dawowa da sakamakon sauti na JSON mai iyaka. Buƙatun samar da sauti tare da modalities:["text","audio"] na iya kuma amfani da /api/v1/chat/completions. An tura buƙatarka zuwa aikin sauti da aka bayyana. Wannan amsar da ake yi kai tsaye ana tattarawa kafin dawowa; rafukan mai bayarwa da ba a kammala ba ba sa zama sakamakon da aka biya nasara. Tsarin fitarwa na sauti sun haɗa da mp3, wav, flac, pcm16 ko pcm24, bisa ga samfurin. Raw PCM ba zai iya tallafawa farashin tsawon lokaci ba. Saita ko dai max_tokens ko max_completion_tokens don iyakance adadin tokens da aka samar; kada ka bayar da duka biyun.
Kafin ka fara#
Saita SHAREAI_API_KEY akan uwar garken ku kuma maye gurbin wurin samfurin samfurin da samfurin da aka kunna a halin yanzu. Kada ku taɓa bayyana maɓallin API a cikin lambar burauza. Samfurin, asusu, takaddun shaida da mai bayarwa dole ne duk su ba da izinin wannan aikin. Saitunan zaɓi a ƙasa suna buƙatar tallafin samfurin; iyakokin aminci na API ba alkawari bane cewa kowane samfurin yana tallafawa kowane ƙima.
Aika buƙata#
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);Filayen buƙata#
| Filin | Nau'in | Ma'ana da iyakoki |
|---|---|---|
model wajibi | kirtani | Takamaiman mai gano samfurin jama'a da aka kunna. Dole ne a bayyana wannan aiki kuma takardun shaidarka su yarda da shi. |
messages wajibi | jerin abubuwa | Saƙonni na tattaunawa 1–256 tare da matsayi/abun ciki. Yi amfani da nau'ikan abun ciki kawai da samfurin sauti da aka zaɓa ke tallafawa. |
modalities | jerin abubuwa | Ɗaya ko biyu daga cikin ƙimomi na musamman daga rubutu da sauti; sauti yana da mahimmanci. Tana da tsoho zuwa sauti. Wannan mashigar kai tsaye ba ta karɓar rafuka. |
audio | abu | Zaɓuɓɓukan fitarwa na zaɓi: murya da tsarin kawai. tsarin shine mp3, wav, flac, pcm16 ko pcm24, bisa ga tallafin samfurin. Raw PCM ba ya dace da farashin tsawon lokaci. |
temperature | lamba | Zaɓin yanayin samarwa da samfurin ke tallafawa. |
top_p | lamba | Zaɓin ƙimar samfurin nucleus sampling da samfurin ke tallafawa. |
max_tokens | lamba | Zaɓin iyakar tokens na fitarwa, 1–262144. Kada a haɗa shi da max_completion_tokens. |
max_completion_tokens | lamba | Zaɓin iyakar tokens na fitarwa, 1–262144. Kada a haɗa shi da max_tokens. |
provider | abu | Zaɓin fifikon hanyar mai bayarwa. Yi amfani da provider.only don alamun mai bayarwa da aka karɓa, ba don farkon ID na samfur ba. Har yanzu ana amfani da iyakokin asusu da takardun shaida. |
Karanta sakamakon#
Nasara tana dawowa da HTTP 200 tare da JSON. Mashigar ShareAI yana dawowa da sakamakon sauti na JSON mai iyaka. Buƙatun samar da sauti tare da modalities:["text","audio"] na iya kuma amfani da /api/v1/chat/completions. An tura buƙatarka zuwa aikin sauti da aka bayyana. Wannan amsar da ake yi kai tsaye ana tattarawa kafin dawowa; rafukan mai bayarwa da ba a kammala ba ba sa zama sakamakon da aka biya nasara. Tsarin fitarwa na sauti sun haɗa da mp3, wav, flac, pcm16 ko pcm24, bisa ga samfurin. Raw PCM ba zai iya tallafawa farashin tsawon lokaci ba. Saita ko dai max_tokens ko max_completion_tokens don iyakance adadin tokens da aka samar; kada ka bayar da duka biyun.
Rukunin biyan kuɗi#
Samfurin sauti na iya wallafa ma'auni daban-daban na tokens na rubutu da na sauti, tsawon lokaci, waƙa ko ƙimar buƙata. Jimillar tokens da aka haɗa ana raba su zuwa ƙididdigar rubutu/sauti daban-daban; ba a sake cajin tokens ɗin sauti ɗaya a matsayin rubutu. Amfani da ba a tallafawa ba ko wanda ba ya nan ba a ƙiyasta shi daga bytes da aka loda ba.
Zaɓi ainihin mai gano samfurin da aka kunna daga Console. Ayyukansa da damar shigarwa/fitarwa da aka bayyana dole ne su dace da wannan wurin; samfurin hira da rubutu ba za a iya maye gurbinsa da wani aiki ba. Takaddun shaida, mai bayarwa da iyakokin asusunku har yanzu suna aiki.
Farashi da amfani#
Farashin ana wallafa su a cikin EUR AI credits don samfurin da aka zaɓa, mai bayarwa, raka'o'i da bambance-bambance. Ana cajin kawai girman da ke cikin farashin aiki. Kimantawa yana adana credits kafin aiwatarwa; cajin ƙarshe yana amfani da amfani da aka auna. Farashin na iya dogara da ƙuduri, tsarin fitarwa ko rukuni na amfani. Duba Console Usage don ShareAI debit na ƙarshe. Filayen farashin sama da bytes na kafofin watsa labarai ba a canza su zuwa adadin tokon da aka ƙirƙira ba.
Samuwa da kurakurai#
Amfani inference don amincewa da farashin hanyar sadarwa ko monetization_gateway don amincewa da ƙarin Builder da sharuɗɗan biyan kuɗi da aka karɓa. Samun izini kawai ba ya ba da izinin kashe kuɗi. Tabbatarwa, izinin samfurin, ƙarancin credits, iyakokin farashi da gazawar aiwatarwa suna dawo da tsari error. Bayan lokaci ko gabatarwa mara tabbas, bincika Amfani ko aikin bidiyo kafin ƙirƙirar wata buƙata mai yiwuwa da aka biya.
An sabunta karshe Nuwamba 3, 2026