Cursor

通过 Cursor 的自定义 OpenAI 服务商设置接入 Fusion Model。

兼容范围： Cursor 官方将自定义 API Key 的支持范围限定为标准聊天模型。OpenAI Base URL 覆盖设置会全局生效，Cursor 发送的请求也可能与标准 Chat Completions 格式有差异。基础对话可先行测试；Agent 工具调用、流式工具参数、推理输出，以及后续客户端更新都可能带来兼容问题。

接入参数

使用 FUMO Dashboard 的 Key，适用于线上注册与充值的账号。

参数	值
Base URL	`https://capi.fumolab.ai/api/fusion/v1`
可用模型 ID	`fusion-max-2.0`、`fusion-max-1.0`、`fusion-code-1.0`
API 协议	OpenAI Chat Completions API

关于 Cursor

Cursor↗ 是一款 AI 代码编辑器，提供对话、代码编辑和 Agent 工作流。

Cursor 的 Override OpenAI Base URL 选项可指定自定义 OpenAI 兼容接口。通过该选项即可配置 Fusion。

配置步骤

1. 获取 FUMO API Key

按照快速开始中的线上自助步骤（企业账号请见企业接入指南），创建并保存 API Key。已有销售对接的 FUMO 用户，请在注册时填写 Sales Code，或登录后按账号说明绑定。

2. 配置 OpenAI 服务商

打开 Cursor Settings（Cursor 设置）。
进入 Models（模型），展开 API Keys。
启用 OpenAI API Key，填入 FUMO API Key。
启用 Override OpenAI Base URL。
填入以下地址：

https://capi.fumolab.ai/api/fusion/v1

Base URL 是接口前缀。发送标准 OpenAI 聊天请求时，Cursor 应在其后追加 /chat/completions。

此设置会全局生效。切回 Cursor 托管模型前，请先关闭覆盖设置。使用自定义 API Key 的请求仍会经过 Cursor 后端完成提示词组装，再发送到配置的接口。

3. 添加 Fusion Code

在 Cursor 模型设置中添加：

fusion-code-1.0

在 Chat 或 Agent 中选择该模型。先发送一条简单的文本问题，确认响应正常后，再测试代码编辑或终端工具。

也可以添加已授权的 Fusion Max 模型 ID：

fusion-max-1.0

兼容性限制

Agent 工具： Cursor 可能会展开或转换工具定义与调用结构，而 Fusion 要求标准 Chat Completions 格式。
流式工具调用： 工具参数分批返回时，可能需要针对 Cursor 的适配才能正确拼接。
模型校验： Cursor 可能按内置 OpenAI 模型的规则校验自定义模型，或请求 Fusion 尚未提供的模型列表接口。
推理信息： 服务商专有的推理字段可能被忽略或拒绝。
托管模型： 启用 Base URL 覆盖后，内置 OpenAI 模型的请求也可能被发往该地址。切回 Cursor 托管模型时，请关闭覆盖设置。
客户端更新： Cursor 的内部请求格式可能随版本更新而变化。

如果普通对话正常、工具调用失败，建议优先检查工具调用格式和客户端兼容性。也可使用直接通过 Chat Completions 接入的 OpenCode。

常见问题

身份验证失败

确认使用的是在控制台创建的 API Key，且复制完整。核对所选模型 ID；如果返回 403，请按首次调用排障检查权限。

接口返回 404

将覆盖地址设为 https://capi.fumolab.ai/api/fusion/v1。除非当前 Cursor 版本明确要求填写完整接口地址，否则不要追加 /chat/completions。

Cursor 拒绝模型 ID

确认 Cursor 模型设置中已经添加完全一致的已授权 ID。Cursor 可能在发送请求前拒绝该 ID；未知或未授权的 ID 也可能在进入 Fusion 核心前被公共网关拒绝。

对话正常，但 Agent 运行失败

通常需要检查请求结构或工具调用的兼容性。Cursor 可能需要专门的请求格式转换，Fusion 目前未提供这类适配。