コードを書いてChatGPT/Claude/GeminiのAPIにつないだり、Midjourneyで一気に生成したりするとき、いちばん厄介なのは使い方が分からないことじゃなくて、エラーが「人間の言葉っぽいのに肝心なことを言い切らない」こと。そこで、よくある落とし穴を症状別に整理して、チェックリストにまとめた。これをそのままなぞれば、だいたい原因を特定できる。
エラー1 Invalid API key / 401 認証失敗
こういうのは大抵、手が滑ったというより「鍵穴」を間違えている。
- 正しいプラットフォームのKeyか確認：OpenAI、Anthropic、Googleはそれぞれ別のKeyを使うので、混用しない。
- 空白と改行を取り除く：環境変数にコピペするときに改行が混ざりやすい。
- リクエスト先とHeaderを確認：base_urlの誤り、AuthorizationにBearerがない、などは容赦なく弾かれる。
- 権限と利用枠：モデルによっては別途有効化が必要。アカウントの未払い／請求先未登録も「Keyが無効」っぽく見える。
エラー2 403 / 429 アクセス制限またはレート超過
だいたい最初にネットワークと地域を疑って、その次に自分が無限ループを書いてないか疑う。
- 403 地域または不正検知：安定したネットワーク環境に切り替え、IPの頻繁な切り替えは避ける。社内ネット／学内ネットもブロックされやすい。
- 429 速すぎる：リトライとバックオフ（例：1秒、2秒、4秒待つ）を入れ、並列数を上げすぎない。
エラー3 プラグイン導入時にETARGET / ERESOLVE / ENOTEMPTY
ボットやワークフロー連携のために依存関係を入れようとして、パッケージマネージャで詰まり、キーボードを叩き割りたくなる人が多い。
- ETARGET：そのバージョン番号が存在しない。実際に公開されているバージョンにするか、npm/yarnをアップグレードする。
- ERESOLVE：依存関係の衝突。lockファイルを消してみる。必要ならlegacy-peer-depsを使う。
- ENOTEMPTY：ディレクトリが消し切れていない。node_modulesを削除してから入れ直せば大人しくなる。
Midjourneyのよくある不具合：Interaction failed または待ち行列が長すぎる
- Interaction failed：ネットワークの揺らぎやDiscordの重さで起きがち。コマンドを再送する、チャンネルを変えて試す。
- 待ち行列／速度制限：混雑時間帯は無理に突っ込まない。並列を落とすか、より「ゆるい」生成ペースにする。
アカウント環境、サブスクの導線、ツールの入口を探してリンクをあちこち掘っているなら、ついでにTitikeyを覗いてみるといい。よく使うAIツールと解決策を一括で整理できて、浮いた時間で画像をもう2枚は増やせる。
