30-SECOND DECISION
打开 Cursor Settings > Models，看当前版本真实提供什么
官方步骤是选择 Provider、粘贴 API Key 并保存。这只证明 BYOK，不证明客户端接受第三方 Gateway URL。
按官方 BYOK 使用对应 Provider 的直连 Key。不要把 JBB Key 当成 OpenAI 官方 Key 强行保存。
只有 UI 清楚标注可覆盖 OpenAI Base URL 时，才进入本页的条件式 JBB 实测。
停止配置，不要用非官方隐藏参数猜测；改用明确支持 OpenAI-compatible Base URL 的客户端。
截至 2026-07-15，Cursor 官方 BYOK 文档未提及自定义 OpenAI Base URL。因此哥不把“Cursor + JBB”写成已稳定支持；下面的 Gateway 步骤只在当前 Build 显示相应字段时成立。
OFFICIAL BYOK
官方已确认的能力和没有确认的能力
| 能力 | 当前事实 | 对 JBB 的含义 |
|---|---|---|
| OpenAI BYOK | 官方已文档化 标准、非 reasoning 的 chat models。 | 只证明 OpenAI Provider Key 入口存在，不证明任意 Gateway。 |
| Anthropic / Google / Azure / Bedrock BYOK | 官方已文档化 | 各 Provider 按官方凭证形态接入，不与 OpenAI-compatible 中转画等号。 |
| Custom OpenAI Base URL | 官方文档未公开确认 | 以当前 Cursor Build 的 Settings UI 和实测结果为准。 |
| Tab Completion | Cursor 内置模型 | Custom API Key 不接管 Tab，所以 Tab 流量不应期待出现在 JBB 日志里。 |
官方依据：Bring your own API key 与 Available models。Cursor 及其商标归其权利人所有；本页不表示 JBB 与 Cursor 存在合作或背书。
JBB PRE-FLIGHT
先在终端确认 Key 和模型，不要让 Cursor 替你猜错误
创建一枚独立、低额度的 JBB API Key，然后只读取当前 Key 可见的模型。下面的预检不生成内容，但会把 Key 发送到 JBB。
export JBB_API_KEY="<YOUR_JBB_API_KEY>"
curl "https://jbbt.pages.dev/v1/models" -H "Authorization: Bearer $JBB_API_KEY"$env:JBB_API_KEY = "<YOUR_JBB_API_KEY>"
Invoke-RestMethod -Uri "https://jbbt.pages.dev/v1/models" -Headers @{ Authorization = "Bearer $env:JBB_API_KEY" }- 记录完整模型 ID，不要自行缩写或猜测别名。
- 先在 模型总览 核对 API 类型；Cursor 的 OpenAI BYOK 官方只描述标准非 reasoning chat models。
- 不在截图、命令历史、Git、聊天记录或工单里暴露 Key。
CONDITIONAL SETUP
只在当前 Build 明确显示 Base URL 覆盖项时填写
页面文案、字段位置可能随 Cursor 版本改变。如果 Settings > Models 里没有清晰的 OpenAI Base URL 字段，本节不适用。
OpenAI API Key: <YOUR_JBB_API_KEY>
OpenAI Base URL: https://jbbt.pages.dev/v1
Model: <EXACT_MODEL_ID_FROM_/v1/models>- 打开 Cursor Settings > Models，定位 OpenAI Provider。
- 确认当前界面明确提供可编辑的 Base URL；没有则立即停止。
- 填入独立低额度 JBB Key、JBB OpenAI-compatible Base URL 和精确模型 ID。
- 点击 Save；保存被拒绝、字段被重置或模型不出现时，就视为当前 Build 不可复现。
保存成功只证明 UI 接受了值。必须用 Cursor Chat 发起一次最小请求，并在 JBB 日志里对上时间、Key、模型、状态和计费。
END-TO-END TEST
用一次最小 Chat 和一条 JBB 日志完成闭环
Cursor Chat 发起请求可能产生计费。使用低额度专用 Key，提示词只要求返回一个短字符串，失败时不要无限重试。
| 层级 | 通过信号 | 失败时说明 |
|---|---|---|
GET /v1/models | 200 且看到目标模型 | 只证明 Key 与模型目录，不证明 Cursor 会使用该 URL。 |
| Cursor Save | 值保留且模型可选 | 字段被清空或被强制验证时，不要继续猜。 |
| Cursor Chat | 短响应成功 | 失败时保留完整错误和发生时间。 |
| JBB 日志 | 时间、Key、模型、状态对齐 | 没有日志通常表示请求未到 JBB，不是换模型就能解决。 |
| Tab Completion | 不要求出现在 JBB | 官方已说明 Tab 继续使用 Cursor 内置模型。 |
- 当前 Cursor 版本号、操作系统和 Settings 截图已记录，Key 已打码。
- Base URL 为
https://jbbt.pages.dev/v1，不重复追加/v1。 - 模型 ID 与当前 Key 的
/v1/models返回值完全一致。 - Cursor Chat 响应与 JBB 后台日志、usage 和扣费已对齐。
- 连续 400、404、429 或 5xx 时停止自动重试，先分层定位。
LIMITS & PRIVACY
Custom API Key 只覆盖 Chat，且 Key 会经过 Cursor Backend
- Chat only：Cursor 官方明确说明 Custom API keys 只对 chat models 生效，Tab Completion 使用 Cursor 内置模型。
- OpenAI 范围：官方当前将 OpenAI BYOK 描述为标准、非 reasoning chat models；不要假定所有模型或 Agent 功能都适配。
- Zero Data Retention：使用自有 API Key 时不适用 Cursor 的 Zero Data Retention，数据处理遵循所选 Provider 的政策。
- Key 路径：官方说明 Key 不会持久化保存在 Cursor 服务器，但每次请求都会将 Key 发送到 Cursor Backend，因为请求会经过 Cursor Server 完成最终 Prompt 构建。
- 验证范围：某个模型在某个 Build 中成功，不代表其他模型、Cursor 升级或 Tab 也成功。
隐私与 Key 路径依据：Cursor 官方 BYOK 帮助页，本页核对日期 2026-07-15。
TROUBLESHOOTING
先看请求是否到 JBB，再处理认证、路径、模型和上游
- NO UI没有 Base URL 字段
当前 Build 不能按本页复现 JBB Gateway；改用明确支持 OpenAI-compatible Base URL 的客户端。
- 401Key 未被 JBB 接受
检查 Bearer Key、启用状态、额度、分组和是否不小心填入了账号密码。
- 404Base URL 或路径不对
JBB OpenAI-compatible Base URL 候选值包含
/v1；避免变成/v1/v1。 - 400模型或请求形状不兼容
使用
/v1/models的精确 ID；若是 reasoning、tool 或其他扩展字段，将其与基础 Chat 分开验证。 - 429额度或频率限制
检查 JBB 余额、Key 限额与分组，使用有上限的退避，禁止 retry storm。
- 5xxGateway 或上游错误
保存请求时间、模型、错误正文和请求 ID；用最小 cURL 区分 Cursor 与服务端问题。
- NO LOGCursor 失败但 JBB 没有日志
请求大概未到 JBB，优先检查 Cursor 是否保留了 Base URL，不要在服务端盲目换渠道。
FAQ
Cursor API 中转站常见问题
- Q1Cursor 能直接使用 JBB 吗？
官方文档未承诺任意 OpenAI-compatible Base URL。只有当当前 Build 明确显示 Base URL 入口时，才能按本页做条件式实测。
- Q2为什么 Cursor Tab 没有走 JBB？
这是官方边界：Custom API keys 只用于 chat models，Tab Completion 继续使用 Cursor 内置模型。
- Q3JBB Base URL 要不要带
/v1？对 JBB OpenAI-compatible API，候选值是
https://jbbt.pages.dev/v1；不要变成/v1/v1。 - Q4BYOK 时 Zero Data Retention 还适用吗？
不适用。数据处理遵循所选 Provider 的隐私政策。
- Q5API Key 会离开设备吗？
会。Cursor 官方说明 Key 会随每次请求加密发送到 Cursor Backend，用于最终 Prompt 构建；官方同时表示不会在请求后持久化保存该 Key。
- Q6页面保存成功就算配好了吗？
不算。还要完成 Cursor Chat 最小请求，并在 JBB 日志里对齐模型、状态、usage 和扣费。