SupaRouter 文档

Appearance

Opencode 接入 SupaRouter ​

推荐模型

本文以 SupaRouter 旗舰模型 gpt-5.5 作为 Provider 示例介绍 Opencode 接入方式。gpt-5.5 当前倍率为 0.2，价格约为 OpenAI 官方价格的 1/35，适合在 Opencode 中作为高性价比主力模型使用。实际价格和可用分组以 SupaRouter 模型价格页展示为准。

接入准备 ​

接入必备信息

  • Base URL
    • 普通场景使用 https://api.suparouter.xyz/v1
    • 大陆手机用户使用 https://api-cn.suparouter.xyz/v1
  • 模型名：确认当前 API Key 分组下要调用的模型名，本文档以gpt-5.5为例。
  • API Key：在 SupaRouter 控制台创建 API Key，确保模型和 API Key 的分组相同并保存好完整 Key。

配置文件说明 ​

Opencode 的 Provider 配置写在 opencode.json 中。推荐把项目专用配置放在当前项目根目录的 opencode.json，这样不同项目可以使用不同模型。

API Key 不建议直接写进 opencode.json。你可以二选一：

  • 在 Opencode 里运行 /connect，选择 Other，Provider ID 填 suparouter，再粘贴 SupaRouter API Key。
  • 使用环境变量 SUPAROUTER_API_KEY，并在 opencode.json 里通过 {env:SUPAROUTER_API_KEY} 引用。

安装 Opencode ​

Windows ​

Windows 上官方推荐优先使用 WSL。如果你使用 WSL，请按本文的 macOS / Linux 步骤执行。

如果使用原生 Windows，可以在 PowerShell 中使用 npm 安装：

powershell
npm install -g opencode-ai

也可以使用 Chocolatey：

powershell
choco install opencode

或者使用 Scoop：

powershell
scoop install opencode

安装后确认命令可用：

powershell
opencode --version

macOS / Linux ​

Mac 上可以用 Homebrew 安装：

bash
brew install anomalyco/tap/opencode

如果你没有使用 Homebrew，也可以使用官方安装脚本：

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

或者使用 npm 安装：

bash
npm install -g opencode-ai

安装后确认命令可用：

bash
opencode --version

准备 SupaRouter API Key ​

  1. 打开 SupaRouter 官网 并登录。
  2. 在控制台创建 API Key。
  3. 确认 API Key 所在分组可以使用 gpt-5.5。
  4. 复制并保存完整 API Key，后面 /connect 时会用到。

进入你的项目目录 ​

Opencode 推荐在具体项目目录中运行。先进入你要使用 Opencode 的项目。

Windows ​

powershell
cd C:\path\to\your\project

如果你只是想先测试，可以新建一个空目录：

powershell
New-Item -ItemType Directory -Force "$HOME\opencode-suparouter-demo"
Set-Location "$HOME\opencode-suparouter-demo"

macOS / Linux ​

bash
cd /path/to/your/project

如果你只是想先测试，可以新建一个空目录：

bash
mkdir -p ~/opencode-suparouter-demo
cd ~/opencode-suparouter-demo

使用 /connect 保存 SupaRouter 凭据 ​

在项目目录启动 Opencode：

Windows ​

powershell
opencode

macOS / Linux ​

bash
opencode

在 Opencode 中运行：

text
/connect

选择 Other，Provider ID 填：

text
suparouter

然后粘贴你的 SupaRouter API Key。

创建 Opencode 配置文件 ​

Windows ​

退出或另开一个 PowerShell 窗口，确认仍在项目根目录，然后创建 opencode.json：

powershell
New-Item -ItemType File -Force .\opencode.json

用记事本打开：

powershell
notepad .\opencode.json

macOS / Linux ​

退出或另开一个终端窗口，确认仍在项目根目录，然后创建 opencode.json：

bash
touch opencode.json

用你习惯的编辑器打开它，例如：

bash
nano opencode.json

写入以下配置：

json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "suparouter/gpt-5.5",
  "provider": {
    "suparouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SupaRouter",
      "options": {
        "baseURL": "https://api.suparouter.xyz/v1"
      },
      "models": {
        "gpt-5.5": {
          "name": "gpt-5.5"
        }
      }
    }
  }
}

这里的关键配置是：

  • model：使用 suparouter/gpt-5.5。
  • provider.suparouter.name：在 Opencode 界面中显示为 SupaRouter。
  • options.baseURL：指向 SupaRouter 的 OpenAI 兼容接口。
  • models.gpt-5.5：声明本次示例使用的模型。

如果你使用大陆手机网络，可以把 baseURL 改为：

text
https://api-cn.suparouter.xyz/v1

启动并验证 ​

保存 opencode.json 后，在项目目录重新启动 Opencode。

Windows ​

powershell
opencode

macOS / Linux ​

bash
opencode

进入后运行：

text
/models

选择 SupaRouter 下的 gpt-5.5，然后发送一句简短测试消息。能正常返回，并且 SupaRouter 控制台能看到调用记录，说明已经接入成功。

可选：使用环境变量 ​

Windows ​

在 PowerShell 中设置当前会话环境变量：

powershell
$env:SUPAROUTER_API_KEY = "你的 SupaRouter API Key"

如需长期保存环境变量，可以使用：

powershell
setx SUPAROUTER_API_KEY "你的 SupaRouter API Key"

重新打开 PowerShell 后再运行 Opencode。

macOS / Linux ​

在当前终端设置环境变量：

bash
export SUPAROUTER_API_KEY="你的 SupaRouter API Key"

如需长期生效，可以把环境变量写入你的 Shell 配置文件，例如 ~/.zshrc、~/.bashrc 或 ~/.profile。

更新 Opencode 配置 ​

设置环境变量后，在项目根目录创建或编辑 opencode.json：

json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "suparouter/gpt-5.5",
  "provider": {
    "suparouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "SupaRouter",
      "options": {
        "baseURL": "https://api.suparouter.xyz/v1",
        "apiKey": "{env:SUPAROUTER_API_KEY}"
      },
      "models": {
        "gpt-5.5": {
          "name": "gpt-5.5"
        }
      }
    }
  }
}

配置后如何验证 ​

在项目目录运行：

bash
opencode

进入后运行：

text
/models

选择 SupaRouter 下的模型，然后发送一句简短测试消息。如果能正常返回，并且 SupaRouter 控制台能看到调用记录，说明配置已生效。

常见问题 ​

/models 里看不到 SupaRouter ​

优先检查：

  • opencode.json 是否在当前项目根目录。
  • /connect 里的 Provider ID 是否和配置里的 suparouter 一致。
  • JSON 是否能正常解析，逗号和引号是否完整。
  • 如果使用环境变量，当前终端里是否已经设置 SUPAROUTER_API_KEY。

401 或鉴权失败 ​

通常是 API Key 不正确、已失效，或者环境变量没有在当前终端生效。重新复制 SupaRouter API Key 后再试。

model not found ​

通常是 model 或 models 里的模型名不存在，或者该模型不在当前 API Key 的分组可用范围内。请以 SupaRouter 模型价格页或创建 API Key 页面展示的模型名为准。

连接超时 ​

先确认本机能访问：

text
https://api.suparouter.xyz/v1

如果你使用公司网络、代理或防火墙，请先排查网络连通性。

相关页面 ​