Referensi API
Daftar Suara
Mengambil suara yang tersedia untuk TTS
POST
/api/v1/voices/
Mengembalikan daftar semua suara yang diizinkan untuk digunakan oleh pengguna terautentikasi dengan API Text-to-Speech.
Autentikasi
Sertakan kunci API Anda di header Authorization sebagai Bearer YOUR_API_KEY.
Isi Permintaan (Request Body)
| Parameter | Wajib | Jenis | Deskripsi |
|---|---|---|---|
| language | opsional | string | Bahasa untuk nama suara dan nilai badge, misalnya ar, fr, atau zh-hans (juga diterima sebagai ?language= di URL). Suara tanpa teks dalam bahasa itu ditampilkan dalam bahasa Inggris, begitu juga jika kode tidak ada atau tidak didukung. Header respons Content-Language menunjukkan bahasa yang digunakan. |
| engine | opsional | string | Kunci API Anda hanya menampilkan suara dengan jenisnya sendiri (standar atau lanjutan, dipilih saat kunci dibuat). Jika Anda mengirim engine, nilainya harus sesuai dengan jenis kunci. |
Respons
| Kolom | Jenis | Deskripsi |
|---|---|---|
| voice_id | integer | Pengidentifikasi suara unik |
| voice_name | string | Nama tampilan suara |
| voice_sample_url | string | URL ke file audio sampel suara |
| voice_fees | float | Biaya untuk menggunakan suara ini (0 berarti gratis) |
| voice_badges | object | Metadata tambahan untuk suara, misalnya bahasa, jenis kelamin, usia, kasus penggunaan |
| voice_engine | string | standard atau advanced. Suara mesin Standar menggunakan mode; suara mesin Lanjutan menggunakan context, setting, style, dan pace. Lihat Mesin & Mode. |
Contoh
curl "https://moknah.io/api/v1/voices/" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.post(
"https://moknah.io/api/v1/voices/",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
voices = response.json()
for voice in voices:
print(voice["voice_name"], voice["voice_sample_url"])
const response = await fetch(
'https://moknah.io/api/v1/voices/',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const voices = await response.json();
console.log(voices);
Contoh Respons
[
{
"voice_id": 1328,
"voice_name": "Adnan",
"voice_sample_url": "https://storage.moknah.io/media/voice_samples/Adnan.mp3",
"voice_fees": 0.0,
"voice_badges": {
"language": "Arabic",
"gender": "Male",
"age": "Young Adult",
"use_case": "Documentary, Audiobook, Article",
},
"voice_engine": "standard"
}
]
Dukungan API
Untuk pertanyaan atau masalah terkait API, hubungi kami di api@moknah.io.