Bumuo ng pagsasalita
Ang matagumpay na tugon ay binary audio, hindi JSON.
Sa pahinang ito
https://api.shareai.now/api/v1/audio/speechBumuo ng pagsasalita
- Base URL
https://api.shareai.now- Pagpapatunay
- Bearer API key o aprubadong OAuth access token
- Kinakailangang scope
inferenceormonetization_gateway
Ang matagumpay na tugon ay binary audio, hindi JSON. I-save ito gamit ang curl --output speech.mp3 o basahin ang response bytes sa iyong SDK. Pumili ng suportadong model voice at output format; ang bilis ay limitado mula 0.25 hanggang 4. Ang input limit ay 256 KiB at ang synchronous response limit ay 2 MiB.
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/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()));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. |
input kinakailangan | string | Kinakailangang hindi walang laman na speech text, hanggang sa 256 KiB ng UTF-8. Ang bilang ng character tariffs ay batay sa Unicode characters, hindi sa encoded bytes. |
voice | string | Opsyonal na boses na suportado ng napiling speech model, hanggang sa 100 characters. |
response_format | string | Opsyonal na suportadong audio encoding tulad ng mp3. Ang matagumpay na tugon ay binary, hindi JSON. Ang mga ruta na may presyo batay sa tagal ay nangangailangan ng self-describing MP3, WAV o FLAC. |
speed | numero | Opsyonal na bilis ng pagsasalita mula 0.25 hanggang 4; maaaring magtakda ang modelo ng mas makitid na limitasyon. |
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 tagumpay ay nagbabalik ng HTTP 200 na may binary audio. Ang matagumpay na tugon ay binary audio, hindi JSON. I-save ito gamit ang curl --output speech.mp3 o basahin ang response bytes sa iyong SDK. Pumili ng suportadong model voice at output format; ang bilis ay limitado mula 0.25 hanggang 4. Ang input limit ay 256 KiB at ang synchronous response limit ay 2 MiB.
Mga yunit ng pagsingil#
Ang pagsasalita ay maaaring may presyo batay sa input character, provider-reported token o generated second, depende sa modelo. Ang bilang ng character ay gumagamit ng Unicode characters. Ang pagpepresyo batay sa tagal ay nangangailangan ng suportadong self-describing MP3, WAV o FLAC na resulta. Ang raw PCM na resulta ay walang tinatayang sample rate. Ang mga ruta na may presyo batay sa token ay nangangailangan ng pinagkakatiwalaang usage receipt.
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