Moknah Docs
Gratis starten
API-referentie

Aan de slag

Alles wat je nodig hebt om je eerste API-verzoek te doen

Basis-URL's

Moknah biedt twee soorten endpoints, afhankelijk van je gebruikssituatie:

Standaard REST API (voor afzonderlijke verzoeken):

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

Realtime WebSocket API (voor continue streaming):

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

Authenticatie

De Moknah API gebruikt API-sleutels voor authenticatie. Neem je API-sleutel op in de Authorization -header met het Bearer -schema bij elk HTTP-verzoek en elke WebSocket-handshake.

Authorization: Bearer YOUR_API_KEY

Je API-sleutel ophalen

  1. Log in op je Moknah-dashboard
  2. Abonneer je op het Pro-abonnement of neem contact op met Verkoop voor zakelijke toegang.
  3. Ga naar API
  4. Klik op API-sleutels beheren
  5. Klik op Nieuwe sleutel
  6. Kopieer je sleutel en bewaar deze veilig
Houd je sleutel veilig

Stel je API-sleutel nooit bloot in client-side code of openbare repositories. Behandel deze als een wachtwoord.

Snel HTTP-voorbeeld

Hier is een volledig voorbeeld om spraak uit tekst te genereren met de standaard REST API:

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 opgeslagen!")
else:
    print(f"Fout: {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();
    // Gebruik de audio-blob
    console.log("Audio gegenereerd!");
} else {
    const error = await response.json();
    console.error(error);
}

Antwoordformaat

Succesvolle antwoorden

Succesvolle antwoorden verschillen per endpoint:

  • TTS genereren (POST): Retourneert volledige binaire audiogegevens in het gevraagde output_format (standaard audio/mpeg)
  • TTS-stream (WSS): Streamt continu binaire MP3-fragmenten zodra ze worden gegenereerd
  • Andere endpoints: Retourneert gestructureerde JSON-gegevens

Rate-limitheaders (alleen HTTP)

Elke HTTP-respons bevat informatie over de rate limit (WebSockets dwingen limieten af door verbindingen te sluiten):

Header Beschrijving
RateLimit-Limit Maximaal aantal verzoeken per minuut
RateLimit-Remaining Resterende verzoeken in huidig tijdvenster
RateLimit-Reset Unix-tijdstempel waarop de limiet wordt gereset
Moknah-Credits-Remaining Je resterende creditsaldo

Veelvoorkomende foutcodes

Code Type Beschrijving
400 INVALID_REQUEST Ongeldige parameters of onjuist geformatteerde JSON
401 UNAUTHORIZED Ongeldige of ontbrekende API-sleutel
402 INSUFFICIENT_CREDITS Account heeft onvoldoende credits
429 RATE_LIMIT_EXCEEDED Te veel verzoeken (HTTP)
4290 CONCURRENT_LIMIT Te veel actieve verbindingen (WSS)
500 INTERNAL_SERVER_ERROR Serverfout
Meer informatie

Bekijk de pagina Fouten voor uitgebreide richtlijnen voor foutafhandeling.

Volgende stappen

Nu je alles hebt ingesteld, kun je de beschikbare endpoints verkennen:

POST Stemmen ophalen

Beschikbare stemmen voor TTS ophalen

POST Spraak genereren

Tekst omzetten naar audio

WSS Spraak streamen

Realtime WebSocket-TTS

POST Spraak transcriberen

Tekst uit audiobestand halen

WSS Transcriptie streamen

Realtime WebSocket-STT

API-ondersteuning

Voor vragen of problemen met betrekking tot de API kun je contact met ons opnemen via api@moknah.io.