接続のトラブルシューティング

以下の項目を順番に確認してください。一度に変更する設定は 1 つにしてください。

1. API キーを確認

  • 先頭または末尾の空白を削除します。
  • キーが有効で、有効期限内にあり、クォータが残っていることを確認します。
  • プロセスから設定済みの環境変数を参照できることを確認します。
  • キー全体をログやサポートメッセージに貼り付けないでください。

2. プロトコルと URL を確認

プロトコルBase URLクライアントが追加するリクエストパス
Chat Completionshttps://getrouter.ai/v1/chat/completions
Responseshttps://getrouter.ai/v1/responses
Claude Messageshttps://getrouter.ai/v1/messages
Geminihttps://getrouter.ai/v1beta/models/...

404 は、多くの場合、クライアントが /v1 またはリクエストパスを 2 回追加したことを示します。

3. モデルを確認

  • Models から正しいモデル ID をコピーします。
  • キーにそのモデルの使用が許可されていることを確認します。
  • モデルが対象のプロトコルと機能をサポートしていることを確認します。
  • ツールがモデル一覧を読み込めない場合は、モデルを手動で入力します。

4. よくあるステータスを確認

ステータス最初に確認する内容
400未対応フィールド、無効なリクエスト、または機能の不一致
401API キーがない、または無効
403キー、モデル、グループ、またはポリシーによる制限
404URL またはパスが不正、または不明なモデル
429残高、クォータ、同時実行数、またはレート制限
5xx一時的なアップストリームまたはゲートウェイの障害

5. 最小構成のリクエストをテスト

ツール、ファイル、画像、長いコンテキスト、JSON mode、カスタム推論設定を無効にします。短いテキストプロンプトを 1 つ送信し、高度な機能を 1 つずつ戻してください。

安全にサポートを依頼

ツールとバージョン、プロトコル、モデル ID、マスキングした Base URL 設定、HTTP ステータス、エラーテキスト、Request ID、日時とタイムゾーンを共有してください。API キー全体は共有しないでください。