ChatGPT／Claude／Gemini／MidjourneyのAPIで401・403・429が出たときの切り分けチェックリスト

自動化ライティングやボット、RAG一式をつないでいて、いちばん崩壊するのは「効果がいまいち」なことじゃなく、APIが突然401/403/429を顔面に投げつけてくること。自分もハマった：Keyは間違ってないのにエラーになる。まるで空気と口論してるみたいだ。

まずは頻出エラー3種類を理解する

• 401 Unauthorized：Keyが無効／貼り付け時に余計な空白が入った／別プロジェクトのKeyを使っている
• 403 Forbidden：地域・権限・組織ポリシーによる制限、またはアカウントで該当機能が有効化されていない
• 429 Too Many Requests：レート制限に抵触／同時実行が高すぎる／クォータやレート上限に到達

ChatGPTのAPIエラーのよくある原因

自分がいちばんやらかしがちなのは：環境変数のKeyの前後に改行が混ざっていたこと。それと、請求設定ができていないのに「使えるならOK」と思い込んでいたこと。429が出たら、並列数を下げて、リトライと指数バックオフを入れるだけで体感はすぐ正常に戻る。

Claudeは権限で詰まりやすい

Claudeの403は、多くの場合あなたの書き間違いではなく、アカウント／地域／企業ポリシーが通してくれないのが原因。モデル名の書き間違いでも疑心暗鬼になるので、リクエストのモデル欄をもう一度確認するのがおすすめ。

Geminiはクォータとプロジェクト設定が定番

Geminiで429が出ても急いでモデルを罵らず、まずプロジェクトのクォータ、呼び出し頻度の制限、そしてKeyに紐づくAPIが有効化されているかを確認する。Keyだけ作って、コンソール側で該当サービスを有効にし忘れる人もいる。

MidjourneyはDiscord側の問題っぽいことが多い

Midjourney自体は従来のAPIフローではなく、Discord上のやり取りが中心。「使えない」のよくある原因は、チャンネル権限が付与されていない／ボットがサーバーにいない／コマンド形式が違う／レート制限にかかっている、など。プロンプトを何度も変えるより、まずボットがあなたのチャンネルを見えているか確認するほうが確実。

自分の万能チェック手順

• Keyをもう一度コピーし直し、前後の空白と改行を手動で削除
• ネットワーク環境が安定しているか確認（直結とプロキシを行ったり来たりしない）
• 並列数を1まで落としてテストし、そこから段階的に戻す
• ステータスコードだけを見ず、レスポンス本文のエラーフィールドをきちんと読む

サブスク、クォータ、地域制限といった「見えないハードル」でまだ迷っているなら、Titikeyでより詳しい実践チュートリアルやツール整理を見てみると、無駄な遠回りをかなり減らせる。