接入 OpenCode
功能概述
OpenCode 是基于终端的 AI 编程助手,支持通过配置文件指定自定义 OpenAI 兼容 API 端点。无量AI开放平台提供完全兼容 OpenAI 协议的接口,可作为 OpenCode 的后端服务。
前提条件
- 已安装 OpenCode(
npm install -g opencode-ai或参考官方文档) - 已在无量AI开放平台创建 API Key(前往创建)
配置步骤
1. 编辑 opencode.json
根据您的操作系统,找到并编辑以下配置文件(如文件不存在则新建):
| 操作系统 | 文件路径 |
|---|---|
| macOS / Linux | ~/.config/opencode/opencode.json |
| Windows | %APPDATA%\opencode\opencode.json |
写入以下内容,将 your-api-key 替换为您在无量AI开放平台获取的 API Key:
json
{
"models": {
"gpt-5.5": {
"name": "GPT-5.5"
}
},
"npm": "@ai-sdk/openai-compatible",
"options": {
"apiKey": "your-api-key",
"baseURL": "https://open.dieyuyun.com/v1"
}
}| 配置项 | 说明 |
|---|---|
models | 可用模型定义,键为模型代码 |
npm | 固定值 @ai-sdk/openai-compatible |
options.apiKey | 您的无量AI开放平台 API Key |
options.baseURL | 无量AI开放平台 OpenAI 兼容接口地址 |
2. 启动 OpenCode
保存配置文件后,在终端中运行:
bash
opencode在会话中输入 /models 可查看并切换可用模型。


平台接口说明
无量AI开放平台的 OpenAI 协议接入信息如下:
| 配置项 | 值 |
|---|---|
| Base URL | https://open.dieyuyun.com/v1 |
| 认证请求头 | Authorization: Bearer your-api-key |
| 数据格式 | JSON |
完整请求示例:
bash
curl --request POST 'https://open.dieyuyun.com/v1/chat/completions' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.5",
"messages": [
{"role": "system", "content": "你是一个有用的助手"},
{"role": "user", "content": "你好,请介绍一下你自己"}
],
"temperature": 0.7,
"max_tokens": 1024
}'注意事项
- JSON 格式:请确保配置文件为合法的 JSON 格式。
- 模型 ID:
models[].id必须与平台提供的模型代码完全一致,可在 模型列表与定价 页面查看。 - API Key 安全:不要将
opencode.json文件中的 API Key 提交到版本控制系统,建议通过环境变量OPENAI_API_KEY传入。
相关文档
- 管理 API Key - 创建和配置 API Key
- 模型列表与定价 - 浏览可用模型和定价信息
- API 参考 - 查看完整的 API 接口文档