OpenCode 配置 GrooRoute Pro：opencode.json 写法

OpenCode 接入 GrooRoute Pro，是在项目的 opencode.json 里加一个名为 grooroute 的 provider：baseURL 填 https://grooroute.xyz/v1，apiKey 写成 {env:GROOROUTE_API_KEY}。API Key 放在环境变量里，不进配置文件。配置好以后打开 OpenCode，用 /models 选中 GrooRoute 的模型即可。

第一步：准备 API Key

export GROOROUTE_API_KEY='<your key>'

<your key> 是占位符，换成你那把密钥的内容。

第二步：写 opencode.json

把下面的内容合并进项目里的 opencode.json。如果文件里已经有别的 provider，只需要把 grooroute 这一段加进 provider，并按需要修改 model 和 small_model。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "grooroute/deepseek-v4.1-flash",
  "small_model": "grooroute/deepseek-v4.1-flash",
  "provider": {
    "grooroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GrooRoute",
      "options": {
        "baseURL": "https://grooroute.xyz/v1",
        "apiKey": "{env:GROOROUTE_API_KEY}"
      },
      "models": {
        "deepseek-v4.1-flash": {
          "name": "deepseek-v4.1-flash"
        }
      }
    }
  }
}

示例里的 deepseek-v4.1-flash 是平台当前发布的模型清单里第一个声明了 OpenAI 兼容（chat completions）协议的模型，所以 npm 写 @ai-sdk/openai-compatible。可以换成模型页列出的其他模型 ID，四处都要换；换了模型，npm 要跟着它声明的协议改，见下面「npm 写哪个包」。

各项的含义：

配置项	说明
`model`、`small_model`	写成 `grooroute/模型 ID`，前一段是 provider 的名字。
`npm`	这个 provider 使用的适配包，见下面「npm 写哪个包」。
`options.baseURL`	接口地址，以 `/v1` 结尾。
`options.apiKey`	`{env:GROOROUTE_API_KEY}` 表示从这个环境变量读取密钥。
`models`	这个 provider 下可选的模型，键是模型 ID。

第三步：选择模型并验证

在设置了环境变量的同一个终端里打开 OpenCode，用 /models 选择 GrooRoute 的模型，然后发一句话试试。能正常回复，就说明地址、密钥和模型都对。

npm 写哪个包

这取决于所选模型在你这把 Key 的档位上声明了哪种协议：

声明了 OpenAI 兼容协议（接口 /v1/chat/completions）：写 @ai-sdk/openai-compatible。
只声明了 Responses 协议（接口 /v1/responses）：写 @ai-sdk/openai。
两种都没有声明：这个模型暂时不能在 OpenCode 里使用。

不必自己判断。站内的接入文档页会按你选的 Key 和模型生成这份 opencode.json，npm 一项已经按协议填好，直接复制即可。

不通的时候先看什么

401：密钥没带上或不被接受。确认 GROOROUTE_API_KEY 是在启动 OpenCode 的那个终端里设置的。
404：地址不对。baseURL 只填到 /v1 为止，不要写成 https://grooroute.xyz/v1/v1，也不要把 /chat/completions 一起填进去。
403：模型不在这把 Key 的分组或模型范围内，或者余额、额度不足。

每种状态码的原文和处理办法见常见报错排查；地址的填法见API 地址要不要带 /v1。

常见问题

npm 一项该写哪个包？

所选模型声明了 OpenAI 兼容（chat completions）协议时写 @ai-sdk/openai-compatible，只声明了 Responses 协议时写 @ai-sdk/openai。接入文档页会按你选的 Key 和模型给出对应的一种。

apiKey 可以直接写 Key 吗？

站内生成的配置写的是 {env:GROOROUTE_API_KEY}，Key 放在环境变量里，不进配置文件。

配置好之后怎么选模型？

在同一个终端里设好环境变量，打开 OpenCode，用 /models 选择 GrooRoute 的模型。

最后更新：2026-10-11