Cursor 接入 apizt 自定义 API

更新于 2026-09-28

适用范围：Cursor 桌面版的自定义 OpenAI 兼容聊天接入，不承诺替代 Tab、专用模型或全部订阅功能。

版本与验证：Cursor 本机未安装；官方帮助的 Save 步骤已核验，保留旧图并标历史界面。2026-09-28 Python requests 2.33.1 / gpt-4o Chat 调用成功；Cursor 内保存、聊天及订阅权限尚未实测。

配置速查

配置项	填写内容	注意事项
OpenAI API Key	`你的 apizt API Key`	不要填 Cursor 登录令牌。
Override OpenAI Base URL	`https://api.apizt.com/v1`	先确认本机版本提供该入口。
首次验证模型	`gpt-4o`	标准非推理聊天；价格页上架不代表所有模型支持 Cursor BYOK。

为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。

本教程介绍 Cursor 中自定义 OpenAI 兼容聊天的配置。自定义 Key 不等于替代全部 Cursor 功能或订阅；先确认当前版本和账号提供相应设置入口。

进入 Cursor Settings 的 Models 或 API Keys 页面，查看是否有自定义 OpenAI Base URL 设置。菜单随版本变化，以当前界面为准。

历史界面参考，未核实截图版本；当前官方帮助使用 Save。下方步骤与官方链接为本次核验依据。

从当前令牌可用模型列表复制完整 ID 并启用。先选标准非推理聊天模型 gpt-4o；官方 BYOK 不承诺支持 GPT-6 等推理模型。截图里的别名仅作当时配置示例；不要自行添加 new- 前缀。遇到同名项时，核对当前会话到底选中了哪个模型。

历史界面参考，未核实截图版本；当前官方帮助使用 Save。下方步骤与官方链接为本次核验依据。

在 OpenAI API Key 填 apizt 密钥，将 Override OpenAI Base URL 设置为 https://api.apizt.com/v1，点击 Save 保存；旧版可能显示 Verify，应按版本区分。

历史界面参考，未核实截图版本；当前官方帮助使用 Save。下方步骤与官方链接为本次核验依据。

选择已配置的模型，发送短文本，再检查 apizt 日志。不要仅凭客户端有回复就判断使用了此服务。确认文字对话成功后，再测试当前模型和版本支持的代理功能。

Cursor 官方说明 Tab 继续使用内置模型；BYOK 请求经过 Cursor 后端，不能使用只在本机可达的 localhost 网关。自定义 API 不保证所有功能、所有模型或免费账号均可使用；请以当前官方说明和账号界面为准。

测试日期：2026-09-28（Asia/Shanghai）；macOS 26.3。查看脱敏记录、软件版本和真实生成图片。一次文本成功仅证明本次请求，不代表其他模型、工具执行、多轮上下文或桌面版均已通过。

POST https://api.apizt.com/v1/chat/completions
model: gpt-4o
HTTP 200
output: tokenba_OK

独立接口成功后，打开新 Chat 选择该模型；在 apizt 日志中检查时间与模型。客户端未通过时看 Cursor 连接失败与模型验证失败，按 Help → Toggle Developer Tools → Network 查看最终请求 URL，分享日志前隐藏 Key。

先保留版本号、错误时间与 HTTP 状态。打开 Cursor 交互式排错检查，按 401、404、429、网络错误分流，下载检查记录后对照复测。无需粘贴 API Key。

现象	检查与处理
找不到自定义地址入口	核对当前版本及官方功能说明，不要先凭旧教程购买订阅。
模型 ID 冲突	核对当前选择的模型与服务商；只有服务端列出的别名才可使用，不是简单改名就能调用。
聊天成功，Tab 或其他能力仍收费	这些能力可能使用 Cursor 自有模型或计费路径；自定义 Key 不等于替代全部功能。
显示验证成功但无调用记录	验证和实际聊天可能不是同一操作；核对会话模型和日志时间，避免把其他服务商回复误认为接入成功。

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。