Codici di errore API
I codici di errore più comuni durante le chiamate alla Kimi API e come risolverli.
Riferimento dei codici di errore
| Codice di errore | Significato | Soluzione |
|---|---|---|
| 400 | Bad Request | Verifica il formato del corpo della richiesta, i nomi e i tipi dei parametri. Cause più frequenti: JSON malformato, parametri obbligatori mancanti, valori fuori intervallo. |
| 401 | Unauthorized | Controlla che l'API Key sia corretta, non scaduta e non disabilitata. Conferma il formato dell'header: Authorization: Bearer <your-api-key>. |
| 403 | Forbidden (saldo insufficiente) | Saldo dell'account esaurito: ricaricalo dalla console. L'account potrebbe inoltre essere soggetto a restrizioni; in tal caso contatta l'assistenza. |
| 404 | Not Found | Verifica il percorso URL della richiesta e il nome del modello. Conferma che l'endpoint sia https://api.moonshot.ai/v1/.... |
| 429 | Too Many Requests | rate limit superato. Riduci la frequenza, implementa un backoff esponenziale oppure contatta l'assistenza per limiti più elevati. |
| 500 | Internal Server Error | Problema temporaneo del server: riprova più tardi. Se persiste, contatta [email protected] indicando il request_id. |
Suggerimenti generali per la risoluzione dei problemi
- Leggi il messaggio di errore completo: il JSON di risposta include
error.messagecon una descrizione dettagliata. - Annota il request_id: aiuta l'assistenza a individuare rapidamente il problema.
- Consulta la documentazione ufficiale: assicurati che le chiamate siano conformi alla documentazione su platform.kimi.ai.
- Implementa una logica di ripetizione: per gli errori 429 e 500, utilizza un backoff esponenziale.