你正在设置的内容
Cursor 是一款支持自定义模型提供商的编辑器。如果你给它一个 OpenAI 风格的 Base URL、一个密钥和一个模型名称，它会将聊天请求发送到那里，而不是发送到其默认提供商。该服务支持该协议：POST /v1/chat/completions 使用 Bearer 认证，以及 GET /v1/models。
首先要明确两点。这是一个运行单一开放权重模型的独立 API，不是 OpenAI 的 Codex，也不是 Cursor 的官方产品。此外，Cursor 的设置界面经常变化，因此下面的标签在你的版本中可能位于略有不同的位置。这三个值永远不会改变：Base URL、密钥、模型名称。
步骤 1：获取密钥并在 Cursor 之外测试
在 API 密钥页面 使用 Google 或电子邮件和密码注册。新账户可以一键领取 $0.50 免费试用额度，有效期 7 天，无需信用卡。这足以测试编辑器设置。
在修改 Cursor 之前，确认密钥是否有效。编辑器内的错误比终端中的错误更难阅读。
curl https://api.getcodexapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
}'如果你收到包含代码的 JSON 回复，请继续。如果收到错误，请先在此处修复。常见原因包括密钥中缺少字符或在末尾粘贴了空格。
步骤 2：配置 Cursor
- 打开 Cursor 设置并进入模型部分。
- 找到 OpenAI API 密钥字段，粘贴来自此服务的密钥。
- 开启覆盖 OpenAI Base URL 的选项，并输入
https://api.getcodexapi.com/v1。 - 添加自定义模型，并输入确切名称
uncensored。 - 如果有验证按钮，请运行它，然后打开聊天面板并从模型列表中选择
uncensored。
如果验证步骤报告失败，按顺序检查三件事：Base URL 以 /v1 结尾，其后没有接口路径；密钥粘贴时没有尾部空格；模型名称没有大写字母。文档页面 列出了相同的值以及额外的客户端示例。
需要规划的一点是：覆盖是一个设置，而不是每个模型的选择，因此如果你还在 Cursor 的其他地方使用自己的 OpenAI 密钥，请先关闭覆盖。记录你更改的内容。
保存后，在聊天中向模型提出一个简单的编码问题并观察回复。首次回复慢是正常的，因为 Cursor 正在构建请求。如果收到回复，说明已连接，下一步是在你自己的仓库中尝试实际工作。
哪些请求会通过你的密钥
Cursor 混合了多种功能。聊天和行内编辑请求是最有可能在你选择自定义模型后使用你的自定义模型的。其他功能，如 Tab 补全，历史上使用 Cursor 自行运行的模型，而代理类功能可能取决于 Cursor 如何处理工具。最诚实的方法是尝试你依赖的功能并观察你的余额。
这很容易做到：此 API 的每个响应都带有 X-Balance-USD 头，你的余额在账户中可见。如果你发送聊天消息且余额没有变化，说明该请求未发送到我们这里。
此接口支持函数调用（tools、tool_choice、流式输出 tool_calls，以及结果作为 role: "tool"），这是编辑器代理所需的功能。流式输出通过 SSE 实现，使用 stream: true。上下文窗口为 100,000 token，包含提示词和补全，因此大文件及其邻近内容可包含在单次请求中。
为什么在编辑器中使用无审查模型
大多数编码工作永远不会遇到拒绝。当遇到拒绝时，通常是因为合法任务看起来对谨慎的过滤器有风险：为你自己的网络编写端口扫描器、解析你正在分析的恶意软件样本、生成包含冒犯性语言的测试数据、为成人角色扮演或伴侣应用构建后端，或重构处理内容审核的代码。此模型经过调整，可在合法成人使用时无需内容拒绝即可回答。
它仍然是一个通用开放权重模型，而不是专门的代码模型，这里没有任何内容保证它在你的代码库上优于任何特定替代方案。通过它运行你自己的任务。有一条规则是固定的：不涉及未成年人的性内容，且无法更改。
实际成本
价格为每 1M 输入 token $0.15，每 1M 输出 token $0.50，从预付额度中扣除，无订阅。编辑器流量以输入为主，因为每个请求都会重新发送文件上下文。
包含 8,000 输入 token 和 1,000 输出 token 的请求成本为 8,000 x $0.15 / 1,000,000 = $0.0012（输入），加上 1,000 x $0.50 / 1,000,000 = $0.0005（输出），总计 $0.0017。如果你在一天的重度使用中进行了 150 次此类请求，那就是 150 x $0.0017 = $0.255，约 26 美分。
发送 40,000 token 上下文并获取 1,500 token 的请求成本为 $0.006 + $0.00075 = $0.00675。充值从 $20 开始，额度永不过期，因此没有用完额度的压力。查看 定价页面 了解奖励层级，查看 编码 API 页面 获取概览。
编辑器使用的速率限制
完整密钥允许 8 个并发请求和每分钟 300 个请求。试用密钥允许 2 个并发和每分钟 60 个请求。一个人在一个编辑器中打字很少会接近任何一个限制，但共享一个密钥的团队或并行发送许多请求的代理可能会。当你超过限制时，API 返回 HTTP 429。代码 rate_limited 表示每分钟请求过多，concurrency 表示同时请求过多。如果服务短暂过载，你还会看到带有 Retry-After: 5 的 429。
流式聊天会占用其并发槽位，直到流结束。对于共享使用，请为每个开发人员提供自己的密钥，而不是团队共用一个密钥。
故障排除清单
- 未找到模型。 重新输入
uncensored，不带空格。删除你不使用的旧自定义模型。 - 认证错误。 重新复制密钥。确保 Cursor 没有仍在使用来自其他提供商的密钥。
- 回复过早停止。 检查 Cursor 是否设置了其自己的输出上限。在我们这边，
max_tokens是可选的。 - 余额没有变化。 你使用的功能未通过你的自定义密钥路由。尝试聊天。
- 频繁 429。 降低并发请求，或使用完整密钥而不是试用密钥。
