Cursor 连接失败与模型验证失败排查

更新于 ;软件与模型验证范围见正文。

连接失败:检查实际发出的 URL

  1. 在 Settings → Models 检查 OpenAI API Key 与 Override OpenAI Base URL,基址填 https://api.apizt.com/v1。
  2. 按当前版本点击 Save;历史版本的 Verify 与聊天不是同一次验证。
  3. Help → Toggle Developer Tools → Network 查看请求 URL、状态和错误体。检查 重复请求路径。
  4. BYOK 会经过 Cursor 后端;localhost 不是后端可达地址。独立接口成功、Cursor 失败时,继续看客户端保存状态与官方服务链路。

模型验证失败:使用受支持的标准聊天模型

首次选 gpt-4o;确认 Key 的模型权限与当前会话选择。官方 BYOK 不保证推理模型和 Tab 支持。403/模型不存在进入 模型权限检查,不要用改显示别名绕过限制。

显示成功但没有 apizt 记录

新建 Chat,发送一个容易识别的短提示;核对网关控制台同一时间、模型和用量。验证按钮成功不能证明聊天走该 Key。返回 Cursor 正确配置与验证。

修复后验证与下一步

在原工具中新建会话,发送短文本,再对照 apizt 日志核对模型和请求时间。先看 真实调用记录的验证范围;未覆盖的功能需单独测试。成本和权限:实时模型价格 · 创建分组令牌。