APIエラーコード
Kimi API の呼び出し時によくあるエラーコードと、その対処方法を説明します。
エラーコード一覧
| エラーコード | 意味 | 対処方法 |
|---|---|---|
| 400 | Bad Request(不正なリクエスト) | リクエスト本文の形式、パラメータ名、型を確認してください。よくある原因は、JSON の形式不備、必須パラメータの不足、値が許容範囲外であることです。 |
| 401 | Unauthorized(認証エラー) | API Key が正しく、有効期限切れや無効化の状態でないことを確認してください。ヘッダー形式が Authorization: Bearer <your-api-key> になっていることも確認します。 |
| 403 | Forbidden(残高不足) | アカウント残高が不足しています。コンソールでチャージしてください。アカウントに制限がかかっている可能性もあります。必要に応じてサポートへお問い合わせください。 |
| 404 | Not Found(見つかりません) | リクエスト URL のパスとモデル名を確認してください。エンドポイントが https://klmi.io/v1/... であることを確認します。 |
| 429 | Too Many Requests(リクエスト過多) | rate limit を超過しています。リクエスト頻度を下げる、指数バックオフを実装する、または上限引き上げについてサポートへお問い合わせください。 |
| 500 | Internal Server Error(サーバー内部エラー) | 一時的なサーバーの問題です。時間をおいて再試行してください。解消しない場合は、request_id を添えて [email protected] までお問い合わせください。 |
トラブルシューティングの基本
- エラーメッセージ全体を確認する: レスポンス JSON の
error.messageに詳しい説明が含まれています。 - request_id を控える: サポートが問題をすばやく特定する手がかりになります。
- 公式ドキュメントを参照する: platform.kimi.ai のドキュメントに沿った呼び出しになっているか確認してください。
- リトライ処理を実装する: 429 および 500 エラーには、指数バックオフを使用してください。