Moknah Documenti
Inizia gratis
Riferimento API

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

  1. Accedi al tuo Dashboard di Moknah
  2. Abbonati al piano Pro o contatta le Vendite per l'accesso aziendale.
  3. Vai a API
  4. Clicca su Gestisci chiavi API
  5. Clicca su Nuova chiave
  6. Copia e conserva la tua chiave in modo sicuro
Mantieni sicura la tua chiave

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
Scopri di più

Consulta la pagina Errori per indicazioni dettagliate sulla gestione degli errori.

Prossimi passi

Ora che è tutto pronto, esplora gli endpoint disponibili:

POST Elenca voci

Ottieni le voci disponibili per il TTS

POST Genera voce

Converti testo in audio

WSS Streaming vocale

TTS WebSocket in tempo reale

POST Trascrivi voce

Estrai testo da file audio

WSS Streaming trascrizione

STT WebSocket in tempo reale

Supporto API

Per domande o problemi relativi all'API, contattaci all'indirizzo api@moknah.io.