Nggawe wicara
Tanggapan sukses yaiku audio binar, dudu JSON.
Ing kaca iki
https://api.shareai.now/api/v1/audio/speechNggawe wicara
- URL Dasar
https://api.shareai.now- Otentikasi
- Bearer API key utawa token akses OAuth sing disetujui
- Lingkup sing dibutuhake
inferenceormonetization_gateway
Tanggapan sing sukses yaiku audio binar, ora JSON. Simpen nganggo curl --output speech.mp3 utawa maca byte tanggapan ing SDK sampeyan. Pilih swara model sing didhukung lan format output; kacepetan diwatesi saka 0.25 nganti 4. Watesan input yaiku 256 KiB lan watesan tanggapan sinkron yaiku 2 MiB.
Sadurunge sampeyan miwiti#
Set SHAREAI_API_KEY ing server sampeyan lan ganti placeholder model karo model sing saiki diaktifake. Aja tau mbukak API key ing kode browser. Model, akun, kredensial lan panyedhiya kudu kabeh ngidini operasi iki. Setelan opsional ing ngisor iki mbutuhake dhukungan model; watesan safety API ora janji yen saben model ndhukung saben nilai.
Kirim panjalukan#
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()));Lapangan panjalukan#
| Lapangan | Tipe | Makna lan watesan |
|---|---|---|
model dibutuhake | string | Identifikasi model publik sing diaktifake kanthi tepat. Kudu nyatakake operasi iki lan diidini dening kredensial sampeyan. |
input dibutuhake | string | Teks ucapan sing dibutuhake ora kosong, paling akeh 256 KiB UTF-8. Tarif karakter ngitung karakter Unicode, ora byte sing dienkode. |
voice | string | Swara opsional sing didhukung dening model ucapan sing dipilih, paling akeh 100 karakter. |
response_format | string | Encoding audio opsional sing didhukung kayata mp3. Tanggapan sing sukses yaiku binar, ora JSON. Rute sing regane durasi butuh MP3, WAV utawa FLAC sing bisa njelasake dhewe. |
speed | nomer | Kacepetan ucapan opsional saka 0.25 nganti 4; model bisa ngetrapake watesan sing luwih sempit. |
provider | obyek | Preferensi routing panyedhiya opsional. Gunakake provider.only kanggo tag panyedhiya sing ditampa, dudu prefiks ing ID model. Watesan akun lan kredensial isih ditrapake. |
Maca asil#
Sukses bali HTTP 200 karo audio binar. Tanggapan sing sukses yaiku audio binar, ora JSON. Simpen nganggo curl --output speech.mp3 utawa maca byte tanggapan ing SDK sampeyan. Pilih swara model sing didhukung lan format output; kacepetan diwatesi saka 0.25 nganti 4. Watesan input yaiku 256 KiB lan watesan tanggapan sinkron yaiku 2 MiB.
Unit tagihan#
Ucapan bisa regane saben karakter input, token sing dilaporake penyedia utawa detik sing diasilake, gumantung saka model. Hitungan karakter nggunakake karakter Unicode. Regane durasi mbutuhake asil MP3, WAV utawa FLAC sing bisa njelasake dhewe. Asil PCM mentah ora duwe tingkat sampel sing ditebak. Rute sing regane token butuh kuitansi panggunaan sing dipercaya.
Pilih identifier model sing diaktifake kanthi tepat saka Console. Operasi sing diumumake lan kemampuan input/output kudu cocog karo endpoint iki; model obrolan teks ora bisa diganti kanggo operasi liyane. Watesan kredensial, panyedhiya lan akun sampeyan isih ditrapake.
Harga lan panggunaan#
Tarif diterbitake ing kredit AI EUR kanggo model sing dipilih, panyedhiya, unit lan varian. Mung dimensi ing tarif aktif sing dikenani biaya. Perkiraan nyimpen kredit sadurunge eksekusi; biaya pungkasan nggunakake panggunaan sing diukur. Harga bisa gumantung saka resolusi, format output utawa pita panggunaan. Priksa Console Usage kanggo debit ShareAI pungkasan. Lapangan biaya hulu lan byte media ora dikonversi dadi jumlah token sing diada-adakan.
Akses lan kesalahan#
Gunakake inference kanggo inferensi biaya jaringan sing disetujui utawa monetization_gateway kanggo markup Builder sing disetujui lan syarat tagihan sing ditampa. Akses identitas mung ora ngidini pengeluaran. Validasi, otorisasi model, kredit sing ora cukup, watesan tarif lan kegagalan eksekusi ngasilake error. Sawise timeout utawa kiriman sing ora pasti, priksa Usage utawa tugas video sadurunge nggawe panjalukan liyane sing bisa dikenani biaya.
Pungkasan dianyari 3 Novèmber 2026