常见问题

问题 1：断流超时错误

错误信息：

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

原因： 典型的断流现象，通常由以下原因导致：

• 本地网络环境不稳定（频繁切换 Wi-Fi / 移动网络、信号弱、丢包）
• 开启了魔法 / VPN / 系统代理：代理自动切换出口 IP 会导致连接中断断流

解决方案：

1. 关闭魔法 / VPN / 系统代理后重试——灵眸为国内直连，无需魔法
2. 检查本地网络是否稳定，必要时切换更稳定的网络环境

问题 2：429 重试错误

错误信息：

exceeded retry limit, last status: 429 Too Many Requests

原因： 当日额度已用完。

解决方案：

1. 查看「我的订阅」，确认当日额度是否已用完
2. 如需增量，前往购买不同规格的套餐，然后在后台 API 密钥中切换到新套餐的分组

问题 3：401 密钥不正确

错误信息：

unexpected status 401 Unauthorized: Incorrect API key provided

原因： 请求还是走的 OpenAI 官方，没有走我们的中转站。

解决方案：

1. 确认已正确创建或替换 config.toml 和 auth.json 两个文件
2. 重启 IDE 工具（VS Code / Cursor 等）重新加载配置文件
3. 若之前使用官方或其他平台登录过，请先退出账号再进行配置

问题 4：脚本禁止运行（Windows）

错误信息：

codex：无法加载文件，因为在此系统上禁止运行脚本。

解决方案： 在终端运行以下命令，然后重新打开新终端：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

问题 5：Node.js 未找到（Windows）

错误信息： CODEX 无法识别为 cmdlet 等错误

原因： Node.js 未安装或环境变量配置有问题。

解决方案： 重新下载安装 Node.js 20+，安装完成后重新打开终端。

问题 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 等环境变量，Shell 启动后这些变量会全局生效，覆盖掉 IDE 工具（Cursor、VS Code 等）里配置的 API Key，导致请求使用了错误的密钥。

解决方案（二选一）：

方案 A：直接移除 .zshrc 中的相关环境变量

打开 ~/.zshrc，删除以下几行：

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

然后执行 source ~/.zshrc 使修改生效，重启 IDE 工具。

方案 B：将变量移到独立文件，仅在运行 Claude Code CLI 时加载

1. 新建文件 ~/.claude_env，将三行变量写入其中：

export ANTHROPIC_AUTH_TOKEN="sk-你的灵眸API密钥"
export ANTHROPIC_BASE_URL="https://api.lmuai.com"
export ANTHROPIC_MODEL="你使用的模型"

2. 从 ~/.zshrc 中删除这三行。

3. 启动 Claude Code 时手动加载：

source ~/.claude_env && claude

这样 IDE 工具正常使用配置文件中的密钥，Claude Code CLI 使用环境变量，互不干扰。

问题 7：400 Invalid signature in thinking block（跨分组切换模型）

错误信息：

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

原因： Claude 的 Extended Thinking（思考）功能在生成 thinking block 时会附带一个加密签名，该签名与生成它的具体上游账号强绑定。当你在同一段对话里跨分组切换模型（例如从「Claude-Pro-直营组」的 claude-sonnet-5 切到「Claude-MAX-高倍率分组」的 claude-fable-5），客户端会把之前的对话历史（含带签名的 thinking block）一并发送给新分组的上游账号，而不同分组走的是不同上游，无法验证对方签发的签名，因此返回 400。

典型触发场景：

• 客户端支持在会话中切换模型，且切换后携带了此前的完整历史
• 切换前后所在分组来自不同上游账号（如「直营组」↔「中转组 / MAX 高倍率组」）

解决方案（任一即可）：

1. 切换分组时新开一个对话——不携带旧历史，是最简单可靠的做法。
2. 同一会话固定使用一个分组——如果需要多模型协作，尽量保持在同一分组（同一上游）之内切换。
3. 剥离历史中的 thinking block——如果客户端支持自定义历史，切换分组前把历史消息里的 thinking block 去掉再发送。

问题 8：400 Unknown parameter: 'tools[0].n'（图像接口误传参数）

错误信息：

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。

常见起因是客户端 / SDK 封装有误，把「生成张数 n」放错了位置——错误地嵌进了 tools[0].n，或直接套用了 Chat 接口的参数模板。

解决方案：

1. 去掉请求体里的 tools 字段——图像 generations / edits 不支持工具调用，这个字段应当整个删除。
2. 生成多张图时，把数量放到顶层 n——仅 /v1/images/generations 支持 n（一次生成多张）；/v1/images/edits 不支持多张，请去掉 n。
3. 检查客户端 SDK 版本——如果是封装库自动拼的参数，升级或更换 SDK，确认它没有把 Chat 接口的参数模板套用到图像接口上。

问题 9：需要科学上网吗？

不需要。 灵眸接入网关部署在中国国内，api.lmuai.com 国内网络可直接调用，无需 VPN、代理或任何外网访问方案。

反之挂着魔法或代理时，代理自动切换出口 IP 反而容易造成断流（见问题 1）。国内直连即可获得最快速度与最稳定的连接。

问题 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 版本的 bug——自定义 model provider 使用 wire_api = "responses" 时，Codex 发出的请求完全没有携带 API Key（Authorization、x-api-key、x-goog-api-key 三个头一个都没发），网关校验不到密钥，返回 401 API_KEY_REQUIRED。

注意它和问题 3 的 Incorrect API key provided 不是一回事：那个是密钥发了但不对（多数因为请求走了 OpenAI 官方而非灵眸中转），这个是压根没发密钥。

解决方案： 打开 ~/.codex/config.toml，找到你的 model provider 配置段 [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 即可。

仍有问题？

安装配置过程中如有特殊环境还是无法解决，可联系客服：

• 添加客服微信
• 联系咸鱼客服

客服远程协助时间：下午两点以后（上午客服在岗帮忙忙远程解决复杂配置环境）

需要远程的宝子们请自行先下载网易 UU 远程，发给客服即可在下午两点会进行技术指导和远程协助。

最后更新：2026-08-21