OpenCode 接入

OpenCode 官方支持自定义 OpenAI Compatible Provider。配置分两步：先保存凭据，再在 opencode.json 声明地址和模型。

Provider IDniuapi

SDK@ai-sdk/openai-compatible

Base URLhttps://api.reniuniu.win/v1

接入方式配置后测试

第一步：保存 API Key

在 OpenCode 中运行：

/connect

滚动到 Other，Provider ID 填 niuapi，再粘贴牛API专用 Key。Provider ID 必须与下一步 JSON 中的键完全一致。

第二步：创建 Provider

在项目的 opencode.json 中加入：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "niuapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "牛API",
      "options": {
        "baseURL": "https://api.reniuniu.win/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "牛API模型"
        }
      }
    }
  }
}

把 YOUR_MODEL_ID 替换为控制台真实模型 ID。凭据已由 /connect 保存，不要再把明文 Key 写入 JSON。

OpenCode脱敏配置示意图

设置Custom Provider模型连接测试

Custom Provider连接参数

服务商类型@ai-sdk/openai-compatible协议Chat Completions + ToolsBase URLhttps://api.reniuniu.win/v1API Keyniu_••••••••••••_AB12模型 IDYOUR_MODEL_ID

示意图使用虚构 Key 和模型 ID，不对应特定版本界面；以客户端当前版本为准。

Responses 模型

OpenCode 官方说明：/v1/chat/completions 使用 @ai-sdk/openai-compatible；只有明确使用 /v1/responses 的模型才改用 @ai-sdk/openai。首次接入先使用上面的 Chat Completions 配置并发送最小消息。

第三步：选择模型

重启 OpenCode，运行：

/models

选择 牛API → 牛API模型。如果没有出现，依次检查 Provider ID、JSON 层级和模型 ID。

第四步：最小测试

先在无敏感信息的空目录执行只读问答。基础响应通过后，再分别测试文件读取、单次编辑和工具调用。

常见问题

现象	处理
Provider 不显示	确认 /connect 与 JSON 都使用 niuapi
模型不显示	检查 models 对象中的真实模型 ID
401	重新运行 /connect，再用 opencode auth list 检查凭据
404	检查 baseURL 是否为带 /v1 的地址
工具循环	取消任务，关闭自动批准并核对用量