常见问题

常见问题

问题 1：请求中途断开或超时

检查本地网络、VPN/系统代理和客户端超时设置是否发生变化。流式输出已开始后断开时，先确认控制台是否记录了请求，避免马上重放可能已经计费的完整任务。短任务可重新发起；长任务应使用应用侧 request id 去重策略。

问题 2：返回 429 或反复重试

先检查套餐余额、Key 的周期限额和请求并发，再查看服务端给出的 Retry-After。使用指数退避并降低并发；若套餐额度已到上限，调整使用量或在控制台检查可用方案。连续快速重试通常会延长限流。

问题 3：返回 401

确认请求确实发往 MRXAPI 的 Base URL，Key 没有被截断或多加空格，鉴权格式与协议匹配。修改配置后彻底重启客户端，避免旧进程仍使用之前的环境变量或账号登录状态。

问题 4：Windows 提示脚本无法执行

先确认命令是在 PowerShell、Windows Terminal 还是 CMD 中运行；不同 shell 的激活方式和脚本扩展名不同。只为当前用户运行官方工具的安装说明，不要为解决单条命令而全局关闭系统执行策略。

问题 5：找不到 node 或 npm

在新开的终端执行 node --version 和 npm --version。命令找不到时安装 Node.js 的当前 LTS 版本，并重新打开终端以加载 PATH；再执行客户端安装步骤。

问题 6：返回 503 或 No available accounts

检查模型 ID、Key 分组和当前模型状态；在 Claude Code 或 IDE 中确认 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 等环境变量没有覆盖配置文件。重开客户端后发起一个最小请求并记录 request id。

问题 7：跨模型切换后出现签名或上下文错误

某些客户端会在同一历史对话中保留模型专用的思考块或工具状态。新建对话后重试；若只有切换模型后失败，保持同一会话中的模型不变，并按错误详情检查客户端版本。

问题 8：图像请求提示未知字段或参数

确认图片请求使用对应图片接口和字段，不要把 Chat Completion 的 tools 参数复制到图片 JSON 中。检查编辑请求的图片格式、内容类型和大小，并参考具体的生图 API 手册。

问题 9：是否需要代理或 VPN？

MRXAPI 的可达性取决于当前部署的网关域名与网络策略。先直接请求页面显示的 API 地址；若无法连接，再检查 DNS、代理设置和本地网络，不要把其他服务的网络结论套用到这里。

问题 10：返回 API_KEY_REQUIRED

请求没有携带可识别的 API Key。检查客户端实际发出的请求头，而不只是配置界面中已填写的值。OpenAI 常见形式是 Authorization: Bearer <key>；不同客户端可能需要在 Key 字段中只填写密钥本身。

仍有问题？

收集客户端和版本、请求时间、模型、状态码、request id 与已脱敏的错误正文；不要发送完整 Key、Cookie 或私有提示词。先对照接入协议检查 URL。