Moknah Dokumen
Mulai gratis
Referensi API

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

  1. Masuk ke Dasbor Moknah
  2. Berlangganan Paket Pro atau hubungi Penjualan untuk akses enterprise.
  3. Buka API
  4. Klik Kelola Kunci API
  5. Klik Kunci Baru
  6. Salin dan simpan kunci Anda dengan aman
Jaga Keamanan Kunci Anda

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
Pelajari Lebih Lanjut

Lihat halaman Error untuk panduan penanganan kesalahan secara mendetail.

Langkah Berikutnya

Setelah selesai menyiapkan, jelajahi endpoint yang tersedia:

POST Daftar Suara

Dapatkan suara yang tersedia untuk TTS

POST Hasilkan Ucapan

Konversi teks ke audio

WSS Streaming Suara

TTS WebSocket real-time

POST Transkripsi Ucapan

Ekstrak teks dari file audio

WSS Streaming Transkripsi

STT WebSocket real-time

Dukungan API

Untuk pertanyaan atau masalah terkait API, hubungi kami di api@moknah.io.