API-Fehlercodes
Häufige Fehlercodes bei der Nutzung der Kimi API und ihre Behebung.
Referenz der Fehlercodes
| Fehlercode | Bedeutung | Behebung |
|---|---|---|
| 400 | Bad Request | Format des Anfragetexts sowie Parameternamen und -typen prüfen. Häufige Ursachen: fehlerhaftes JSON, fehlende Pflichtparameter, Werte außerhalb des zulässigen Bereichs. |
| 401 | Unauthorized | Sicherstellen, dass der API Key korrekt, nicht abgelaufen und nicht deaktiviert ist. Header-Format prüfen: Authorization: Bearer <your-api-key>. |
| 403 | Forbidden (insufficient balance) | Kontoguthaben aufgebraucht – in der Konsole aufladen. Möglicherweise ist das Konto auch eingeschränkt; wenden Sie sich bei Bedarf an den Support. |
| 404 | Not Found | URL-Pfad der Anfrage und Modellnamen prüfen. Sicherstellen, dass der Endpunkt https://api.moonshot.ai/v1/... lautet. |
| 429 | Too Many Requests | Rate Limit überschritten. Frequenz verringern, exponentielles Backoff einsetzen oder den Support für höhere Limits kontaktieren. |
| 500 | Internal Server Error | Vorübergehendes Serverproblem – später erneut versuchen. Falls es weiterhin auftritt, wenden Sie sich mit der request_id an [email protected]. |
Allgemeine Tipps zur Fehlersuche
- Vollständige Fehlermeldung prüfen: Das Antwort-JSON enthält unter
error.messageeine ausführliche Beschreibung. - request_id notieren: Hilft dem Support, das Problem schnell einzugrenzen.
- Offizielle Dokumentation heranziehen: Stellen Sie sicher, dass Ihre Aufrufe der Dokumentation unter platform.kimi.ai entsprechen.
- Wiederholungslogik einbauen: Setzen Sie bei den Fehlern 429 und 500 exponentielles Backoff ein.