ユーザーガイド

エラーコード

LMU AI エラーコードリファレンス：401 / 403 / 404 / 429 / 5xx ステータスの意味と対処法、バッチ画像のビジネスコード、そして生のエラーテキストから対処法への逆引き。

このページは、個々の API ドキュメントに散らばっているエラーコードを1つのチートシートにまとめたものです。まず HTTP ステータスコードで大まかな分類を特定し、次に生のエラーテキストで具体的な対処法を見つけてください。

トラブルシューティングの前に request ID を記録

レスポンスヘッダー内の request ID は、問題を診断するうえで最も有用な情報です。サポートに連絡する際は、request ID と完全なエラーテキストを添えてください — 完全な API キーは送らないでください。

HTTP ステータスコード

ステータス典型的な原因対処法
400リクエストボディ、パラメータ、モデル ID またはモデルパスが無効。画像フォーマット / エンコーディングが不正リクエストを修正する — 単にリトライしない。アカウントの切り替えやリトライでは成功しません
401API キーが欠落・無効・無効化されている。Base URL がプロトコルと一致していない。IDE を再起動していないため古い設定がまだ有効キーと Base URL を確認し（API Protocols 参照）、IDE を再起動する。詳細は Issue 3
402残高不足チャージするか作業量を減らす
4032つの可能性があり、どちらもありえます：① API キーのグループで画像生成が有効になっていない。② 残高、サブスクリプション、課金資格、または権限が不足しているまずアカウントの残高とサブスクリプション状態を確認し、次にグループがその機能を持っているか確認する。両方とも問題なくてもエラーが出る場合はサポートに連絡
404OpenAI プロトコルの URL に /v1 がない、Anthropic の URL に誤って /v1 が含まれている、Gemini が /v1beta/models/... を使っていない。または現在のグループがそのエンドポイントに対応していないBase URL と完全なエンドポイントを API Protocols と照合し直す
413画像から画像へのリクエストボディが大きすぎる入力画像を圧縮する
429① 1日のクォータを使い切った。② 同時実行数、RPM、または上流のクォータが制限されているクォータ枯渇については Issue 2 を参照。レート制限の場合は指数バックオフで待機し、同時実行数と RPM を下げる
500内部エラーまたは容量エラーエラーコードと request ID を記録し、限られた回数だけリトライ
502上流の認証・権限・サービスが一時的に失敗バックオフしてリトライ。必要ならサポートに連絡
503利用可能な上流アカウントがない、または上流が過負荷。環境変数がキーを上書きしている可能性もあるまず環境変数を確認し（Issue 6 参照）、次に遅延を入れてトラフィックを下げてリトライ
504ゲートウェイまたは上流のタイムアウト新しい独立したリクエストとして出し直す

リトライすべきものと、代わりに修正すべきもの

  • リトライしない：400、401、および明示的な残高・権限・パラメータ・コンテンツポリシーのエラー — リクエスト自体が無効であり、どの上流アカウントも同じ結果を返します。まずリクエストを修正する必要があります。
  • リトライ可能：429、502、503、504、およびネットワーク切断、接続リセット、読み取りタイムアウト — すべて一時的な障害です。指数バックオフで限られた回数（推奨は2〜3回）リトライし、繰り返し呼び出しへの課金を避けてください。429 の場合はさらに同時実行数と RPM を下げてください。

この分類は画像 API のリトライガイダンスに由来します — Gemini Image · リトライガイダンス を参照。

各 API の完全なエラー説明：Gemini Image、GPT Image、Grok Image、Gemini Batch Image。

ビジネスエラーコード（バッチ画像）

HTTP ステータスコードに加えて、Gemini Batch Image API はビジネスエラーコードも返します。コンソールには error code: BATCH_IMAGE_XXX と request ID として表示されます。

エラーコードHTTP意味対処法
BATCH_IMAGE_DISABLED404バッチ画像生成がグローバルに無効化されているエラーコードと request ID を管理者に送る
BATCH_IMAGE_GROUP_DISABLED403現在のキーのグループがバッチ画像を許可していない、または Gemini グループではないキーを変更するか、管理者にグループ権限の有効化を依頼
BATCH_IMAGE_NO_ACCOUNT_AVAILABLE502現在利用可能なバッチ実行リソースがないrequest ID を保存し、管理者に連絡
BATCH_IMAGE_SETTLEMENT_PRICING_MISSING400バッチモデルに課金価格が設定されていない管理者にモデル価格の設定を依頼
BATCH_IMAGE_INVALID_MODEL400モデルが指定されていないバッチモデルリストのモデルを使用する
BATCH_IMAGE_INVALID_ITEMS400items、解像度、またはリクエストフィールドが無効リクエストボディを確認。現在は 1K のみ対応
BATCH_IMAGE_DUPLICATE_CUSTOM_ID400custom_id が重複しているバッチ内で一意になるようにする
BATCH_IMAGE_PROMPT_TOO_LONG400プロンプトが長すぎるプロンプトを短くする
BATCH_IMAGE_TOO_MANY_OUTPUT_IMAGES400展開後の画像数が上限を超えたitems または output_count を減らす
BATCH_IMAGE_INVALID_REFERENCE_IMAGE400参照画像のフォーマット、サイズ、または URI が無効MIME、Base64、file_uri を確認
BATCH_IMAGE_INSUFFICIENT_BALANCE402課金を予約するには残高が低すぎるチャージするか作業量を減らす
BATCH_IMAGE_IDEMPOTENCY_CONFLICT409同じ冪等キーが異なるリクエストボディに対応している新しい Idempotency-Key を使う
BATCH_IMAGE_PROVIDER_SUBMIT_FAILED502上流のバッチタスク作成に失敗request ID を保存し、限られた回数リトライするか管理者に連絡
BATCH_IMAGE_QUEUE_FAILED502非同期タスクサービスが一時的に利用不可request ID を保存し、管理者に連絡
BATCH_IMAGE_NOT_READY409タスク完了前にダウンロードを試みたステータスが completed になるまで待つ
BATCH_IMAGE_OUTPUT_DELETED410出力がすでにクリーンアップされているダウンロードできません。タスクを再作成してください
BATCH_IMAGE_ITEM_FAILED409指定されたタスク項目に成功した画像がないitem.error を確認
BATCH_IMAGE_DOWNLOAD_LIMITED429同時ダウンロードが多すぎる後でリトライ

生のエラーテキストで逆引き

実際に表示されるエラーテキストを下の表と照合し、詳細な対処法へ直接ジャンプしてください。

生のエラーテキスト意味詳細な対処法
stream disconnected before completionストリームが切断された。通常は VPN / プロキシ / システムプロキシが出口 IP をローテーションしているIssue 1
exceeded retry limit, last status: 429 Too Many Requests1日のクォータを使い切ったIssue 2
401 Unauthorized: Incorrect API key providedリクエストが LMU AI リレーではなく公式エンドポイントに送られているIssue 3
running scripts is disabled on this system（Windows）PowerShell の実行ポリシー制限Issue 4
CODEX is not recognized as a cmdlet（Windows）Node.js がインストールされていない、または PATH が壊れているIssue 5
503 No available accountsシェルの環境変数が IDE で設定したキーを上書きしているIssue 6
400 Invalid signature in thinking block1つの会話でグループをまたいでモデルを切り替えた。thinking シグネチャを検証できないIssue 7
400 Unknown parameter: 'tools[0].n'tools パラメータが誤って画像エンドポイントに送られたIssue 8
No available accounts / モデル利用不可現在のグループの利用可能範囲外のモデルを呼び出したAPI Protocols → トラブルシューティング

Usage export API のエラー

Usage export API は JWT 認証を使うため、そのエラーの意味は上記の API キーチャンネルとは異なります：

ステータス原因対処法
401JWT の有効期限切れrefresh_token で更新するか、再度サインインする
403不正なアクセス（例：自分のものではない api_key_id を照会）キーが現在のアカウントに属しているか確認する
400パラメータが不正（例：start_date のフォーマットが誤り）YYYY-MM-DD フォーマットと timezone が有効か確認する

それでも解決しない場合

  • 手順を追った実例は FAQ にあります
  • Base URL / エンドポイントのルールは API Protocols にあります
  • 盗まれたキーからの保護は Key Security にあります
  • サポートに連絡する際は、request ID と完全なエラーテキストを添えてください

最終更新：

FAQ

LMU AI API のよくあるエラーとセットアップの問題への対処法 — 401 / 403 / 429 / 500、トークン課金、モデル切り替え、Claude Code / Codex CLI のトラブルシューティング。

キーのセキュリティ

LMU AI API キーの IP ホワイトリスト/ブラックリストガイド：どの IP がキーを呼び出せるかを制限し、漏洩したキーの悪用を防ぎます。単一 IP と CIDR 範囲に対応。

このページの目次

HTTP ステータスコードビジネスエラーコード（バッチ画像）生のエラーテキストで逆引きUsage export API のエラーそれでも解決しない場合