ChatGPT・Claude・GeminiのAPIキーエラーを調べる5つの切り分け思考＋ついでにMidjourneyのよくある切断も解決

ChatGPT、Claude、Geminiにコードで連携するとき、いちばんイライラするのはモデルが賢くないことじゃなく、そもそも反応しないこと：401、403、429が順番にやってくる。以下の切り分けは自分がいちばんよく使っていて、だいたい「APIが通らない」をオカルトから現実に引き戻せる。

タイプ1のエラー：401 無効なキー／署名が違う

invalid_api_key、Unauthorizedが見えたら、まず絶望しなくていい。十中八九、コピー時に余計な空白が入った、プレフィックスが足りない、あるいはテスト環境のKeyを本番に突っ込んだ――などが原因だ。

• Keyが正しいプラットフォーム発行か確認：OpenAI／Anthropic／Googleを混ぜて使わない
• リクエストヘッダーを確認：Bearer形式が正しいか
• 最小構成のリクエストで検証する。最初からパラメータを盛りすぎない

タイプ2のエラー：429 レート制限／枠（クォータ）切れ

429はネットワーク問題に見えるが、実際は「使いすぎ」が原因であることが多い。

• 並列数を抑え、指数バックオフでリトライする
• 請求とクォータを照合する。GeminiとClaudeはプロジェクト／組織の選択ミスに注意
• 長文は可能なら分割する。プロンプトはKISS原則で：シンプルなほうが安定する

タイプ3のエラー：403 地域制限／リスク制御によるブロック

403は多くの場合、権限がないのではなく、プラットフォーム側があなたを「怪しい」と判断している。社内ネットワーク、データセンターIP、頻繁なノード切り替えは引っかかりやすい。

• 出口IPを固定し、プロキシをいじり回さない
• コンソールの許可元／セキュリティ設定を確認する
• リクエスト内のモデル名のスペルを正しくする。スペルミスでも権限なし扱いになることがある

タイプ4のエラー：接続タイムアウト／DNS異常

Webサイトが開けるからといってAPIが通るとは限らない。DNS、TLS、会社のファイアウォールなどが邪魔をすることがある。

• ローカルでcurl直叩きテストし、コード問題かネットワーク問題か切り分ける
• パブリックDNSに変える、または一時的にスマホのテザリングで比較する
• システム時刻が正確か確認する。時刻がずれるとSSLが不安定になる

Midjourneyのよくある切断はどう対処する？

Midjourneyは主にDiscordで使うため、よくあるのはInteraction Failed、権限喪失、またはチャンネルが利用不可になるケース。

• 権限のあるチャンネル／サーバー内で使っているか確認する
• Discordを再ログインし、キャッシュをクリアする。たまにDiscord側が詰まっているだけのことがある
• 出所不明な「代理API」は使わない。画像生成より先にBANされる

いまサブスク、支払い、地域制限、アカウント異常といった、より「現実的」な問題で詰まっているなら、Titikeyを見てみるといい。エラーに正面衝突するより、遠回りを減らすほうが時間の節約になる。