よくあるエラーと解決方法
エラーが出ても慌てないでください。以下では「画面に表示されたメッセージ」ごとに分類し、それぞれに原因と対処方法を記載しています。ブラウザの Ctrl/⌘ + F でキーワード検索すると素早く見つかります。
401 / invalid token / トークン無効
原因：API キー（トークン）に問題があります。多くの場合は次のいずれかです。
- キーのコピーミス（余分なスペースが入った、文字が抜けている）
- キーがコンソールですでに削除または無効化されている
- クライアント側で入力する場所が間違っている、または
Bearerが付いていない
対処方法：
- コンソール → トークン に戻り、そのトークンが残っていてステータスが正常か確認します。
- もう一度 コピー し直し、全体をまるごと置き換えます。先頭と末尾にスペースが入らないよう注意してください。
base_urlも正しく入力されているか確認します（各クライアントのチュートリアルを参照）。
残高不足 / insufficient quota / INSUFFICIENT_BALANCE
原因：アカウントの残高、またはそのトークンの利用枠を使い切っています。
対処方法：コンソール でチャージしてください。あるいは、そのトークンに利用枠の上限が設定されていないか確認し、設定されていれば上限を引き上げます。
チャージが反映されない？
USDT / 暗号資産でのチャージはページに表示された正確な金額で支払う必要があります（多く払っても少なく払っても自動では入金されません）。金額を間違えてしまっても慌てず、支払い記録のスクリーンショットを添えてカスタマーサポートにご連絡ください。手動で対応します。
利用可能なチャネルがない / 現在のグループに利用可能なチャネルがない / no available channel
原因：リクエストしたモデルに対応するチャネルが、あなたのアカウントが属するグループ内に存在しません。当社が提供していないモデル名や、ご利用のプランに含まれていないモデル名を入力した場合によく起こります。
対処方法：
- コンソール を開いて現在利用可能なモデル一覧を確認し、その中にあるモデルを選びます。
- モデル名のスペルが完全に一致しているか確認します（大文字・小文字、ハイフンまで正確に）。
- 確認しても解消しない場合 → グループの権限に関する問題の可能性があります。カスタマーサポートにご連絡のうえご確認ください。
モデルが存在しない / model_not_found
原因：モデル名のスペルミス、またはそのモデルがあなたのグループに含まれていません。
対処方法：前項と同じです。コンソールでモデル一覧を確認し、名前を一字一句違わずクライアントに入力してください。
ストリーム切断 / stream disconnected / Connection error / 高負荷
原因：
- アップストリームのピーク時に混雑している、または一時的なネットワークの揺らぎ
- 中国国内からドイツのサーバーへ直接接続しているため、回線が時々不安定になる
対処方法：
- そのまま再試行してみてください。多くの場合は成功します。
- 頻発する場合 → 別のモデルを試してみてください（モデルが異なれば経由するアップストリームも異なります）。
- それでも改善しない場合 → スクリーンショットを添えてカスタマーサポートにご連絡ください。当社側でチャネルの状態を確認します。
リクエストタイムアウト / timeout
原因：ネットワークの問題が大半です。特に中国国内から海外へ直接接続している場合に起こります。
対処方法：再試行してください。長期間遅い場合は、アクセラレーター（高速化サービス）やプロキシ経由で接続することをおすすめします。
reasoning / 思考強度 が反映されない
原因：2 種類のインターフェースで書き方が異なり、混同すると無視されてしまいます。
| インターフェース | 正しい書き方 |
|---|---|
/v1/chat/completions | 文字列："reasoning_effort": "high" |
/v1/responses（Codex など） | オブジェクト："reasoning": { "effort": "high" } |
対処方法：使用しているインターフェースに合った書き方を選んでください。Codex では設定項目 model_reasoning_effort をそのまま使えばよく、手書きする必要はありません。
コンソール画面が 500 / 真っ白 / どこを押してもエラー
原因：ブラウザで Google 翻訳（ページ全体の自動翻訳）を有効にしているとコンソールと競合し、ページをクリックするとエラーになることがあります。
対処方法：
- そのページの Google 翻訳 をオフにし（アドレスバーの翻訳アイコン → 原文を表示）、再読み込みすれば解決します。
- サーバー側でもすでに対策を入れていますが、それでもこの種のコンソールを閲覧する際はページ全体の翻訳を有効にしないことをおすすめします。
既知の問題・対策済み
この問題についてはすでに互換対応を行っています。アップデート後もまだ発生する場合は、翻訳をオフにして一度再読み込みすればほぼ解決します。
それでも解決しない場合は？
エラー原文のスクリーンショット と 使用しているクライアントとモデル をカスタマーサポートに送っていただくと、口頭で説明するよりもずっと早く解決できます。