先检查这几项
- Provider 选择 OpenAI Compatible。
- Base URL 使用 https://api.apizt.com/v1。
- Cursor 会自动拼 Authorization，不要把 Bearer 写进 API Key 输入框。
正在打开页面…
正在加载内容，请稍候。
常见错误与配置项
Unable to reach the model provider
也可能显示：Unable to reach model providerCursor Unable to reach the model providerCursor Unable to reach the model provider 但本地请求成功怎么办？provider returned 401Cursor provider returned 401Cursor provider returned 401 API Key 输入格式Invalid API keyCursor Invalid API keyCursor Invalid API key 粘贴时哪些内容要去掉？Rate limit exceededCursor Rate limit exceededCursor Rate limit exceeded 怎么降低请求量？
按失败位置逐项排查
报错检查与修复步骤
Cursor Unable to reach the model provider：请求链路排查
Cursor Unable to reach the model provider 先记录版本、模式、Provider 和错误全文，再比较同 Key、模型与协议的最小请求。Cursor 的请求链路与本地终端不同；分别检查后端可达范围及自定义 Key 的功能限制。
查看报错修复快速判断
- 聊天发送后弹出 Unable to reach the model provider
- 终端调用成功，Cursor 仍然失败
Cursor provider returned 401：Key 与 Provider 鉴权
Cursor provider returned 401 表示当前路由的鉴权未通过。检查 Key 所属服务、地址覆盖、Provider 和令牌状态；在实际使用的模型设置中保存配置，再对照同一请求的错误正文和平台记录。
查看报错修复快速判断
- 保存配置后测试失败
- 聊天窗口显示 provider returned 401
Cursor Invalid API key：令牌格式、状态与服务地址
Cursor Invalid API key 先检查令牌是否复制完整、含空格或 Bearer 前缀，以及 Base URL 是否对应签发服务。确认令牌未禁用并保存到当前 Provider，再重启客户端验证最小对话。
查看报错修复快速判断
- Cursor 测试连接失败
- 提示 Invalid API key
Cursor Rate limit exceeded：并发、上下文与额度
Cursor Rate limit exceeded 先暂停并行 Agent 和连续重试，查看错误中的速率或额度限制。缩小任务和上下文，用单个短请求复测，再逐步恢复并发；余额正常仍可能受到 token 或请求速率限制。
查看报错修复快速判断
- Agent 运行到一半失败
- 短问答正常，长任务失败
Cursor 报错怎么转成可用配置
不要只看错误码本身。先确认请求是否进入 apizt 后台，再按 API Key、Base URL、模型名、provider 类型排查。 这几个页面分别覆盖认证失败、连接失败、模型不存在、限流和工具配置覆盖问题。