APIキーの誤りでChatGPT／Claude／Geminiが呼び出せないときの原因切り分け5つの考え方

コードを書き終え、プロンプトも設定したのに、いざ実行するとすぐエラー：Invalid API key、401、403、Access denied……まるで「自分は何も間違っていないのに」と言いたくなる。こうした問題はChatGPT、Claude、GeminiのAPI呼び出しで最もよく起きる。Midjourneyも、第三者のインターフェース経由で中継して使うなら同様にハマりやすい。

1 キーを貼る場所を間違えた／空白が混ざっている

一番多い落とし穴：コピー時に改行や前後の空白まで一緒に持ってきてしまう、またはKeyをBase URLの欄に入れてしまう。Keyをもう一度コピーし直して、先頭と末尾の文字を手動で確認するのがおすすめ。

2 環境変数が反映されていない

exportしたつもりでも実はサービスを再起動していない；ローカルでは動くのに、サーバーにデプロイすると失敗する。起動時に「KEYの長さを読み取れているか」を1行プリントするほうが、当て推量よりずっと早い。

3 間違ったプロジェクト／アカウント権限を使っている

プラットフォームによってはKeyが「プロジェクト／組織」に紐づいており、プロジェクトを切り替えると即401になる；また、うっかりKeyを削除・無効化している場合もある。コンソールで状態を確認し、意地になって悩まないこと。

4 ネットワークまたは地域によるアクセス制限

403は必ずしもKeyの誤りとは限らず、ネットワークでブロックされていたり、出口IPがクリーンでない可能性がある。まず公式コンソールのテスト機能でKeyを検証してから、ネットワークを切り分ける。

5 依存関係／ビルドの問題がKeyエラーに見える

Nodeプロジェクトで、依存関係の競合（ERESOLVE）、存在しないバージョン（ETARGET）、ディレクトリ残骸（ENOTEMPTY）などが原因でリクエストライブラリが正常に送信できず、最終的に一律で「認証失敗」と出てしまうケースを見たことがある。本当に腹が立つ。まずビルドをクリーンに通してからKeyを判断する。

クイック自己診断チェックリスト

• 同じKeyで公式サンプル／コンソールでは成功するか
• Keyに空白がないか、期限切れでないか、無効化されていないか
• 環境変数が実行プロセス内に実在しているか
• エラーコードが401か403かを分けて対応する
• 依存関係のインストールがエラーなしで終わってからサービスを起動しているか

サブスク、決済、地域制限、アカウント異常などで何度も消耗しているなら、時間を節約してTitikeyを見て、より確実な解決ルートとツール一覧を確認するといい。ムダにハマらないだけで、労力をかなり節約できる。