控制台

Cursor

在 Cursor 编辑器中接入 iCreat API

Cursor 是一款 AI 驱动的代码编辑器，支持 Chat、Agent、Composer 等能力，可理解代码库、编辑文件并运行终端命令。通过 iCreat 的 OpenAI 兼容端点，你可以用 iCreat API Key 在 Cursor 中使用平台提供的多种模型，无需分别配置各厂商官方 Key。

产品能力

  • 对话与 Agent — 在编辑器内提问、规划功能、修复 Bug、审查改动
  • Composer / Plan Mode — 跨文件编辑与多步骤任务编排
  • MCP 扩展 — 连接外部工具与数据源（可选接入 iCreat MCP）
  • OpenAI 兼容接入 — 通过 Override Base URL 指向 iCreat，按模型 ID 灵活切换

接入方式

Cursor 通过 Settings → Models 中的 OpenAI API Key 与 Override OpenAI Base URL 接入 iCreat。iCreat LLM 端点兼容 OpenAI Chat Completions 协议，Cursor 会将对话请求发往 iCreat。

配置项 填写值
OpenAI API Key 你的 iCreat API Key（<sk-your-token>）
Override OpenAI Base URL https://api.icreat.ai/v1/llm
模型名称 在 Cursor 中手动添加，需与 iCreat 模型 ID 完全一致

说明

Tab 补全（Cursor Tab）通常走 Cursor 订阅自带的模型池，不一定会使用此处配置的自定义端点。本指南主要覆盖 Chat / Agent / Composer 等对话类能力。

开始之前

  • 已在 iCreat 创建 API Key（下文以 <sk-your-token> 占位）
  • 已安装 Cursor（macOS / Windows / Linux）
  • 网络可访问 https://api.icreat.ai
  • 已在 模型广场 确认目标模型的 模型 ID，且 API Key 分组包含该模型

配置 Cursor

打开模型设置

  1. 启动 Cursor 并登录（若需使用 Cursor 账户功能）
  2. 打开设置：macOS Cmd + Shift + J，Windows / Linux Ctrl + Shift + J
  3. 进入 Models（模型）面板

也可通过菜单 Cursor → Settings → Models 进入。

填写 API 信息

  1. 打开 OpenAI API Key 开关，填入 iCreat API Key
  2. 打开 Override OpenAI Base URL 开关
  3. 在 Base URL 中填写：
https://api.icreat.ai/v1/llm
  1. 若界面提供 Verify（验证）按钮，点击确认连接成功

注意

  • Base URL 填写主机根路径即可，不要手动追加 /chat/completions，Cursor 会自动拼接
  • 即使不使用 OpenAI 官方模型，也需开启 OpenAI API Key 开关，Key 会用于 iCreat 鉴权

添加模型

Cursor 不会自动拉取 iCreat 模型列表，需手动添加：

  1. 在 Models 面板找到 Add model（或 +）
  2. 输入 iCreat 上的模型 ID（例如 gpt-5.5、deepseek-chat 等，以控制台/文档为准）
  3. 保存后，在 Chat / Composer 的模型下拉框中选择该模型

提示

模型 ID 必须与 iCreat 平台一致，大小写、前缀均需匹配。可在控制台或 模型广场 查阅可用 ID。

验证连接

  1. 打开 Chat 或 Composer，选择上一步添加的模型
  2. 发送测试消息，例如：请回复「Cursor 已成功连接到 iCreat！」
  3. 登录 iCreat 控制台，在「使用日志」中确认有对应调用记录

推荐设置

  • 仅使用 iCreat 时：可在 Models 列表中关闭不需要的 Cursor 内置模型，避免误选
  • 连接失败时：打开 Settings → Network，尝试开启 HTTP Compatibility Mode（部分网关对 HTTP/2 支持不完整）
  • 避免 Key 冲突：若同时配置了 Anthropic / Google 等官方 Key，对话可能不走 iCreat；建议仅保留 OpenAI 自定义端点路径

配置参数说明

配置项 说明
OpenAI API Key iCreat API Key，Cursor 以 OpenAI BYOK 方式携带该 Key 请求 iCreat
Override OpenAI Base URL iCreat LLM 端点：https://api.icreat.ai/v1/llm
模型 ID iCreat 平台上的模型标识，需手动添加到 Cursor 模型列表

可选：接入 iCreat MCP

若希望在 Cursor 中通过 MCP 查询 iCreat 能力，可在 MCP 设置中添加 HTTP 服务：

  • 名称：icreat-api-mcp（或自定义）
  • 地址：https://icreat.ai/mcp

具体入口以 Cursor 当前版本的 Settings → MCP 为准。

常见问题

提示 Model not found 或无法选择模型？

  • 确认已在 Models 面板 Add model 中添加对应模型 ID
  • 确认 API Key 分组包含该模型
  • 模型 ID 是否与 iCreat 文档完全一致（无多余空格或错误前缀）

401 Unauthorized 或无法连接？

  • 检查 API Key 是否有效、未过期
  • 确认 Base URL 为 https://api.icreat.ai/v1/llm（含 /v1/llm）
  • 尝试开启 HTTP Compatibility Mode 后重试

Override Base URL 开关自动打开或配置不生效？

  • 清空 Base URL 字段 → 关闭开关 → 完全退出 Cursor（macOS Cmd + Q）→ 重新打开后再配置
  • 关闭多余的 Cursor 窗口，仅保留一个实例后修改设置
  • 若仍异常，可暂时移除 API Key 后重启 Cursor，再重新添加

Tab 补全没有走 iCreat？

Cursor Tab 补全通常使用 Cursor 订阅模型，与 OpenAI Base URL override 相互独立。若需统一计费与模型来源，请以 Chat / Agent / Composer 为主。

如何确认请求走了 iCreat？

在对话中正常收到回复后，到 iCreat 控制台「使用日志」查看是否有对应 Token 消耗记录。