Memulai
Semua yang Anda butuhkan untuk membuat permintaan API pertama Anda
URL Dasar
Moknah menyediakan dua jenis endpoint tergantung pada kasus penggunaan Anda:
REST API Standar (untuk permintaan tunggal):
https://moknah.io/api/v1/
WebSocket API Real-time (untuk streaming berkelanjutan):
wss://moknah.io/api/v1/
Autentikasi
API Moknah menggunakan kunci API untuk autentikasi. Sertakan kunci API Anda di header Authorization menggunakan skema
Bearer di setiap permintaan HTTP dan jabat tangan WebSocket.
Authorization: Bearer YOUR_API_KEY
Mendapatkan Kunci API Anda
- Masuk ke Dasbor Moknah
- Berlangganan Paket Pro atau hubungi Penjualan untuk akses enterprise.
- Buka API
- Klik Kelola Kunci API
- Klik Kunci Baru
- Salin dan simpan kunci Anda dengan aman
Jangan pernah mengekspos kunci API Anda di kode sisi klien atau repositori publik. Perlakukan seperti kata sandi.
Contoh Cepat HTTP
Berikut contoh lengkap untuk menghasilkan suara dari teks menggunakan REST API standar:
curl -X POST "https://moknah.io/api/v1/tts/generate/" \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{
"text": "مرحبا بك في منصة مكنة",
"voice_id": 1
}' \
--output speech.mp3
import requests
response = requests.post(
"https://moknah.io/api/v1/tts/generate/",
headers={
"Authorization": f"Bearer your_api_key",
},
json={
"text": "مرحبا بك في منصة مكنة",
"voice_id": 1
}
)
if response.status_code == 200:
with open("speech.mp3", "wb") as f:
f.write(response.content)
print("Audio disimpan!")
else:
print(f"Kesalahan: {response.json()}")
const response = await fetch(
'https://moknah.io/api/v1/tts/generate/',
{
method: 'POST',
headers: {
'Authorization': 'Bearer your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
text: 'مرحبا بك في منصة مكنة',
voice_id: 1
})
}
);
if (response.ok) {
const blob = await response.blob();
// Gunakan blob audio
console.log("Audio berhasil dibuat!");
} else {
const error = await response.json();
console.error(error);
}
Format Respons
Respons Berhasil
Respons yang berhasil bervariasi menurut endpoint:
- Pembuatan TTS (POST): Mengembalikan data audio biner lengkap dalam output_format yang diminta (default audio/mpeg)
- Stream TTS (WSS): Mengalirkan potongan MP3 biner secara berkelanjutan saat dibuat
- Endpoint lainnya: Mengembalikan data JSON terstruktur
Header Batas Laju (Hanya HTTP)
Setiap respons HTTP menyertakan informasi batas laju (WebSocket menerapkan batas melalui penutupan koneksi):
| Header | Deskripsi |
|---|---|
| RateLimit-Limit | Permintaan maksimum per menit |
| RateLimit-Remaining | Permintaan tersisa di jendela saat ini |
| RateLimit-Reset | Stempel waktu Unix saat batas diatur ulang |
| Moknah-Credits-Remaining | Sisa saldo kredit Anda |
Kode Kesalahan Umum
| Kode | Jenis | Deskripsi |
|---|---|---|
| 400 | INVALID_REQUEST |
Parameter tidak valid atau format JSON salah |
| 401 | UNAUTHORIZED |
Kunci API tidak valid atau hilang |
| 402 | INSUFFICIENT_CREDITS |
Akun tidak memiliki cukup kredit |
| 429 | RATE_LIMIT_EXCEEDED |
Terlalu banyak permintaan (HTTP) |
| 4290 | CONCURRENT_LIMIT |
Terlalu banyak koneksi aktif (WSS) |
| 500 | INTERNAL_SERVER_ERROR |
Kesalahan server |
Lihat halaman Error untuk panduan penanganan kesalahan secara mendetail.
Langkah Berikutnya
Setelah selesai menyiapkan, jelajahi endpoint yang tersedia:
Dapatkan suara yang tersedia untuk TTS
Konversi teks ke audio
TTS WebSocket real-time
Ekstrak teks dari file audio
STT WebSocket real-time
Untuk pertanyaan atau masalah terkait API, hubungi kami di api@moknah.io.