Başlarken

İlk API isteğinizi yapmak için ihtiyacınız olan her şey

Temel URL’ler

Moknah, kullanım senaryonuza bağlı olarak iki tür uç nokta sunar:

Standart REST API (tekil talepler için):

https://moknah.io/api/v1/

Gerçek zamanlı WebSocket API (kesintisiz yayın için):

wss://moknah.io/api/v1/

Kimlik Doğrulama

Moknah API’si ... kullanır API anahtarları kimlik doğrulama için. API anahtarınızı şuraya dahil edin: Authorization ...kullanarak başlık Hamil her HTTP isteği ve WebSocket el sıkışması ile birlikte şema.

Authorization: Bearer YOUR_API_KEY

API Anahtarınızı Alma

1. Hesabınıza giriş yapın Moknah Paneli
2. Pro Plana abone olun veya iletişime geçin Satış kurumsal erişim için.
3. Şuraya git: API
4. Tıkla API Anahtarlarını Yönet
5. Tıkla Yeni Anahtar
6. Anahtarınızı kopyalayın ve güvenli bir şekilde saklayın.

Hızlı HTTP Örneği

İşte standart REST API’sini kullanarak metinden konuşma oluşturmaya yönelik eksiksiz bir örnek:

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("Ses kaydedildi!")
else:
    print(f"Hata: {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();
    // Ses blobunu kullanın
    console.log("Ses oluşturuldu!");
} else {
    const error = await response.json();
    console.error(error);
}

Yanıt Formatı

Başarı Yanıtları

Başarılı yanıtlar uç noktaya göre değişiklik gösterir:

• TTS Oluştur (POST): Tam ikili ses verisini (audio/mpeg) döndürür
• TTS Akışı (WSS): İkili MP3 parçalarını, oluşturuldukları anda kesintisiz olarak aktarır.
• Diğer uç noktalar: Yapılandırılmış JSON verisi döndürür

Hız Sınırı Başlıkları (Yalnızca HTTP)

Her HTTP yanıtı, hız sınırı bilgilerini içerir (WebSockets, sınırları bağlantı kapatma yoluyla uygular):

Yaygın Hata Kodları

Sonraki Adımlar

Kurulumu tamamladığınıza göre, mevcut uç noktaları keşfedin: