文档 · 接入指南

Cursor 接 TopxAI：覆盖 OpenAI 基础地址

2026-09-19

在 Cursor 里把 TopxAI 密钥填到 OpenAI 密钥栏，打开基础地址覆盖填 https://ai.topxea.com/v1，再添加要聊天的模型 ID。

Cursor 允许自带 OpenAI 兼容端点来聊天。覆盖只对你按名字添加的模型生效；Cursor 自己在服务器上跑的功能，还是用 Cursor 的模型。

设置

1. 打开 Cursor Settings 里的 Models。
2. 在 OpenAI API Key 下粘贴一把 TopxAI 密钥（自动路由覆盖全部模型）。
3. 打开 Override OpenAI Base URL，填 https://ai.topxea.com/v1。
4. 点 Verify。Cursor 会发一个小请求，TopxAI 的用量日志里能看到。
5. 在模型列表下 Add model，按目录原样输入 ID：claude-sonnet-5-5、gpt-6.1-sol、grok-4.7、kimi-k3、GLM-5.3-Abliterated。在选择器里勾上要用的。

Cursor 把添加的模型都发到 /v1/chat/completions，这个接口提供除 Jev 以外的全部文本模型，所以 Claude 在这里走 OpenAI 格式就行，不用另配 Anthropic 密钥。

会发生什么

• 用添加的模型聊天和行内编辑，请求经 TopxAI，按该模型在密钥线路上的价格计费。
• 打开覆盖后，Cursor 内置的 OpenAI 模型在选择器里会消失；关掉覆盖就回来。
• Cursor 会带自己的系统提示，agent 模式下还带工具定义，这些都算输入 token。

不通时

• 401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
• curl 能通、工具不通：这一页按工具列出常见原因。

模型：claude-sonnet-5-5, gpt-6.1-sol · 模型与价格

相关

• 接入你的 SDK
• 创建 API 密钥并选择线路
• curl 能跑通，工具里却报错
• 常见错误响应
• Cline 和 Roo Code 接 TopxAI：OpenAI 兼容供应商
• Continue 接 TopxAI：config.yaml 里的模型
• Claude Sonnet 5.5 API pricing
• GPT-6.1 Sol API pricing

上一页：Codex CLI 接 TopxAI：下载、安装、配置 · 下一页：Cline 和 Roo Code 接 TopxAI：OpenAI 兼容供应商

其他语言：English