Cursor 接入 kkaiapi

最后更新:

核对 Cursor 版本是否开放自定义 API 地址,配置普通聊天模型并验证实际请求,区分自带 Key 与 Tab 等专用功能。

先确认安装版本开放自定义端点

在 Cursor Settings → Models / API Keys 查看当前版本是否提供 OpenAI Key 与 Override OpenAI Base URL;只有可用时才填写下表并添加精确模型 ID。若没有入口,先核对官方说明与版本,不把未提供的能力当作配置错误。

配置项值
协议路径OpenAI-compatible Chat Completions
Override OpenAI Base URL(若提供)https://api.kkaiapi.com/v1
OpenAI API Key自己的 KK Key
Model ID(可添加时)gpt-5.5

保存后验证一次聊天请求

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
                base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
r = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "请只回复 pong"}],
)
print(r.choices[0].message.content)

核对实际生效的工具路径

保存后先在普通聊天中验证该模型,并核对实际调用记录。Cursor 官方说明自带 Key 主要用于标准聊天模型;Tab Completion 等专用模型功能继续使用 Cursor 自身服务。不能由普通聊天成功推定所有 Agent 或编辑功能均兼容。

配置依据与能力验证

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

配置字段依据cursor 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。

常见问题

为什么 API 请求成功,工具仍不能完成任务?

继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。