ChatGPT・Claude・GeminiのAPIで「APIキー無効」エラーが出るときの切り分けチェックリストと即効修正

自動化コンテンツ、ボット、RAGを作るときに、いちばん多くていちばん腹が立つエラーが「APIキー無効」「401 Unauthorized」です。さっきコピーしたばかりのKeyなのに、どうして認識されないのか？ 自分が踏んだ落とし穴を汎用チェックリストとしてまとめました。ChatGPT、Claude、GeminiのようなAPIはだいたい共通で使えます。Midjourneyはアカウント/呼び出し方法の問題が多いですが、同じ考え方で切り分けできます。

まずは正しいKeyと正しい入口を使っているか確認

多くの「無効」は実は「使う場所を間違えている」だけです。たとえばテスト環境のKeyを本番に投げたり、古いKeyを新しいプロジェクトに貼り付けたり、あるいはモデル提供元を取り違えたり（OpenAIのKeyでClaudeを叩けば、当然爆発します）。

• Keyが該当プラットフォームで発行されたものか確認し、余計な空白や改行をコピーしていないかチェック
• リクエスト先が正しいAPIドメインとバージョンになっているか確認
• フロントエンドコードにKeyをベタ書きしない。漏えいするとプラットフォーム側で即BANされることがある

401/403は手元のミスではなく、権限や地域制限のことが多い

課金が有効化されていない、認証が通っていない、地域ポリシーで制限されている――こういう場合は403/401が返り、見た目はKey間違いでも実態は「資格がない」だけです。

• 利用可能な支払い方法が紐づいているか／請求ステータスが正常か確認
• 社内ネットワーク、プロキシ、クラウドサーバーのIPがリスク判定に引っかかっていないか確認
• GeminiやClaudeで地域制限に当たる場合は、準拠したネットワーク環境に切り替えるほうが効果的

429（レート制限）は力技で殴らない。呼び出し方を賢くする

429は悪い知らせではなく、リクエストが強すぎるという合図です。連打を続けると、むしろ遅くなります。

• リトライとバックオフ（1秒、2秒、4秒…）を入れる
• 並列数を下げ、バッチ処理はキューに変更する
• キャッシュできるものはキャッシュし、毎回モデルに再計算させない

連携ツールを使うと安定する：たとえばMCPでAPI接続を標準化

Claudeで「ツール呼び出し」を使っているなら、よく使うAPIをMCPサービスとしてパッケージ化するのがおすすめです。mcp-gatewayのような仕組みは、パラメータの渡し間違いによる謎エラーを減らし、保守も楽になります。

サブスク、支払い、地域ネットワークといった「技術以外の落とし穴」で詰まっているなら、Titikeyを見に行くのがおすすめです。反復試行を続けるより、たいてい早く解決できます。