ChatGPT・Claude・GeminiのAPIキー無効／403アクセス制限の切り分けチェックリスト

自動化スクリプトやBotを作ったり、ワークフローに組み込んだりする時に一番つらいのはコードを書くことじゃなく、突然API key invalid、401、403、ネットワークタイムアウトが出てくること。慌てなくていい。この記事では、私がハマった順に「これを見て確認すれば原因に辿り着ける」チェックリストを用意した。ChatGPT、Claude、Gemini共通で使える。

まずはエラーの種類を見よう　いきなり再インストールするな

多くの人があらゆる問題を「キーが間違っている」と決めつけて、無駄に苦労する。

• 401：キーが無効／付け忘れ／形式の打ち間違い／プロジェクトが有効化されていない
• 403：権限不足／地域・リスク管理の制限／クォータやポリシーによるブロック
• 429：レート制限、またはクォータの使い切り
• タイムアウト/ENOTFOUND：ネットワーク／DNS／プロキシの問題。キーとは無関係

APIキー無効のよくある原因

いくつかのプラグインの切り分け事例で言及されている「APIキーエラー」や依存設定の落とし穴も踏まえて、最も多いのはこのあたり：

• 余計な空白や改行を一緒にコピー：特に環境変数で、末尾の空白ひとつで人生を疑う
• 別プラットフォームのKeyを使っている：OpenAI／Anthropic／GoogleのKeyは混用できない。GeminiのKeyをClaude設定に突っ込まない
• リクエストヘッダーの書き間違い：Authorizationのプレフィックス、Headerフィールド名の大文字小文字、Bearerの書き忘れ
• プロジェクトで課金/権限が有効化されていない：Key自体は本物でも、アカウント側で該当API権限が有効でないと拒否される

403アクセス制限は地域と出口を重点的に確認

403が一番厄介なのは、「具体的にどこがダメか」を教えてくれないことが多い点。私の経験では、まず出口IPとプロキシルールを確認し、それからアカウント権限を確認する。

• 同じマシンでも：ブラウザで開ける＝サーバーからアクセスできる、とは限らない。サーバーの出口が弾かれているケースが多い
• プロキシ分流：リクエストが本当にプロキシ経由か要確認。よくあるのは「ローカルはOK、本番は落ちる」
• 企業ネットワーク：会社のゲートウェイ/セキュリティ機器がAIドメインを遮断することがある。最速検証はスマホのテザリングに切り替えること

MidjourneyはAPIを使わないが、検証失敗の小さな落とし穴はある

Midjourneyは主にDiscord側で起きる：アカウントが認証完了していない、チャンネル権限が不適切、Botコマンドが使えない。「生成できない／利用不可」に遭遇したら、まずDiscordアカウント状態、サブスクが有効か、そして正しいMJチャンネルまたはBotとのDMでコマンドを送っているかを確認しよう。

ハマりを減らすなら中間レイヤーで一元管理

ChatGPT・Claude・Geminiを同時に使うなら、キー、ルーティング、リトライ戦略を集中管理するのがおすすめ。いくつかのオープンソースのゲートウェイ的な考え方（既存APIを統一プロトコルに変換して接続する）は「入口ひとつで全モデルを管理」するのに向いていて、少なくとも大量のスクリプトでKeyをあちこち直す羽目にならない。

サブスク、ネットワーク、地域の利用可否といったより現実的な問題を扱っているなら、Titikeyも覗いてみるといい。私自身、支払いと可用性の厄介な問題に当たった時は、まずあそこで解決策や照合用チェックリストを探すことが多い。