Keyをコピーして入れたのに、実行した瞬間に401、invalid_api_key、APIキーエラー? 人生を疑わなくていい。こういうのは何度も踏んできたけど、実は「Keyが違う」んじゃなくて「使い方が違う」ことが多い。
最もよくある3つの落とし穴
コピー時に空白や改行が混ざる
管理画面からKeyをコピーすると、末尾にスペース/改行が入りやすい。いったんプレーンテキストに貼って確認してから貼り直すと、成功率が目に見えて上がる。
プラットフォームを間違えた/権限を取り違えた
ChatGPTアカウント=OpenAI APIアカウントではない。ClaudeやGeminiも同様で、チャット製品が使えるからといってAPIが通るとは限らない。該当するコンソールでKeyを作成しているか、そしてプロジェクト・請求(課金)・クォータが有効になっているかを確認しよう。
環境変数が反映されていない
多くのエラーは「プログラムがそもそもKeyを読めていない」ことが原因。正しい変数名を使っているか確認し、ターミナル/サービスを再起動して再試行。Nodeプロジェクトならdotenvの読み込みも忘れずに。


