Cursor 连接失败与模型验证失败排查
连接失败:检查实际发出的 URL
- 在 Settings → Models 检查 OpenAI API Key 与 Override OpenAI Base URL,基址填 https://api.apizt.com/v1。
- 按当前版本点击 Save;历史版本的 Verify 与聊天不是同一次验证。
- Help → Toggle Developer Tools → Network 查看请求 URL、状态和错误体。检查 重复请求路径。
- BYOK 会经过 Cursor 后端;localhost 不是后端可达地址。独立接口成功、Cursor 失败时,继续看客户端保存状态与官方服务链路。
模型验证失败:使用受支持的标准聊天模型
首次选 gpt-4o;确认 Key 的模型权限与当前会话选择。官方 BYOK 不保证推理模型和 Tab 支持。403/模型不存在进入 模型权限检查,不要用改显示别名绕过限制。
显示成功但没有 apizt 记录
新建 Chat,发送一个容易识别的短提示;核对网关控制台同一时间、模型和用量。验证按钮成功不能证明聊天走该 Key。返回 Cursor 正确配置与验证。
修复后验证与下一步
在原工具中新建会话,发送短文本,再对照 apizt 日志核对模型和请求时间。先看 真实调用记录的验证范围;未覆盖的功能需单独测试。成本和权限:实时模型价格 · 创建分组令牌。