Skip to content

OpenCode 接入自定义 API ​

在 OpenCode 的配置文件 opencode.jsonc 里添加一个自定义供应商,协议选 OpenAI 兼容,baseURL 填 https://api.niceai.dev/v1,密钥通过环境变量 NICEAI_API_KEY 提供,然后用 /models 选择模型即可。

准备工作 ​

  1. 安装 OpenCode(参考其官方文档)。
  2. 在 NiceAI 控制台「API 密钥」页面创建密钥,分组按要用的模型选择。

配置步骤 ​

  1. 设置密钥环境变量:

    bash
    export NICEAI_API_KEY="sk-你的密钥"
    powershell
    [Environment]::SetEnvironmentVariable("NICEAI_API_KEY", "sk-你的密钥", "User")
  2. 编辑 OpenCode 配置文件 opencode.jsonc(全局配置或项目根目录均可),加入:

    jsonc
    {
      "$schema": "https://opencode.ai/config.json",
      "providers": {
        "niceai": {
          "name": "NiceAI",
          "env": ["NICEAI_API_KEY"],
          "package": "@opencode/ai/providers/openai-compatible",
          "settings": {
            "baseURL": "https://api.niceai.dev/v1"
          },
          "models": {
            "<模型名,见模型广场>": { "name": "<显示名称>" }
          }
        }
      }
    }
  3. 重新启动 OpenCode,输入 /models,选择 niceai/<模型名>。

不同版本的配置写法不同

上面的写法来自 OpenCode 当前的官方文档。较早的版本使用 provider、npm: "@ai-sdk/openai-compatible" 和 options.baseURL 等字段。如果配置不生效,请对照你所用版本的官方文档调整字段名,baseURL 的值保持 https://api.niceai.dev/v1 不变。

验证 ​

选好模型后随便问一句,能正常回复即接入成功;控制台使用记录里也能看到这次请求。

常见问题 ​

/models 里看不到 niceai? ​

检查 NICEAI_API_KEY 是否在启动 OpenCode 的终端里生效,以及 JSON 是否有语法错误(多余或缺少逗号)。

返回 404? ​

baseURL 要以 /v1 结尾。见 接口地址要不要加 /v1。

工具调用报错? ​

OpenCode 是 Agent 类工具,依赖模型的工具调用能力,换用支持工具调用的模型。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站