外观
OpenCode 接入自定义 API
在 OpenCode 的配置文件 opencode.jsonc 里添加一个自定义供应商,协议选 OpenAI 兼容,baseURL 填 https://api.niceai.dev/v1,密钥通过环境变量 NICEAI_API_KEY 提供,然后用 /models 选择模型即可。
准备工作
- 安装 OpenCode(参考其官方文档)。
- 在 NiceAI 控制台「API 密钥」页面创建密钥,分组按要用的模型选择。
配置步骤
设置密钥环境变量:
bashexport NICEAI_API_KEY="sk-你的密钥"powershell[Environment]::SetEnvironmentVariable("NICEAI_API_KEY", "sk-你的密钥", "User")编辑 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": "<显示名称>" } } } } }重新启动 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 类工具,依赖模型的工具调用能力,换用支持工具调用的模型。