エラーコード排錯
測連失敗またはチャット吹き出しのエラー時、詳細を見るをタップし、本ページのエラーコード（または文案キーワード）と照合してください。
詳細には通常次が含まれます：
- エラーコード（英語識別子、例
invalidApiKey） - エラー原因
- 試す修復
以下の「コード」は App のエラー詳細に表示される名称に準拠します。
クイック対照表
| エラーコード | ユーザー向け要約 | 優先対処 |
|---|---|---|
missingApiKey | 先に API キーを記入 | モデル接続に鍵を記入 |
invalidApiKey | 鍵が無効または期限切れ | コピー漏れを確認；コンソールで再生成 |
forbidden | アクセス拒否 | 権限、モデルが開通済みか |
regionForbidden | 地域で利用不可 | ネットワーク／プロキシ／国際サイトを変更 |
network | ネットワーク接続失敗 | ネットワーク、Base URL、ファイアウォール |
timeout | リクエストタイムアウト | ネットワーク；ローカルモデルはタイムアウトを延ばす |
modelNotFound | モデルが存在しない | モデル ID を照合 |
modelRetired | モデルが下線／廃止 | 一覧から現在使えるモデルへ |
rateLimit | 送信が頻繁すぎる | 待ってから再試行 |
freeTierQuota | 無料枠のリクエスト枠 | Please retry in … に従い待機；頻度を下げるか有料へ |
insufficientQuota | 枠不足 | チャージ／鍵を変更 |
spendingCapExceeded | 月次消費上限 | コンソールで spend cap を上げる |
providerReturnedError | 上流がエラーを返した | モデル変更／同ベンダー :free を避ける／OpenRouter BYOK |
contextLengthExceeded | コンテキスト超過 | 記憶を短縮；返信トークンを None；大コンテキストモデルへ |
anthropicMaxTokensRequired | Claude に max_tokens 不足 | モデル設定で「返信トークン」をオン |
badRequest | パラメータ誤り | パラメータと互換インタフェース形式を確認 |
serverError | サーバー側エラー | 後で再試行 |
requestFailed | リクエスト失敗 | 詳細の原文を確認 |
contentPolicy | 安全審査未通過 | 再生成／モデル変更／書き換え |
emptyContent | 返信が空 | 再試行；思考モデルのフィールドを確認 |
modelAtCapacity | モデルが満載 | 待機またはモデル変更 |
productNotActivated | 製品未開通 | コンソールでモデルを開通 |
visionUnsupported | 画像非対応 | 視覚モデルへ、または添付をオフ |
textOutputUnsupported | 文字対話非対応 | テキストチャットモデルへ；TTS／画像専用 ID を選ばない |
分類の詳解
missingApiKey
- 現象：鍵未記入でリクエスト不可。
- 対処：設定 → モデル接続 → API キーを記入。ローカル Ollama などは非空検証ならプレースホルダで可。
invalidApiKey
- 現象：401 系、鍵無効。
- 対処：空白なしで完全コピー；国内／国際サイトと鍵の対応を確認；鍵を再生成。
forbidden / regionForbidden
- 現象：403、地域制限。
- 対処：モデル権限を確認；プロキシまたは国際サイトの Base URL へ。
network / timeout
- 現象：つながらない、または長時間無応答。
- 対処：
- Base URL を確認（ローカルでスマホの
localhostは不可、PC の LAN IP を使う）。 - PC ファイアウォールでポート開放；スマホと PC を同一 Wi‑Fi。
- 弱網または遅いローカルモデル：タイムアウト延長、小モデルへ。
- Base URL を確認（ローカルでスマホの
modelNotFound
- 現象：モデル ID 誤り。
- 対処：測連後に一覧から再選択；ローカルは
ollama list／LM Studio 表示名と一致。
modelRetired
- 現象：HTTP 404、文案に
no longer available to new users/use a newer model（例models/gemini-2.5-flash-lite）。 - 区別：プロバイダが廃止／新規非公開にしたモデルで、綴りミスではない。
- 対処：モデル接続で最新一覧を取得し、稼働中の Gemini（例
gemini-flash-latest）へ。Interactions API への切替は不要。一覧：Gemini models。
rateLimit
- 対処：送信頻度を下げる；後で再試行；プランを上げる。
freeTierQuota
- 現象：Gemini などが
HTTP 429+generate_content_free_tier_requests（よく limit: 20）とPlease retry in …s。 - 区別：無料枠の毎分／毎日リクエスト回数であり、残高ゼロでもプロジェクト月次 spend cap でもない。
- 対処：提示秒数待って再試行；頻度を下げる；AI Studio 用量 を確認；より高い枠が必要なら課金／有料へ。Gemini rate limits。
insufficientQuota / spendingCapExceeded
- 区別：枠使い切り vs プロジェクト月次消費上限（後者は「後で再試行」だけではだいたい無効）。
- 対処：チャージ；またはコンソールで spend cap を調整（例 Google AI Studio Spend ページ）。
providerReturnedError
- 現象：OpenRouter などが
HTTP 429: Provider returned error（:freeでよくある）。 - 対処：後で再試行；他ベンダーの空きモデルへ；または OpenRouter BYOK。
contextLengthExceeded
- 対処：設定 → モデル設定 → 記憶の長さを短縮；「返信トークン」を None（適用時）；より大きいコンテキストのモデルへ。
anthropicMaxTokensRequired
- 対処：Claude は max_tokens 必須 → モデル設定で「返信トークン」をオンし、None にしない。
badRequest
- 対処：temperature などのパラメータを確認；第三者互換が本当に OpenAI/Anthropic 形式か。
serverError / requestFailed / modelAtCapacity
- 対処：後で再試行；エンドポイントまたはモデルを変更；続く場合はサービス事業者に詳細原文を添えて連絡。
contentPolicy
- 対処：再生成、書き換え、審査の緩いモデルへ；一部 NSFW カードは出力遮断を招きやすい。
emptyContent
- 対処：再試行；一部思考モデルは reasoning のみ返す → 詳細の完全フィールドを見るかモデル変更。
productNotActivated
- 対処：クラウドコンソールで該当製品／モデルを開通してから、現在の鍵で使う。
visionUnsupported
- 対処：視覚対応モデルへ；または画像を送らない／画像認識描写フローで純テキスト描写へ。
textOutputUnsupported
- 現象：HTTP 400、文案に
response modalitiesかつTEXT非対応（例models/gemini-2.5-flash-preview-ttsはAUDIOのみ）。 - 区別：音声合成／画像など専用モデルでチャット測連したのであり、鍵やサンプリングの誤りではない。
- 対処：モデル接続でテキストチャットモデル（例
gemini-flash-latest）へ。名称にtts、imageが付く専用 ID を選ばない。音声・画像は対応機能で設定。
ローカルモデル向け
PC 上の Ollama / LM Studio につながらない：ローカルモデル排錯。
App の測連／チャット報錯（エラーコード含む）：マニュアル · エラーコード排錯。
スクリーンショット
