Per iniziare
Tutto ciò di cui hai bisogno per effettuare la tua prima richiesta API
URL di base
Moknah offre due tipi di endpoint a seconda del caso d'uso:
API REST standard (per richieste singole):
https://moknah.io/api/v1/
API WebSocket in tempo reale (per lo streaming continuo):
wss://moknah.io/api/v1/
Autenticazione
L'API di Moknah utilizza chiavi API per l'autenticazione. Includi la tua chiave API nell'header Authorization usando lo schema
Bearer con ogni richiesta HTTP e handshake WebSocket.
Authorization: Bearer YOUR_API_KEY
Come ottenere la tua chiave API
- Accedi al tuo Dashboard di Moknah
- Abbonati al piano Pro o contatta le Vendite per l'accesso aziendale.
- Vai a API
- Clicca su Gestisci chiavi API
- Clicca su Nuova chiave
- Copia e conserva la tua chiave in modo sicuro
Non esporre mai la tua chiave API nel codice lato client o in repository pubblici. Trattala come una password.
Esempio rapido HTTP
Ecco un esempio completo per generare voce da testo utilizzando l'API REST standard:
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 salvato!")
else:
print(f"Errore: {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();
// Usa il blob audio
console.log("Audio generato!");
} else {
const error = await response.json();
console.error(error);
}
Formato della risposta
Risposte di successo
Le risposte di successo variano in base all'endpoint:
- Generazione TTS (POST): Restituisce i dati audio binari completi nell'output_format richiesto (audio/mpeg per impostazione predefinita)
- Stream TTS (WSS): Trasmette in modo continuo frammenti MP3 binari man mano che vengono generati
- Altri endpoint: Restituisce dati JSON strutturati
Header di rate limit (solo HTTP)
Ogni risposta HTTP include informazioni sui rate limit (i WebSocket applicano i limiti chiudendo la connessione):
| Header | Descrizione |
|---|---|
| RateLimit-Limit | Numero massimo di richieste al minuto |
| RateLimit-Remaining | Richieste rimanenti nella finestra attuale |
| RateLimit-Reset | Timestamp Unix di ripristino del limite |
| Moknah-Credits-Remaining | Il tuo saldo crediti rimanente |
Codici di errore comuni
| Codice | Tipo | Descrizione |
|---|---|---|
| 400 | INVALID_REQUEST |
Parametri non validi o JSON malformato |
| 401 | UNAUTHORIZED |
Chiave API mancante o non valida |
| 402 | INSUFFICIENT_CREDITS |
L'account non ha crediti sufficienti |
| 429 | RATE_LIMIT_EXCEEDED |
Troppe richieste (HTTP) |
| 4290 | CONCURRENT_LIMIT |
Troppe connessioni attive (WSS) |
| 500 | INTERNAL_SERVER_ERROR |
Errore del server |
Consulta la pagina Errori per indicazioni dettagliate sulla gestione degli errori.
Prossimi passi
Ora che è tutto pronto, esplora gli endpoint disponibili:
Ottieni le voci disponibili per il TTS
Converti testo in audio
TTS WebSocket in tempo reale
Estrai testo da file audio
STT WebSocket in tempo reale
Per domande o problemi relativi all'API, contattaci all'indirizzo api@moknah.io.