Menghasilkan suara
Respons yang berhasil adalah audio biner, bukan JSON.
Di halaman ini
https://api.shareai.now/api/v1/audio/speechMenghasilkan suara
- URL Dasar
https://api.shareai.now- Otentikasi
- Kunci API Bearer atau token akses OAuth yang disetujui
- Cakupan yang diperlukan
inferenceormonetization_gateway
Respons yang berhasil adalah audio biner, bukan JSON. Simpan menggunakan curl --output speech.mp3 atau baca byte respons di SDK Anda. Pilih suara model yang didukung dan format output; kecepatan dibatasi dari 0,25 hingga 4. Batas input adalah 256 KiB dan batas respons sinkron adalah 2 MiB.
Sebelum Anda memulai#
Atur SHAREAI_API_KEY di server Anda dan ganti placeholder model dengan model yang saat ini diaktifkan. Jangan pernah mengekspos kunci API dalam kode browser. Model, akun, kredensial, dan penyedia semuanya harus mengizinkan operasi ini. Pengaturan opsional di bawah ini memerlukan dukungan model; batas keamanan API bukanlah janji bahwa setiap model mendukung setiap nilai.
Kirim permintaan#
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()));Bidang permintaan#
| Bidang | Tipe | Makna dan batasan |
|---|---|---|
model diperlukan | string | Pengidentifikasi model publik yang diaktifkan secara tepat. Harus mendeklarasikan operasi ini dan diizinkan oleh kredensial Anda. |
input diperlukan | string | Teks ucapan wajib tidak boleh kosong, maksimal 256 KiB dalam UTF-8. Tarif karakter menghitung karakter Unicode, bukan byte yang dikodekan. |
voice | string | Suara opsional yang didukung oleh model ucapan yang dipilih, maksimal 100 karakter. |
response_format | string | Pengkodean audio opsional yang didukung seperti mp3. Respons yang berhasil adalah biner, bukan JSON. Rute dengan harga durasi memerlukan MP3, WAV, atau FLAC yang mendeskripsikan diri sendiri. |
speed | nomor | Kecepatan ucapan opsional dari 0,25 hingga 4; model mungkin memberlakukan batas yang lebih sempit. |
provider | objek | Preferensi routing penyedia opsional. Gunakan provider.only untuk tag penyedia yang diterima, bukan awalan dalam ID model. Pembatasan akun dan kredensial tetap berlaku. |
Baca hasilnya#
Keberhasilan mengembalikan HTTP 200 dengan audio biner. Respons yang berhasil adalah audio biner, bukan JSON. Simpan menggunakan curl --output speech.mp3 atau baca byte respons di SDK Anda. Pilih suara model yang didukung dan format output; kecepatan dibatasi dari 0,25 hingga 4. Batas input adalah 256 KiB dan batas respons sinkron adalah 2 MiB.
Unit penagihan#
Ucapan dapat dihargai per karakter input, token yang dilaporkan penyedia, atau detik yang dihasilkan, tergantung pada modelnya. Penghitungan karakter menggunakan karakter Unicode. Penetapan harga durasi memerlukan hasil MP3, WAV, atau FLAC yang mendeskripsikan diri sendiri yang didukung. Hasil PCM mentah tidak memiliki tingkat sampel yang ditebak. Rute dengan harga token memerlukan tanda terima penggunaan yang terpercaya.
Pilih pengidentifikasi model yang diaktifkan secara tepat dari Console. Operasi yang dideklarasikan dan kemampuan input/output-nya harus sesuai dengan endpoint ini; model chat teks tidak dapat diganti untuk operasi lain. Pembatasan kredensial, penyedia, dan akun Anda tetap berlaku.
Harga dan penggunaan#
Tarif diterbitkan dalam kredit AI EUR untuk model, penyedia, unit, dan varian yang dipilih. Hanya dimensi dalam tarif aktifnya yang dikenakan biaya. Perkiraan akan memesan kredit sebelum eksekusi; biaya akhir menggunakan penggunaan yang terukur. Harga dapat bergantung pada resolusi, format output, atau rentang penggunaan. Periksa Penggunaan di Console untuk debit ShareAI akhir. Bidang biaya hulu dan byte media tidak diubah menjadi jumlah token yang diciptakan.
Akses dan kesalahan#
Gunakan inference untuk inferensi biaya jaringan yang disetujui atau monetization_gateway untuk markup Builder yang disetujui dan ketentuan penagihan yang diterima. Akses hanya identitas tidak mengizinkan pengeluaran. Validasi, otorisasi model, kredit yang tidak mencukupi, batasan tarif, dan kegagalan eksekusi mengembalikan struktur error. Setelah batas waktu atau pengiriman yang tidak pasti, periksa Penggunaan atau pekerjaan video sebelum membuat permintaan lain yang mungkin berbayar.
Terakhir diperbarui 3 November 2026