配置 OpenCode 的 Router One provider 与模型 ID

把 OpenCode 配置到 Router One base URL

在 opencode.json（项目级；全局配置在 ~/.config/opencode/opencode.json）的 provider 下新增一条：npm 填 @ai-sdk/openai-compatible，options.baseURL 指向网关，想进选择器的目录模型在 models 里逐个列出。Key 用 {env:变量名} 语法从环境变量读取，不用明文写进文件。选模型用 provider-id/model-id 的格式——这里就是 router-one/<模型 ID>，在 TUI 的 /models 命令里选，或固定写进顶层的 model 字段：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "router-one": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Router One",
      "options": {
        "baseURL": "https://api.router.one/v1",
        "apiKey": "{env:ROUTER_ONE_API_KEY}"
      },
      "models": {
        "<model-id-from-/models>": {
          "name": "<label shown in the picker>"
        }
      }
    }
  },
  "model": "router-one/<model-id-from-/models>"
}

OpenCode 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 OpenCode 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个工具单独建 API Key，并设置 maxSpend 消费上限。

OpenCode 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在 trace 里验证 OpenCode 的调用

先在 OpenCode 发出一次简单文本请求，再到 Dashboard → Logs 按时间、模型和 request_id 核对 trace：tokens、花费、延迟和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

常见问题