Cursor 接入指南

最后更新

AI 代码编辑器,可把对话侧的模型换成自定义端点。

适用场景

适合在编辑器里用对话方式写代码、解释和重构:把对话侧使用的模型指向平台的端点。Tab 补全仍使用 Cursor 自带的模型。

使用建议

编程场景的输入通常较长,建议选上下文较长的模型,并给密钥设置每日消费上限,避免长任务意外消耗过多。

连不通时检查

  1. API 地址填 https://omnimodel.me/v1,不要多写 /chat/completions。
  2. 密钥以 key_ 开头且没有被暂停或撤销,错误码 auth.invalid_key 表示密钥不可用。
  3. 模型 ID 与模型目录一致,并且在这把密钥的可用模型里。
  4. 余额不足会返回 billing.insufficient_credit,更多错误见常见错误。

配置步骤

  1. 打开「Settings → Models」,展开 OpenAI API Key。
  2. 填入密钥,勾选 Override OpenAI Base URL 并填入 API 地址。
  3. 在模型列表中添加模型 ID,点 Verify 验证。

配置参数

  • API 地址:https://omnimodel.me/v1
  • API 密钥:YOUR_API_KEY
  • 模型:MODEL_ID

Tab 补全等内置能力只走 Cursor 自己的模型,覆盖 base URL 不会改变它们的计费。

常见问题

Tab 补全会走平台的模型吗?
不会。自定义端点只对对话侧的模型生效,Tab 补全仍然使用 Cursor 自带的模型。
为什么提示模型不可用?
确认填写的模型 ID 与模型目录一致,并且在密钥的可用模型里。