先看错误信息
Unable to reach the model provider
也可能显示：Unable to reach model providerCursor Unable to reach the model provider 先记录版本、模式、Provider 和错误全文，再比较同 Key、模型与协议的最小请求。Cursor 的请求链路与本地终端不同；分别检查后端可达范围及自定义 Key 的功能限制。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
先完成下方最小请求检查。列表成功只证明列表可读取；对话还需返回真实回答，并核对同时间、同模型的请求日志。
检查 Base URL 并生成本机验证命令记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
常见表现
- 聊天发送后弹出 Unable to reach the model provider
- 终端调用成功，Cursor 仍然失败
- 开启自定义 Base URL 后才报错
这个报错是什么意思
当前官方帮助说明 BYOK 仅用于支持的 chat models，Tab 仍用内置模型，凭据随请求送到 Cursor 后端构建。官方支持另说明 Composer 型号不支持 BYOK。计划、模式、网络与平台费用要分别核对。
先判断是哪一类问题
对照请求链路定位失败阶段
判断 01
401/400/404：先看实际 Key、路径、ID 与返回正文。
判断 02
本地成功 Cursor 失败：看后端可达范围、配置保存、当前版本和官方状态。
判断 03
Tab 或 Composer 报自定义 Key 不支持：核对功能限制，不能靠换网关解除。
判断 04
文本通过 Agent 失败：继续检查工具 schema、执行权限与客户端任务。
按顺序修复
01
记录 Cursor 版本、实际模式、准确模型和脱敏错误正文。
02
Settings > Models 保存 Key 和 /v1 Base URL；确认当前计划允许对应 BYOK。
03
最小请求有效后回原 Cursor 模式，核对实际模型与原任务。
04
不要把 localhost/内网可达、Tab 或 Composer 配置当作同一 Chat 入口。
详细修复步骤
Step 01
图片或工具任务才失败时，检查请求形态
同一模型的短文本成功后，图片任务单独核对 image_url、真实图片格式与可访问性；工具回合保留 assistant.tool_calls 与每条 tool_call_id 对应结果。请求不是 Chat 结构时，使用对应协议检查，不能把 Responses 的 input 或 Messages 的 tool_result 拼进 messages。只粘贴脱敏 JSON，本地检查不发送请求。
Step 02
路径和保存状态
OpenAI 兼容 Base URL 使用 /v1，不附加 chat/completions。保存后用新会话选择正确型号，核对时间和请求日志。
Step 03
请求来自 Cursor 后端
BYOK 请求经 Cursor 服务构建。本地 curl 和内网地址可达并不证明它的后端能访问；保留原错误，不在无证据时归因模型供应商。
Step 04
Tab 与 Composer 功能范围
官方说明 Tab 使用内置模型；支持回复说明 Composer 自有型号不支持 BYOK。Chat 与 Agent 的具体型号和工具支持按当前版本实际验收。
Step 05
原模式真实任务
在隔离目录读取三行 README，引用第三行，再修约定失败测试。查看工具与 diff 并独立复跑，不把 API 文本回答写成 Cursor Agent 实测。
正确配置
export OPENAI_BASE_URL="https://api.apizt.com/v1"
python3 - <<'PY'
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["tokenba_API_KEY"])
r = client.chat.completions.create(
model=os.environ["tokenba_MODEL"],
messages=[{"role": "user", "content": "只回复 OK"}]
)
print(r.choices[0].message.content)
PY常见原因
- Key 与 Base URL 来自不同平台
- Override OpenAI Base URL 未保存、未生效或协议不兼容
- 模型 ID 未授权，或所选功能不支持自带 Key
- Cursor 后端或上游服务故障、额度和速率限制
不要这样填
API 地址：https://www.apizt.com
或：https://api.apizt.com/v1/chat/completions
上述网址不能直接作为 SDK Base URL。怎么确认已经修好
- 同一模型与 Key 的最小请求返回有效内容；记录为 API 验证。
- Cursor 原出错模式新会话可答复，并有同次请求日志。
- 工具任务有真实文件操作、原测试和独立 diff；未测试模式留空。
避免下次再报错
- 记录工具版本、服务商类型、模型 ID 与请求时间；升级后重新核对界面。
- API Key 只放本地设置或环境变量，截图与日志隐藏完整密钥。
仍未解决？这样提供排查信息
记录报错时间、工具版本、模型 ID 和 HTTP 状态码，附上脱敏后的错误正文。
说明问题是否稳定复现，以及同一配置的最小请求是否成功。
可以提供请求 ID 或控制台日志编号，不要发送完整 API Key、密码或个人业务数据。
先区分配置、权限、额度与上游服务问题；不要通过重复充值或高频重试来排查。
最小请求结果如何与 Cursor 对照
- 记录 Cursor 关于页面的版本号、模型、报错时间与展开后的错误正文。
- 2026-09-28，apizt POST /v1/chat/completions 不带 Key 返回 401；此响应不能归类为网络超时。
- 终端和 Cursor 分开记录成功结果。Cursor 官方说明自带 Key 的请求经过其后端，因此终端成功不证明 Cursor 的全部功能可用。
HTTP 401
{"error":{"message":"Token not provided (request id: [REDACTED])","type":"new_api_error"}}响应取自真实未认证请求，已隐藏请求 ID；本页未执行 Cursor 桌面客户端的付费模型调用，不展示虚构的成功截图。
Cursor 官方 BYOK 支持范围Cursor BYOK：聊天、Agent、Tab 与请求网络分开验收
当前 Cursor 官方帮助说明自带 Key 只用于支持的 chat models，Tab 使用内置模型；请求经 Cursor 后端构建。官方支持回复另指出 Composer 自有型号不能使用 BYOK。终端成功只能作为一段链路的证据。
- 观察对象
- 最小请求 401 / 400 / 404
- 检查办法
- 同一 Key、ID、协议与完整正文
- 通过条件
- 准确模型请求返回有效内容
- 观察对象
- 本地成功，Cursor 失败
- 检查办法
- Settings > Models 的保存状态、实际模式、版本
- 通过条件
- 新会话同一型号和原模式通过
- 观察对象
- localhost / 内网地址
- 检查办法
- Cursor 后端可达范围
- 通过条件
- 不能用本机可达证明 Cursor 可达
- 观察对象
- Tab / Composer
- 检查办法
- 官方功能与模型限制
- 通过条件
- 不把 override URL 当全功能改向
- 观察对象
- Agent 工具任务
- 检查办法
- 工具记录、独立测试与 diff
- 通过条件
- 有真实操作，不只有模型答复
- 观察对象
- Claude 填在 OpenAI Key 槽后失败
- 检查办法
- 原生 Claude BYOK 使用 Anthropic 区域及该厂商 Key；OpenAI 覆盖不保证接管 Claude 路由
- 通过条件
- 记录实际 Provider 与模型；不能通过改模型别名证明兼容
- 观察对象
- 需要 Chat、Agent 与 Tab
- 检查办法
- Chat 先验短文本；Agent 另验读取、修改与测试；Tab 使用 Cursor 内置模型
- 通过条件
- 每种模式独立记结果、Request ID 与费用，不从 API 报告推断客户端通过
在原出错模式完成可复现小任务
- 先记录 Cursor 版本、模式、准确 ID、Base URL 与脱敏错误。基础地址为 /v1，Key 来自 apizt；确认当前版本和计划允许相应 BYOK。
- 使用支持该模式的 chat 型号。在空目录放三行 README，要求引用第三行，再对约定实现补一个失败测试修复；按需授权必要工具。
- 查实际请求 ID、文件操作和独立测试。记录 API 成功但 Cursor 待验证的阶段；Tab、Composer、云任务与隐私/账单规则单独核对。
- 把这次故障写成一行：Cursor 版本、模式、Provider、模型 ID、最终端点、API 结果、客户端结果与 Request ID。2026-10-09 核对官方 BYOK 范围；下载模板和固定任务报告不能替代 Cursor 原模式复测。
核对当前 Cursor 配置Cursor 官方 BYOK、请求链路与功能范围官方支持：Composer BYOK 限制同一协议的地址验收检查流式终态查看固定任务的 API 验收记录与范围下载 Cline 配置参考（手动配置，客户端待验收）
下载 MIT 接入包与任务记录表核验日期与验证范围见各页记录；历史实测保留原日期，示例和空白记录表不等于真实任务结果。
排查完成后，再开始接入
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
FAQ
Cursor Unable to reach the model provider 但本地请求成功怎么办？
核对两边是否使用同一 Key、模型、端点和协议，并检查 Cursor 后端是否能访问目标地址。localhost 或内网地址在本机可用不代表客户端后端可达。
Cursor 自定义 API 能解决 Tab 或自有 Composer 的连接问题吗？
按当前客户端功能说明判断。现有核对资料中 Tab 使用内置模型，自有 Composer 型号不使用 BYOK；自定义 Chat 路由的验证不能代替这些功能的检查。
BYOK 能控制 Tab 吗？
当前官方帮助说明 Tab 使用 Cursor 内置模型，不使用自定义 Key 或 Base URL。
Composer 可以用 apizt 吗？
Cursor 官方支持说明 Composer 自有型号不支持 BYOK。选择受支持的 chat 模型，再验证所需 Chat/Agent 模式。
本地请求成功 Cursor 仍失败为什么？
两条请求链路不同。Cursor 经后端构建，还需要检查版本、保存状态、后端可达范围和功能支持。
Claude 和 OpenAI 自定义地址可以共用一个 Key 槽吗？
原生 Claude BYOK 与 OpenAI 覆盖入口分开。Anthropic 区域使用该厂商 Key；OpenAI 覆盖不保证接管 Claude 路由。先核对 Provider、模型选择器和目标协议，不能通过更改模型别名证明兼容。
2026 年 11 月 5 日补测
Cursor 连不上模型：用请求分辨超时、401 和路径错误
按真实搜索词拆出本机超时、凭据拒绝和路径不存在三种回执。
- 本地 HTTP 故障复现（固定回包）。
- 准备独立样例。安装文章所用客户端，或用 Python 3.11+ 运行标注为本地 HTTP/TOML 的样例。
- 本例操作：按真实搜索词拆出本机超时、凭据拒绝和路径不存在三种回执。
- 解压练习包，执行 python3 lab.py --output ./result u02。完整命令、样例输入和输出保存在回执。
- 打开 result/u02.json，对照实际退出码、请求路径或产物字段。
- 逐项确认下方通过条件。本例的测试范围以运行回执为准。
- 通过：401、404、客户端超时可区分
先下载样例，再完成自己的首次调用
示例不含密钥。API 按实际用量计费；下载和点击不代表调用成功。