> ## 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.

# 問題の自己確認

> サポートへ連絡する前に、NexusAPI エラーを最小テストで切り分ける手順です。

設定ミスや一時的な失敗の多くは数分で範囲を絞れます。まず証拠を残し、低頻度で一度だけ最小テストを行ってください。

## 1. 証拠を保存する

クライアントを閉じる、または再試行する前に、次を記録します。

* エラー全文と Request ID
* 発生時刻とタイムゾーン
* モデル ID、endpoint、ストリーミング有無
* クライアント / SDK とバージョン

完全な API Key、パスワード、個人情報、業務内容全体は送らないでください。

## 2. 種類を確認する

| 症状                     | 最初の確認                                   |
| ---------------------- | --------------------------------------- |
| 401                    | API Key、`Bearer`、URL。                   |
| 403                    | グループ、モデル制限、IP 許可リスト、アカウント、上流拒否。         |
| 404                    | Base URL、パス、`/v1` の重複・欠落。               |
| 400                    | モデル、プロトコル、パラメーター、会話状態。                  |
| 429                    | 同時実行数と頻度。`Retry-After` を優先。             |
| 500 / 502 / 503        | 10～30 秒待って一度だけ再試行。                      |
| 504 / 524              | リクエスト量、待機時間、サービス状態。                     |
| `500, not implemented` | 再試行せず、Claude モデルを Responses で呼んでいないか確認。 |
| `no available channel` | モデル ID、グループ、現在の可用性。                     |

詳細は[よくある API エラー](/ja/faq/common-errors)を参照してください。

## 3. 最小テストをする

1. コンソールの残高と Key の状態を確認します。
2. マーケットプレイスからモデル ID を再コピーします。
3. 新しい会話で短いテキストを送ります。
4. 再試行は一度までにし、新しい Request ID を記録します。
5. コンソールログで該当記録を確認します。

新しい会話が成功すれば、元の会話状態や内容が原因の可能性があります。最小テストも失敗する場合は、次の形式で送ってください。

```text theme={"system"}
発生時刻（タイムゾーンを含む）：
Request ID：
クライアントとバージョン：
モデル：
Endpoint：
エラー全文：
断続的か継続的か：
新しい会話で確認したか：
```

Key の識別が必要なら末尾 6 文字までにしてください。