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
- Log in op je Moknah-dashboard
- Abonneer je op het Pro-abonnement of neem contact op met Verkoop voor zakelijke toegang.
- Ga naar API
- Klik op API-sleutels beheren
- Klik op Nieuwe sleutel
- Kopieer je sleutel en bewaar deze 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 |
Bekijk de pagina Fouten voor uitgebreide richtlijnen voor foutafhandeling.
Volgende stappen
Nu je alles hebt ingesteld, kun je de beschikbare endpoints verkennen:
Beschikbare stemmen voor TTS ophalen
Tekst omzetten naar audio
Realtime WebSocket-TTS
Tekst uit audiobestand halen
Realtime WebSocket-STT
Voor vragen of problemen met betrekking tot de API kun je contact met ons opnemen via api@moknah.io.