トラブルシューティング

残高不足

Q1: "Insufficient Balance" または "Quota Exceeded"（残高不足）

症状: 402 Payment Required または 429 Too Many Requests が返る。

• 原因:
  1. 上流の残高不足: 企業が紐付けたプロバイダー（阿里云百炼、DeepSeek 公式など）の残高切れ。
  2. ゲートウェイ制限: Cherry Studio のレート制限が一時的に発動。
• 対処:
  • モデル管理 で API Key が有効か確認。
  • 上流プロバイダー（例：阿里云百炼コンソール）で残高を確認。
  • 一時対応: グループ管理 でデフォルトモデルを残高のあるチャネルに切替。

モデルが見つからない

Q2: "Model Not Found"（モデルが存在しない）

症状: 404 Not Found と The model 'xxx' does not exist が返る。

• 原因:
  • リクエストのモデル名（例：qwen-plus）がグループの許可リストにない。
• 対処:
  1. リクエスト確認: ユーザーコードの model パラメータを確認。
  2. グループ権限確認: グループ管理 > 対象グループ > モデルルーティング でモデルを選択済みか確認。
  3. エイリアス確認: qwen-max を qwen3-max にマップしていないか確認。

認証失敗

Q3: "401 Unauthorized"（認証失敗）

症状: API が接続を拒否。

• 原因:
  • Key の入力ミス（余分な空白など）。
  • Key が無効化/期限切れ。
• 対処:
  • キー設定 で 有効状態 を確認。
  • 有効期限 を確認。
  • 必要に応じて古い Key を削除し、新しい sk- Key を発行。

有効な上流なし

Q4: "No Healthy Upstream"（有効な上流なし）

症状: 502 Bad Gateway または 503 Service Unavailable が返る。

• 原因:
  • グループに紐付いたモデルチャネルが全てオフラインまたはタイムアウト。
• 対処:
  • モデル管理 で Check をクリックして接続確認。
  • サーバーから対応プロバイダーの API（例：dashscope.aliyuncs.com）へ到達できるか確認。