エラーとデバッグ

RouteAPI はできるだけ統一されたエラー構造を返し、クライアントがエラーの発生元と処理方法を判断できるようにします。

標準エラー構造

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

よくあるステータスコード

ステータスコード	種類	よくある原因	推奨される処理
400	リクエストエラー	パラメータ形式エラー、モデルがパラメータ非対応	リクエスト本文とモデル能力を確認します
401	認証エラー	Token の欠落、誤り、または削除済み	Authorization を確認します
402	残高エラー	ユーザー残高不足または Token クォータ消費済み	チャージまたはクォータ調整を行います
404	パスエラー	Endpoint が存在しない	URL を確認します
429	レート制限	ユーザー、Token、またはシステムのレート制限	同時実行数を下げるか、制限を調整します
500	システムエラー	RouteAPI 内部エラー	サービスログを確認します

調査順序

1. リクエスト URL、Token、モデル ID を確認します。
2. Token 所有ユーザーの残高、クォータ、アクセス権限を確認します。
3. コンソールの使用ログを確認し、リクエストが RouteAPI に到達しているか確認します。
4. ストリーミングリクエストの場合、クライアントが SSE を正しく処理しているか確認します。

サービス側エラーとローカルエラー

RouteAPI はゲートウェイシステムであり、エラーは 3 つの層から発生する可能性があります。

層	例
クライアント	リクエスト本文の JSON エラー、Token の欠落
RouteAPI	残高不足、権限なし
モデルサービス	サービスのレート制限、サービス利用不可、モデル停止

本番環境で調査する場合は、以下を同時に記録することを推奨します。

• リクエスト時刻
• Token またはユーザー ID
• モデル ID
• HTTP ステータスコード
• RouteAPI が返した error code
• コンソール使用ログ内のエラー情報