OpenCode

在 OpenCode 中接入 Fusion Model。

接入参数

使用 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

关于 OpenCode

OpenCode↗ 是开源编程 Agent，提供终端和桌面应用。它支持自定义服务商、结合项目上下文的编程工作流、多会话和语言服务器集成。

Fusion 通过 OpenCode 的 OpenAI 兼容 Chat Completions 适配器接入。

快速开始

1. 安装 OpenCode

使用官方安装脚本：

curl -fsSL https://opencode.ai/install | bash

npm、Homebrew、Windows 等其他安装方式，请参阅 OpenCode 安装指南↗。

2. 获取 FUMO API Key

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

3. 添加 Fusion 凭证

在项目目录中启动 OpenCode：

cd /path/to/your/project
opencode

运行 /connect，找到并选择 Other（其他），然后填写以下信息，其中 API key 使用你的 FUMO API Key：

Provider ID: fumo
API key:     your FUMO API key

服务商 ID 填写 fumo，与下方配置中的名称保持一致。

4. 配置服务商

创建或更新项目中的 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "fumo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FUMO",
      "options": {
        "baseURL": "https://capi.fumolab.ai/api/fusion/v1"
      },
      "models": {
        "fusion-code-1.0": {
          "name": "Fusion Code"
        },
        "fusion-max-2.0": {
          "name": "Fusion Max 2.0"
        },
        "fusion-max-1.0": {
          "name": "Fusion Max"
        }
      }
    }
  }
}

@ai-sdk/openai-compatible 使用 /chat/completions 接口。Fusion 也提供 /responses；在 OpenCode 中使用该接口时，对应的适配器为 @ai-sdk/openai。

5. 选择 Fusion Code

运行：

/models

先选择 FUMO，再选择 Fusion Code。之后 OpenCode 会使用 fusion-code-1.0 发送请求。

选择模型 ID

可以随时通过 /models 切换已为当前 Key 授权的模型 ID：

Fusion Code — 适合编程和软件 Agent 工作流，可作为默认选择。
Fusion Max — 适合复杂推理和更广泛的 Agent 任务。

OpenCode 要求在服务商配置中声明模型名称。公共网关会校验传入的 ID；请求通过后，Fusion 核心只将其作为兼容标签，内部拓扑仍由配置控制。

常见问题

身份验证失败

运行 opencode auth list，检查是否已保存 fumo 的凭证。必要时重新运行 /connect，确保服务商 ID 与 opencode.json 中的一致。

找不到模型

确认 opencode.json 的 provider.fumo.models 中已列出该 ID，且它已为当前 Key 授权。客户端或公共网关可能在请求进入 Fusion 核心前拒绝该模型。

接口返回 404

将 options.baseURL 设为 https://capi.fumolab.ai/api/fusion/v1。OpenCode 会自动追加 /chat/completions。

工具调用失败

确认服务商使用 @ai-sdk/openai-compatible。如果客户端额外发送了服务商专有字段，请对照 Fusion Chat Completions 接口说明检查请求。