ChatGPT・Claude・GeminiのAPIキーエラー 5つの切り分けポイント：401 / 403 / 429を解決

ChatGPT、Claude、GeminiのAPIにコードでつなぐとき、一番イライラするのは業務ロジックじゃなくて、開始早々401/403/429を投げつけられること。焦らないで。この手の「APIキーエラー」は大抵ほんとに壊れてるわけじゃなく、設定の細部が人をからかってるだけ。

1 401 invalid_api_key まずはコピペ方法を疑う

いちばん多く見た事故は：キーに余計な空白が入る、プレフィックスが抜ける、テスト環境のkeyを本番に入れる。おすすめは「最小再現」を作ること。リクエストは1行だけ、シンプル（KISS）に保って、山ほどある業務コードの中で針を探すのはやめよう。

2 403 権限不足 たいていはプロジェクトかモデルが有効化されていない

ClaudeやGeminiは、権限をプロジェクト・リージョン・モデルのホワイトリストに紐づけることがある。選んだモデルがそのKeyで使えるか、コンソールに「API/請求アカウントの有効化が必要」といった表示がないか確認しよう。

3 429 rate limit コードがダメなんじゃなく、枠や同時実行が原因

429はよくあるのが2つ：リクエストが密すぎる、クォータを使い切った。リトライは指数バックオフにして、ついでに同時実行数の上限も入れると、すぐかなり良くなる。

4 環境変数が効いていない ローカルは動くのに本番で全滅

Node/Pythonでよくあるのは、ENVが注入されていない、コンテナを再起動していない、CIで変数名を打ち間違える、など。依存ツールのトラブルシュートと同じ考え方で：まず「キーが本当に読み込まれているか」を確認してから、ネットワークやコードの話に進もう。

5 ネットワークと地域制限 403が出口のない迷路みたいに見える

社内プロキシ、クラウドサーバーの出口、地域ポリシーが原因で、リクエストが「権限がない」ように見えることがある。切り分けの順番はだいたいこう：

• 同じマシンでcurl直叩きが成功するか
• ネットワークや出口ノードを切り替えて再試行
• WAF/プロキシにHeaderを書き換えられていないか確認

Midjourneyの小さな違い

Midjourneyは主にDiscordのエコシステム上で動いていて、従来のAPI Key方式ではない；遭遇するのはDiscordの認可、チャンネル権限、ボットの利用不可などが多い。考え方は同じで、最小手順で再現して、まず権限、次にネットワークを疑う。

サブスク、ネットワークノード、アカウントの地域といった、より「玄学」っぽい問題にハマっているなら、Titikeyを見てみるといい。多くの落とし穴は、より手間のかからない一式の方案で回避できる。