Model 广场Model 广场

Cursor 集成

把 Cursor 的 Custom OpenAI Base URL 指向本网关,在 Cursor Chat 里使用 70+ 文本模型

Cursor 在 Settings → Models 中支持 Custom OpenAI API。

配置#

  1. 打开 Cursor → ⚙️ Settings → Models
  2. 滚到底部 → OpenAI API Key section
  3. 勾选 Override OpenAI Base URL
  4. 填:
    • Base URL: https://api.dflop.top/v1
    • API Key: sk-gpushare-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx(sk-gpushare- + 64 位十六进制字符,总长 76 字符)
  5. 在上面的模型列表里 Add Model: 填入想用的 model ID,如:
    • claude-sonnet-4-6
    • gpt-5.5
    • glm-5.1
    • gemini-2.5-pro
    • 完整列表见 模型列表
  6. 取消勾选 Cursor 内置的 OpenAI 模型(gpt-4o / gpt-4o-mini 等)——它们不在模型目录里,留着会导致下一步 Verify 失败
  7. 点 Verify 确认连通

为什么 Add Model 要在 Verify 之前? Cursor 的 Verify 会用模型列表里当前启用的模型发测试请求。如果还勾着内置的 gpt-4o 等模型,网关会返回 model_not_found——即使 Base URL 和 Key 全对,Verify 也会 fail。

行为#

Cursor 走 OpenAI Chat 协议,可用模型 = GET /v1/models 返回的全部文本模型(70+ 个,持续增加),详见 兼容矩阵 与 模型列表。图像 / 视频 / embedding 模型走独立端点,不经此协议,见 图像 / 视频 / Embedding API。

注意事项#

Composer / Agent / Tab autocomplete 走 Cursor 私有服务#

  • Cursor Chat 聊天框 —— ✅ 走你配置的 Custom Base URL (本平台)
  • Composer (Cmd+I) —— ❌ 走 Cursor 自家服务,不经过本网关
  • Tab autocomplete —— ❌ 同上
  • Agent (Cmd+Shift+I) —— ❌ 同上

如果你希望整个 Cursor 全走本网关,目前没有官方支持。Cursor 把上述功能跟订阅绑定。

推荐用法#

场景选择
长对话 / 复杂任务Cursor Chat (走本网关,模型选 Claude / GPT-5.x)
短补全 / inline edit用 Cursor 原生 (订阅内)
完整 AI Coding 走本网关用 FlopCode 或 Cline

常见问题#

现象排查
Verify fail,但 URL 和 Key 都正确Cursor 默认启用的内置 OpenAI 模型(gpt-4o 等)不在模型目录 → 网关返回 model_not_found。关闭内置模型,仅启用已 Add 的 model ID 后再 Verify
Verify fail,连接不通Base URL 拼写;/v1 不能少
模型不在 dropdown必须先 Add Model 手动添加 model ID
401(invalid_api_key)Key 无效 / 已吊销 / 已过期。检查是否复制完整(sk-gpushare- + 64 位十六进制);完整 Key 可随时在 控制台 Key 详情页 重新查看
400(model_not_allowed)这把 Key 设置了模型白名单(allowed_models),不含当前模型 → 去 控制台 编辑白名单或换一把无限制的 Key
402(insufficient_quota,code quota_exceeded)账户余额耗尽。所有 Key 共享同一余额,新建 Key 不能解决 → 去 dflop.top/dashboard/billing 充值(Stripe,最低 $1)

错误码完整说明见 错误处理。

其他客户端#