ChatGPT／Claude／GeminiのAPIキーエラーとアクセス制限のトラブルシュートチェックリスト

バックエンドでChatGPT、Claude、GeminiのAPIをつないだとき、いちばんありがちな失敗はモデルがダメなのではなく、APIキーの誤り、ネットワーク未接続、地域ポリシーで止められることです。MidjourneyはAPIキー方式ではありませんが、Discord上でも権限やクォータの通知に遭遇します。本質は同じで、「許可されていない」だけ。

1分セルフチェック：APIエラーの90%はここ

• キーの貼り間違い：余計なスペースや改行を一緒にコピーした／「プロジェクトキー」を「個人キー」として使っている
• キーの権限不足：課金が有効化されていない／カード未登録／組織またはプロジェクトが該当モデルに認可されていない
• 環境変数が反映されていない：サービスは再起動した？ コンテナ内とローカルで設定が別になっていない？
• プロキシにハマった：Webページが開けても、バックエンドがAPIドメインへ直通できるとは限らない。多くの人がここで詰まる

エラーメッセージ別に対処する

Unauthorized または Invalid API key と出る

平台のせいにする前に、まずコンソールでキーを再発行し、古いものは即無効化。次にリクエストヘッダで正しいフィールドを使っているか確認。ボットやプラグインを作る場合、Koishiの一部プラグインなどは、キーのフィールド名や貼り付け形式が原因でエラーになりがち。

Rate limit または Quota exceeded と出る

これは「壊れた」のではなく、使いすぎ。並列数を下げ、リトライのバックオフを入れる。安定運用したいなら、より高いクォータのプランへ。Midjourneyでもfastが尽きたときは同じで、低速の待ち行列になっても焦らない。

Network error または アクセス制限 と出る

バックエンドサーバーからcurlで対象ドメインへの直通をテストする。社内ネットワークやデータセンターの海外回線が不安定なら、モデルを変えるより回線を変えるほうが効く。ClaudeとGeminiは地域やリスク管理により敏感で、ネットワーク環境が乱れると発火しやすい。

手間を省くやり方

「とにかく使えればいい」なら、支払い・地域・回線で試行錯誤を繰り返さないこと。Titikeyを見れば、より手軽な開通・利用の方法があるので、時間を本当の制作やプロダクトに回そう。