Ƙirƙiri magana
Amsar da ta yi nasara ita ce binary audio, ba JSON ba.
A wannan shafin
https://api.shareai.now/api/v1/audio/speechƘirƙiri magana
- 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
Amsar da aka samu shine sauti na binary, ba JSON ba. Ajiye shi ta amfani da curl --output speech.mp3 ko karanta bytes na amsar a cikin SDK ɗinka. Zaɓi muryar samfurin da aka goyi bayan da kuma tsarin fitarwa; gudun yana iyakance daga 0.25 zuwa 4. Iyakar shigarwa ita ce 256 KiB kuma iyakar amsar da ake iya sarrafawa kai tsaye ita ce 2 MiB.
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/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));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. |
input wajibi | kirtani | Rubutun magana da ba zai kasance babu komai ba ya zama dole, mafi girma 256 KiB na UTF-8. Lissafin haruffa yana ƙididdige haruffan Unicode, ba bytes da aka loda ba. |
voice | kirtani | Zaɓin murya da aka goyi bayan samfurin magana da aka zaɓa, mafi girma haruffa 100. |
response_format | kirtani | Zaɓin tsarin sauti da aka goyi baya kamar mp3. Amsar da aka samu nasara tana kasancewa binary, ba JSON ba. Hanyoyin da aka ƙididdige farashi bisa tsawon lokaci suna buƙatar MP3, WAV ko FLAC mai bayyana kansa. |
speed | lamba | Zaɓin gudun magana daga 0.25 zuwa 4; samfurin na iya sanya iyakokin da suka fi ƙanƙanta. |
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 sautin binary. Amsar da aka samu nasara tana kasancewa sautin binary, ba JSON ba. Ajiye shi ta amfani da curl --output speech.mp3 ko karanta bytes na amsar a cikin SDK ɗinka. Zaɓi muryar samfurin da aka goyi bayan da kuma tsarin fitarwa; gudun yana iyakance daga 0.25 zuwa 4. Iyakar shigarwa ita ce 256 KiB kuma iyakar amsar da ake iya sarrafawa kai tsaye ita ce 2 MiB.
Rukunin biyan kuɗi#
Ana iya ƙididdige magana bisa ga haruffan shigarwa, token da mai bayarwa ya bayar ko kuma sakamakon da aka samar a cikin dakika, dangane da samfurin. Lissafin haruffa yana amfani da haruffan Unicode. Farashin tsawon lokaci yana buƙatar sakamakon MP3, WAV ko FLAC mai bayyana kansa da aka goyi baya. Sakamakon PCM na asali ba shi da ƙimar samfurin da aka hango. Hanyoyin da aka ƙididdige token suna buƙatar takardar shaidar amfani da aka amince da ita.
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