ChatGPT／Claude／GeminiのAPIキーエラー切り分けチェックリスト：リクエストを即復旧させる

一番つらいのはモデルが賢くないことじゃなく、やっと呼び出しコードを書き終えた瞬間にInvalid API Keyや403、あるいは「ネットワーク接続に失敗しました」と突き返されること。自分が踏んだ落とし穴をまとめて、ChatGPT OpenAI／Claude Anthropic／Geminiに共通で使える汎用チェックリストにした。ついでにMidjourneyでよくある権限問題にも触れておく。

一目で直せる3種類の問題

キーの入力ミス、または古いプロジェクトに入れている

Keyの前後に余計なスペースを貼り付けてしまったり、テスト環境のKeyを本番環境に入れてしまったりする人が多い。いったんKeyをプレーンテキストに貼って目視してから、貼り直すのがおすすめ。

誤ったエンドポイント／モデル名にリクエストしている

モデル名のスペルミスも、Keyが間違っていると勘違いしがち。力技で攻めず、「シンプルに保つ」（KISSは本当に効く）方針で、まず公式の最小サンプルリクエストを通してからパラメータを追加しよう。

環境依存で巻き込まれる

既製のプラグインやスキャフォールドを使っている場合（たとえばNode系でよくあるETARGET、ERESOLVEといった依存関係の衝突）、先に依存関係をきれいに入れ直してバージョンを揃えないと、「Keyエラー」に1時間無駄にする。

403のアクセス制限とネットワーク問題の対処

403、地域制限、あるいは「ネットワーク接続問題のトラブルシューティング」系の表示が出たら、まず社内プロキシ／ゲートウェイ／クラウドサーバーの海外向け回線を確認すること。モデルに拒否されているのではなく、あなたのネットワークがTLSやDNS（ドメイン解決）を壊しているだけ、というケースが多い。

MidjourneyはAPIを使わないが、同じようにコケるポイントがある

Midjourneyは主にDiscordで使うため、よくある問題はむしろ「正しいサーバーに入っていない」「チャンネル権限が足りない」「サブスク切れでコマンドが無反応」など。ローカルでコードをいじり倒す前に、Discordの権限とサブスク状態を確認しよう。

私がよく使うクイック切り分け手順

• 最小リクエストで結果が返るか確認
• 別回線に切り替える／社内プロキシを切って試す
• Keyを作り直して環境変数を即置き換え
• モデル名・APIドメイン・リージョン設定の整合性を確認

チャージ、サブスク、地域アクセスといった「入口で弾かれる」問題でまだ詰まっているなら、Titikeyでより手間の少ない解決策を見てみるといい。自分でも比較したが、手間が減る価値は本当にある。