Cursor 接入教程

Cursor 接入 GPT API:自定义 API Key 与 Override OpenAI Base URL 配置教程

Cursor 是一款 AI 代码编辑器,在设置里打开 Override OpenAI Base URL,就能接入 OpenAI 兼容的第三方 API 调用 GPT 模型。GPT.COM.SE 是第三方 GPT 模型 API 服务,非 OpenAI 官方,与 OpenAI 无隶属关系,国内网络可直接访问。本页按准备 Key、4 步配置、两条已知限制、适用场景、模型与费用、报错排查、模型自检的顺序讲,要填的值可以直接复制。

更新于

Cursor 接入 GPT API:打开 Cursor 设置里的 Models,在 OpenAI API Key 下展开 Override OpenAI Base URL 填 https://gpt.com.se/v1,API Key 填本站「OpenAI」分组的 sk- Key 并点 Verify,再添加自定义模型 gpt-5.6-sol 或 gpt-6-astra 即可;GPT.COM.SE 是第三方 API 服务,非 OpenAI 官方。

准备:一把 OpenAI 分组的 API Key

Cursor 接入 GPT API 只需要一把 GPT.COM.SE「OpenAI」分组的 API Key,配置全在 Cursor 自带的设置页里完成。API Key 是一串以 sk- 开头的密钥,相当于调用接口的密码;分组决定这把 Key 能调哪类模型。

  1. 打开 注册页,用邮箱注册,收验证码完成登录。用纯数字 QQ 邮箱(如 123456789@qq.com)注册的新用户送 5 美元体验额度,英文别名的 QQ 邮箱不送,活动仅限中国用户。
  2. 体验额度用完后到「充值」页面充值,支持微信、支付宝。按量计费,用多少扣多少。
  3. 进「API 密钥」页面点新建,分组选「OpenAI」。复制出来的 sk-xxxxxxxx 就是你的 Key。
对话和写代码用「OpenAI」分组的 Key,「GPT 生图」分组的 Key 用于生图模型,Cursor 里要用前者。Key 就是钱,不要贴到网页、截图和公开仓库里;怀疑泄露就去控制台删掉重建,旧 Key 立即作废。

Cursor 自定义 API 配置步骤(4 步)

在 Cursor 设置的 Models 页里填三样东西:Override OpenAI Base URL 填 https://gpt.com.se/v1,OpenAI API Key 填你的 sk- Key,再添加自定义模型名。Base URL 是接口的根地址,OpenAI 兼容工具会在它后面接上 /chat/completions 这类具体路径,所以 Cursor 里的地址结尾要带 /v1。

  1. 打开 Cursor 设置 → Models。
  2. 找到 OpenAI API Key,展开 Override OpenAI Base URL,填 https://gpt.com.se/v1。
  3. API Key 填你的 sk-xxx,点 Verify 验证。
  4. 在模型列表里添加自定义模型,填 gpt-5.6-sol 或 gpt-6-astra,勾上启用。

要填的值(可直接复制)

Override OpenAI Base URL:https://gpt.com.se/v1
OpenAI API Key:sk-你的Key
自定义模型:gpt-5.6-sol
自定义模型:gpt-6-astra
设置项填什么常见填错
Override OpenAI Base URLhttps://gpt.com.se/v1漏了 /v1,或者多写成 /v1/chat/completions,会报 404 或连不上
OpenAI API Key本站「OpenAI」分组的 sk- Key复制时带了多余空格,或者用了「GPT 生图」分组的 Key
自定义模型gpt-5.6-sol、gpt-6-astra 等本站在售模型名模型名拼错,或者填了本站暂未提供的 gpt-6-luna
地址规则记一句:Cursor 填带 /v1 的 https://gpt.com.se/v1;只有 Codex 的 config.toml 和 WorkBuddy 填不带 /v1 的根地址 https://gpt.com.se。

Cursor 官方论坛报告的两条已知限制

开启自定义地址前先知道两条限制:开启 Override OpenAI Base URL 后,所有 OpenAI 模型的请求都会走自定义地址;BYOK 模式不会发送 reasoning_effort 参数。两条都来自 Cursor 官方论坛的问题报告。BYOK 是 Bring Your Own Key 的缩写,指用你自己的 API Key 调模型;reasoning_effort 是推理强度参数,控制模型回答前思考得多充分。

已知限制对你的影响怎么应对
开启 Override OpenAI Base URL 后,所有 OpenAI 模型的请求都走自定义地址你在 Cursor 里选的 OpenAI 模型,请求都会发到 https://gpt.com.se/v1,用你填的本站 Key 扣本站额度;请求本站暂未提供的模型(例如 gpt-6-luna)会直接报错只在要用本站模型时开启;想切回 Cursor 自带的 OpenAI 模型,先关掉 Override OpenAI Base URL。每次调用在控制台都有明细,可以随时核对
BYOK 模式不发送 reasoning_effort 参数在 Cursor 里调推理强度可能不起作用,发到接口的请求里不带这个参数复杂推理任务直接选更强的模型,例如 gpt-6-astra;需要指定推理强度就改用 Codex,它的 config.toml 里 model_reasoning_effort = "high" 一行就是推理强度设置
这两条是 Cursor 客户端自身的行为,本站这边改不了。Cursor 更新版本后行为可能变化,以你实际使用的版本为准。

Cursor 自定义 API 适合哪些场景

适合在 Cursor 的 Chat 里用 gpt-6-astra、gpt-5.6-sol 这类自定义模型问答、解释代码、写代码;需要完整的 Agent 体验时,更适合配 Codex 或 opencode。Cursor 的自带 Agent 功能对模型有绑定,自定义地址主要用于 Chat 和自定义模型场景。

场景是否适合说明
在 Chat 里用自定义模型问答、解释代码、写函数适合自定义地址主要服务这类场景,按用量扣费,用多少扣多少
在国内网络下用 GPT 模型适合OpenAI 官方 API 不向中国大陆提供服务;本站是第三方服务,国内网络可直接访问。2026-09-30 从中国大陆腾讯云机器实测,首字节(从发出请求到收到第一段数据的时间)0.45 到 0.8 秒;这是直连本站测得的数据,Cursor 里的实际响应以你的使用为准
需要 Cursor 自带 Agent 的完整体验不适合自带 Agent 对模型有绑定;要完整的终端 Agent 体验建议配 Codex 或 opencode
需要精确控制推理强度不适合BYOK 模式不发送 reasoning_effort;改用 Codex,在 config.toml 里设置 model_reasoning_effort
同时用 Cursor 自带的 OpenAI 模型和本站模型要手动切换开启覆盖后所有 OpenAI 模型都走自定义地址,两边来回用要手动开关 Override OpenAI Base URL
想在 Cursor 里接 Claude、Gemini不适合本站只做 GPT,不提供 Claude、Gemini、Grok

Cursor 里用哪个 GPT 模型,花多少钱

写代码和复杂推理选 gpt-6-astra,想用 GPT-5.6 旗舰选 gpt-5.6-sol,日常主力选 gpt-5.6-terra,量大又简单的活选 gpt-5.6-luna 省钱。本站按 OpenAI 官方美元标价扣费,分组倍率 1,充值 1 元人民币得 1 美元站内额度,按 1 美元约 7 元算,花费约为美元直付的七分之一。token 是模型计量输入和输出文字量的单位,下表按每百万 token 计价。

模型(填进 Cursor 的名字)定位官方价(每百万 token,输入 / 缓存读 / 输出)本站实付(人民币,每百万 token)
gpt-6-astraGPT-6 旗舰,上下文 1.05M,Agent、编程、复杂推理$10 / $1 / $50¥10 / ¥1 / ¥50
gpt-6-solGPT-6 家族性价比档,2026-09-22 发布$2 / $0.2 / $10¥2 / ¥0.2 / ¥10
gpt-5.6-solGPT-5.6 旗舰档$4 / $0.4 / $20(官方限时价)¥4 / ¥0.4 / ¥20
gpt-5.6-terraGPT-5.6 均衡档,日常主力$2 / $0.2 / $12¥2 / ¥0.2 / ¥12
gpt-5.6-lunaGPT-5.6 经济档,高频批量$0.2 / $0.02 / $1.2¥0.2 / ¥0.02 / ¥1.2
gpt-5.5上代旗舰$5 / $0.5 / $30¥5 / ¥0.5 / ¥30
官方价来源:OpenAI 官方定价,核对日期 2026-09-30。gpt-5.6-sol 的 $4 / $20 是官方限时价,官方说明至少到 2026-11-21;单次请求输入(含缓存读)超过 272K token 时,在售对话模型都按输入和缓存读 2 倍、输出 1.5 倍计价。上下文指模型一次能读进的内容总量;缓存读指输入里命中缓存的部分,按更低的单价计费。

算例:一次带 2 万 token 代码上下文的 Chat 提问

假设一次提问把 20,000 token 的代码和对话记录作为输入,模型回答 2,000 token,不计缓存,各模型这一次的费用如下(本站实付,人民币):

模型输入费用输出费用这一次合计
gpt-6-astra20,000 × ¥10 ÷ 100 万 = ¥0.22,000 × ¥50 ÷ 100 万 = ¥0.1¥0.3
gpt-5.520,000 × ¥5 ÷ 100 万 = ¥0.12,000 × ¥30 ÷ 100 万 = ¥0.06¥0.16
gpt-5.6-sol20,000 × ¥4 ÷ 100 万 = ¥0.082,000 × ¥20 ÷ 100 万 = ¥0.04¥0.12
gpt-5.6-terra20,000 × ¥2 ÷ 100 万 = ¥0.042,000 × ¥12 ÷ 100 万 = ¥0.024¥0.064
gpt-6-sol20,000 × ¥2 ÷ 100 万 = ¥0.042,000 × ¥10 ÷ 100 万 = ¥0.02¥0.06
gpt-5.6-luna20,000 × ¥0.2 ÷ 100 万 = ¥0.0042,000 × ¥1.2 ÷ 100 万 = ¥0.0024¥0.0064

同样一次提问,gpt-6-astra 的费用是 gpt-5.6-sol 的 2.5 倍,gpt-5.6-luna 只要 ¥0.0064,约为 gpt-5.6-sol 的 5%。实际费用以控制台每次调用的明细为准。完整价格见 GPT API 价格,型号对比见 全部 GPT 模型与选型、GPT-6 Astra 和 GPT-5.6 Sol、Terra、Luna。

Cursor 接入 GPT API 报错排查表

报错先看状态码:401 查 Key,403 查余额,404 查地址,模型不存在查模型名。Verify 不通过时,先在终端用下面的 curl 命令单独测一次 Key 和地址:curl 能返回结果,问题就在 Cursor 里的填写;curl 也失败,问题在 Key、余额或地址。curl 是在命令行里发送网络请求的工具,Windows 建议在 WSL2 里运行。

curl https://gpt.com.se/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }'
报错或现象常见原因怎么处理
Verify 不通过、401、无效密钥Key 复制错了、带了多余空格,或者填错了字段到控制台重新复制 Key,填进 OpenAI API Key 一栏;确认 Key 是「OpenAI」分组,和调用的模型对得上
403、余额不足账户余额用完了到「充值」页面充值,控制台能随时看余额和用量明细
404 或连不上Override OpenAI Base URL 漏了 /v1,或者多写了路径改回 https://gpt.com.se/v1,后面的路径由 Cursor 自己拼接
模型列表拉不出来、提示获取失败多为地址或 Key 没填对先按 /v1 规则检查地址,再重新复制 Key
提示模型不存在或不可用模型名写错,或者填了本站暂未提供的模型(如 gpt-6-luna)按本页模型表原样填写;本站不做模型替换,没有的模型直接报错
开启覆盖后,Cursor 自带的 OpenAI 模型报错或扣了本站额度已知限制:开启 Override OpenAI Base URL 后,所有 OpenAI 模型的请求都走自定义地址要用 Cursor 自带的 OpenAI 模型时,先关掉 Override OpenAI Base URL
调了推理强度,回答没有变化已知限制:BYOK 模式不发送 reasoning_effort复杂任务换 gpt-6-astra;需要指定推理强度改用 Codex
Chat 能用,自带 Agent 用不了自定义模型Cursor 自带 Agent 对模型有绑定自定义地址主要用于 Chat 和自定义模型场景;要终端 Agent 体验配 Codex 或 opencode
请求一直转圈、没有响应地址填错最常见先确认地址是 https://gpt.com.se/v1,再用上面的 curl 命令单独测一次
还是搞不定,到 使用教程 页底部的「反馈留言」写下 Cursor 版本号、模型名和报错内容,留个联系方式,方便回复你。

怎么确认 Cursor 调用的就是你选的模型

看控制台的用量明细:每次调用都记录模型名、token 数和费用,和你在 Cursor 里选的模型对一下就清楚。

本站不做模型替换,用户请求哪个模型就调用哪个模型,缺货时直接报错,不会偷偷换成别的模型。开启 Override OpenAI Base URL 后,Cursor 里所有 OpenAI 模型的请求都会走本站,明细里出现你没主动选的模型名时,先按这条已知限制排查。更多自检方法见 不替换模型与自检方法。

常见问题

cursor自定义api怎么配置?

在 Cursor 设置的 Models 页里,展开 OpenAI API Key 下的 Override OpenAI Base URL,填 https://gpt.com.se/v1。API Key 填本站「OpenAI」分组的 sk- Key,点 Verify 验证,再添加自定义模型 gpt-5.6-sol 或 gpt-6-astra 并勾上启用。GPT.COM.SE 是第三方 API 服务,非 OpenAI 官方。

cursor 自定义 api key 填在哪里?

填在 Cursor 设置 → Models 里的 OpenAI API Key 一栏,填好后点 Verify 验证。Key 要用本站「OpenAI」分组的,「GPT 生图」分组的 Key 用于生图模型。Key 就是钱,不要贴到截图和公开仓库里。

cursor使用中转站api,会影响 Cursor 自带的 OpenAI 模型吗?

会。Cursor 官方论坛有报告:开启 Override OpenAI Base URL 后,所有 OpenAI 模型的请求都会走自定义地址,用的是你填的那把 Key 和对应服务的额度。想切回 Cursor 自带的模型,先关掉这个开关。

cursor override openai base url not working 怎么办?

先查地址:必须是带 /v1 的 https://gpt.com.se/v1,漏了 /v1 或多写路径都会报 404 或连不上。再查 Key 有没有多余空格、分组是否为「OpenAI」,以及余额够不够。最后用本页的 curl 命令单独测一次,curl 能通就说明问题在 Cursor 里的填写。

cursor 自定义模型收费吗?

走本站的调用按本站计费:按 OpenAI 官方美元标价扣站内额度,充值 1 元人民币得 1 美元额度,用多少扣多少。例如一次输入 2 万 token、输出 2000 token 的提问,用 gpt-5.6-sol 约 ¥0.12。Cursor 自身的订阅怎么收费,以 Cursor 的说明为准。

cursor gpt5.6 和 gpt-6 怎么选?

要 GPT-6 旗舰选 gpt-6-astra,要 GPT-5.6 旗舰选 gpt-5.6-sol,想用 GPT-6 家族又想省钱选 gpt-6-sol。三个都在 Cursor 的自定义模型里原样填模型名。官方价每百万 token:gpt-6-astra 输入 $10、输出 $50,gpt-5.6-sol 输入 $4、输出 $20(官方限时价),gpt-6-sol 输入 $2、输出 $10。

Cursor BYOK 模式下推理强度为什么不生效?

Cursor 官方论坛有报告:BYOK 模式不会发送 reasoning_effort 参数,所以在 Cursor 里调推理强度可能不起作用。这是 Cursor 客户端的行为,接口这边收不到这个参数。需要指定推理强度,改用 Codex,在 config.toml 里设 model_reasoning_effort = "high"。