Cursor 接入教程

按照 KunAI 的 Cursor 接入教程配置 Base URL、API Key 与模型，并完成连接测试和常见问题排查。

配置步骤

  1. 打开 Cursor Settings，进入 Models 并展开 API Keys。
  2. 将 Base URL 设置为 https://kunai.one/v1，并确认地址中没有重复的路径。
  3. 填入 KunAI 的 API Key，再通过 GET https://kunai.one/v1/models 选择一个精确的模型 ID。
  4. 保存配置后新建一个对话发送测试消息，确认响应、用量记录和计费均正常。

兼容性说明

Cursor 的通用 OpenAI 兼容能力取决于客户端版本；普通对话可先验证，Agent、Tab 等专用功能可能仍使用 Cursor 自身服务。

常见问题排查

  • 出现 401 时，检查 API Key 是否有效以及 Authorization Bearer 格式是否正确。
  • 出现 404 或 model not found 时，重新读取 /v1/models 并核对 Base URL 与模型 ID。
  • 出现 429 时，检查访问频率、客户端并发设置和响应中的 Retry-After 提示。
  • 出现 502 Upstream request failed 时，先用新对话验证基础请求，再检查所选模型与服务状态。

继续阅读