ユーザーガイド

FAQ

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

Issue 1: ストリーム切断 / タイムアウト

エラーメッセージ:

stream disconnected before completion: error sending request for url
(https://api.lmuai.com/responses)

原因: 典型的なストリーム切断で、通常は次が原因です:

  • ローカルネットワークが不安定(Wi-Fi / モバイル回線の頻繁な切り替え、電波が弱い、パケットロス)
  • VPN / プロキシ / システムプロキシがオンになっている:プロキシが出口 IP を切り替えて接続を切る

解決策:

  1. VPN / プロキシ / システムプロキシをすべてオフにして再試行 — LMU AI は国内直接接続で、VPN は不要です
  2. ローカルネットワークが安定しているか確認し、必要ならより信頼できるネットワークに切り替える

VPN 不要 — 中国国内からの直接アクセスが最速

LMU AI ゲートウェイは中国本土内にホストされているため、国内ネットワークから VPN・プロキシ・回避策なしで直接呼び出せます。直接接続が最速かつ最も安定した結果をもたらします。逆に、出口 IP を切り替える VPN やプロキシは、ストリーム切断を引き起こしがちです。


Issue 2: 429 リトライエラー

エラーメッセージ:

exceeded retry limit, last status: 429 Too Many Requests

原因: 1 日のクォータを使い切っています。

解決策:

  1. My Subscription を開き、1 日のクォータを使い切っていないか確認する
  2. さらに必要な場合は、異なるティアのプランを購入し、コンソールの API Keys で新しいプランのグループに切り替える

更新 vs クォータ追加

  • 同じプランを購入しないでください — 同じプランは更新であり、クォータは加算されません
  • クォータを追加するには、異なるプランを購入してください(例:デイパスからマンスパスに切り替える)

Issue 3: 401 Incorrect API key

エラーメッセージ:

unexpected status 401 Unauthorized: Incorrect API key provided

原因: リクエストが当社のリレーではなく OpenAI の公式エンドポイントにまだ送られています。

解決策:

  1. config.tomlauth.json の両方が正しく作成/置換されたか確認する
  2. IDE(VS Code / Cursor など)を再起動して設定ファイルを読み込ませる
  3. 以前に公式または別のプロバイダーのアカウントでサインインしていた場合は、まずサインアウトしてから再設定する

エラーに遭遇したときの対処

エラーのスクリーンショットを撮って翻訳する — これで原因をすばやく特定できることが多いです。


Issue 4: スクリプトが無効(Windows)

エラーメッセージ:

codex: cannot be loaded because running scripts is disabled on this system.

解決策: ターミナルで次を実行し、新しいターミナルを開いてください:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Issue 5: Node.js が見つからない(Windows)

エラーメッセージ: CODEX is not recognized as a cmdlet など

原因: Node.js がインストールされていないか、PATH が壊れています。

解決策: Node.js 20 以降を再インストールし、新しいターミナルを開いてください。


Issue 6: 503 No available accounts(環境変数がキーを上書き)

エラーメッセージ:

Error code: 503 - {'error': {'message': 'No available accounts: no available accounts', 'type': 'api_error'}}

原因: ~/.zshrc(または ~/.bashrc)に ANTHROPIC_AUTH_TOKEN / ANTHROPIC_BASE_URL / ANTHROPIC_MODEL が設定されています。シェルが起動すると、これらの変数がグローバルに有効になり、IDE(Cursor、VS Code など)で設定した API キーを上書きするため、リクエストが誤ったキーを使ってしまいます。

解決策(いずれか選択):

オプション A: .zshrc から変数を削除する

~/.zshrc を開き、次の行を削除してください:

export ANTHROPIC_AUTH_TOKEN="..."
export ANTHROPIC_BASE_URL="..."
export ANTHROPIC_MODEL="..."

その後、source ~/.zshrc を実行して適用し、IDE を再起動してください。

オプション B: 変数を別ファイルに移し、Claude Code CLI のときだけ読み込む

  1. 次の 3 行で ~/.claude_env を作成する:
export ANTHROPIC_AUTH_TOKEN="sk-your-lmu-ai-api-key"
export ANTHROPIC_BASE_URL="https://api.lmuai.com"
export ANTHROPIC_MODEL="the-model-you-use"
  1. ~/.zshrc からこれら 3 行を削除する。

  2. Claude Code 起動時に手動で読み込む:

source ~/.claude_env && claude

こうすることで、IDE は設定ファイルのキーを使い、Claude Code CLI は環境変数を使うようになり、互いに干渉しません。


Issue 7: 400 Invalid signature in thinking block(グループをまたいだモデル切り替え)

エラーメッセージ:

upstream error: 400 messages.<index>.content.<index>:
Invalid `signature` in `thinking` block

原因: Claude の Extended Thinking が thinking ブロックを生成するとき、それを生成した特定の上流アカウントに強く紐づいた暗号化署名を付与します。1 つの会話内でグループをまたいでモデルを切り替えると(例:「Claude-Pro 直接」グループの claude-sonnet-5 から「Claude-MAX 高倍率」グループの claude-fable-5 へ)、クライアントは以前の履歴(署名付き thinking ブロックを含む)を新しいグループの上流アカウントに送信します。グループが異なると上流も異なり、別のグループが発行した署名を検証できないため、400 が返ります。

典型的なトリガー:

  • クライアントが会話途中でのモデル切り替えをサポートし、以前の履歴を丸ごと送信する
  • 切り替え前後のグループが異なる上流アカウント由来(例:「直接グループ」↔「リレー / MAX 高倍率グループ」)

解決策(いずれか):

  1. グループを切り替えるときは新しい会話を始める — 古い履歴を持ち込まないのが最もシンプルで確実な対処です。
  2. 1 会話 1 グループを維持する — マルチモデル連携が必要な場合は、同じグループ内(同じ上流)で切り替えてください。
  3. 履歴から thinking ブロックを削除する — クライアントが履歴編集をサポートしているなら、グループを切り替える前に thinking ブロックを削除してください。

なぜ再試行では直らない?

これは無効な署名によって引き起こされる、回復不能な 4xx クライアントエラーです。ゲートウェイがこれを検出すると、400 をそのままクライアントに返し、別のアカウントで自動再試行しません — 一致しない上流はどれも同じように失敗するためです。


Issue 8: 400 Unknown parameter: 'tools[0].n'(画像エンドポイントに tools を送信)

エラーメッセージ:

400 - {'error': {'code': 'unknown_parameter', 'message': "Unknown parameter: 'tools[0].n'.", 'param': 'tools[0].n', 'type': 'invalid_request_error'}}

影響を受けるエンドポイント: /v1/images/generations/v1/images/edits(画像生成 / 編集)。

原因: クライアントが画像リクエストボディに tools 配列を入れ、tools[0] の中に n フィールドを入れています。OpenAI の画像エンドポイントは tools を受け付けません(ツール呼び出しは Chat / Responses エンドポイントに属し、画像エンドポイントにはそのような概念がありません)。そのため上流は 400 で拒否します。

これは通常、「画像枚数 n」を誤った場所に置く — tools[0].n にネストしたり、Chat リクエストのテンプレートからコピーしたりする — バグのあるクライアント / SDK ラッパーが原因です。

解決策:

  1. リクエストボディから tools フィールドを削除する — 画像の generations / edits はツール呼び出しをサポートしていません。フィールドをまるごと削除してください。
  2. 複数枚の画像を生成するには、トップレベルの n に枚数を入れるn(1 回の呼び出しで複数枚)をサポートするのは /v1/images/generations のみです。/v1/images/edits は非対応なので、そこでは n を削除してください。
  3. クライアント SDK のバージョンを確認する — ラッパーがパラメーターを自動構築している場合は、画像エンドポイントに Chat テンプレートを適用しないよう、アップグレードまたは置き換えてください。

なぜアカウント切り替え / 再試行では直らない?

これは無効なリクエストボディによって引き起こされる 4xx クライアントエラーで、上流のアカウントやグループとは無関係です — ゲートウェイはリクエストをそのまま通し、どのアカウントでも同じ 400 を返します。クライアントが送るリクエストパラメーターを修正する必要があります。


Issue 9: VPN は必要ですか?

不要です。 LMU AI ゲートウェイは中国本土内にホストされており、api.lmuai.com は国内ネットワークから VPN・プロキシ・回避策なしで直接呼び出せます。

逆に、出口 IP を切り替える VPN やプロキシは、ストリーム切断を引き起こしがちです(Issue 1 参照)。国内からの直接接続が最速かつ最も安定した結果をもたらします。


Issue 10: 401 API_KEY_REQUIRED(Codex がキーを送らない)

エラーメッセージ:

unexpected status 401 Unauthorized: {"code":"API_KEY_REQUIRED","message":"API key is required in Authorization header (Bearer scheme), x-api-key header, or x-goog-api-key header"}, url: https://api.lmuai.com/responses, request id: ...

原因: Codex のバグです — カスタムモデルプロバイダーが wire_api = "responses" を使うと、Codex が送るリクエストに API キーがまったく含まれませんAuthorizationx-api-keyx-goog-api-key のいずれも送られません)。そのためゲートウェイはキーを見つけられず、401 API_KEY_REQUIRED を返します。

これは Issue 3Incorrect API key provided とは異なることに注意してください:あちらは誤ったキーを送信している(通常はリクエストが LMU AI リレーではなく OpenAI の公式エンドポイントに送られたため)のに対し、こちらはキーをまったく送っていません

解決策: ~/.codex/config.toml を開き、モデルプロバイダーのセクション [model_providers.<ID>](本サイトのガイドに従った場合は通常 [model_providers.codex])を見つけ、その中に requires_openai_auth = true を追加してください:

[model_providers.codex]
name = "codex"
base_url = "https://api.lmuai.com"
wire_api = "responses"
requires_openai_auth = true

保存し、ターミナルを開き直して Codex を再起動してください。

本サイトのガイドに従ったユーザーは影響を受けません

本サイトのすべての Codex ガイド(Mac / Windows / Server / Codex App)は、その config.toml の例にすでに requires_openai_auth = true を含んでいます。このエラーに遭遇した場合、設定はこの行を省略した古いガイドや別のソースからコピーされた可能性が高いです — 上記のとおり追加してください。


まだ解決しない場合は?

インストールやセットアップ中に特殊な環境でどうしても進めない場合は、サポートにお問い合わせください:

  • WeChat でサポートを追加する
  • Xianyu(闲鱼)でサポートに連絡する

リモートサポート対応時間:午後 2 時以降(午前中は複雑な環境設定をリモートで解決するのに充てています)。

リモートサポートが必要な場合は、まず NetEase UU Remote をダウンロードしてサポートに送ってください。技術的なガイダンスとリモートサポートは午後 2 時以降に行います。

最終更新:

このページの目次