Moknah Dokumen
Mulai gratis
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.