> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# よくある API エラー

> エラーコード、プロトコル、Request ID から NexusAPI の問題を切り分けます。

エラー全文、Request ID、時刻、モデル、endpoint を先に保存してください。パラメーター、プロトコル、会話互換性の問題は、連続再試行では解決しません。

## `status_code=500, not implemented`

Anthropic 型 Claude チャネルを `/v1/responses` で呼び出した場合、このエラーは**プロトコル不一致**です。一時的な上流障害ではありません。

1. 自作アプリでは `/v1/chat/completions` を使用します。
2. Claude Code では[Claude Code ガイド](/ja/tools/claude-code)の Messages 設定を使います。
3. 同じリクエストをそのまま再送しません。

## HTTP ステータス

| コード             | よくある原因                      | 最初の対応                               |
| --------------- | --------------------------- | ----------------------------------- |
| 400             | モデル、endpoint、パラメーター、会話状態が不正 | プロトコル確認後、新しい会話で最小テスト。               |
| 401             | Key の欠落、無効、期限切れ、無効化         | Key と Bearer 形式を再確認。                |
| 403             | グループ、制限、IP、アカウント、上流拒否       | Key の設定とグループを確認。                    |
| 404             | パス誤りまたは `/v1` 重複            | 実際の URL を確認。                        |
| 429             | 頻度・同時実行数の制限                 | 同時実行を減らし `Retry-After` に従う。         |
| 500 / 502 / 503 | 一時的な処理・上流問題                 | 10～30 秒待って一度だけ再試行。                  |
| 504 / 524       | 待機タイムアウト                    | 必要に応じてコンテキストや出力を短くし、Request ID を保存。 |

## その他のメッセージ

* **`no available channel`**：Key のグループに、そのモデルの有効な経路がありません。正確な ID、グループ、マーケットプレイスを確認してください。
* **`Concurrency limit exceeded for user`**：実行中のリクエストを待ち、クライアントの並列数を下げます。
* **`Content block not found`**：長い会話、ツール呼び出し、ストリーム中断でよく発生します。[Content block not found](/ja/faq/content-block-not-found)を参照してください。
* **画像のエラー／タイムアウト**：画像モデル、Images endpoint、パラメーターを確認し、同じ画像タスクをすぐに再送しないでください。

想定外の請求は同じ期間の Request ID とログで照合します。通常のリクエストをプラットフォームが自動再試行するとは限りません。