使用 OpenCode 集成 GenStudio API
OpenCode 是一款在终端中运行的 CLI + TUI AI 编程代理工具,同时也提供 IDE 插件集成。它支持通过配置自定义 Provider 来连接第三方 API 服务。本教程将指导用户如何在 OpenCode 中集成 GenStudio 的 API 服务。
获取 GenStudio API Key
您可以复制已有 API Key 或创建新的 Key。
预置模型 API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费,以及享受的 API 频率上限。详见 LLM API 计费规则
在 OpenCode 中集成 GenStudio API 服务
OpenCode 允许用户通过配置文件添加自定义模型提供商。以下是配置步骤:
安装 OpenCode
如果您尚未安装 OpenCode,可以使用官方安装脚本或 npm 进行安装:
# 使用 curl 安装
curl -fsSL https://opencode.ai/install | bash或者:
# 使用 npm 安装
npm install -g opencode-ai配置 Provider
推荐修改全局配置文件,这样在任何目录下都能使用 GenStudio 模型。配置文件位置:
- Linux/macOS:
~/.config/opencode/opencode.json - Windows:
%USERPROFILE%\.config\opencode\opencode.json
如果文件不存在,请手动创建该文件。
OpenCode 基于 Vercel AI SDK 构建。GenStudio 的不同模型需要使用不同的适配器(Adapter),因此我们需要配置两个 Provider:
- Provider 1 (
genstudio-openai): 适用于 DeepSeek (v3, R1)、Kimi 等 OpenAI 兼容模型。使用@ai-sdk/openai-compatible适配器。 - Provider 2 (
genstudio-anthropic): 适用于 MiniMax、GLM 等 Anthropic 兼容模型。使用@ai-sdk/anthropic适配器。
将以下内容添加到您的 opencode.json 配置文件中:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"genstudio-openai": {
"npm": "@ai-sdk/openai-compatible",
"name": "GenStudio (OpenAI Compatible)",
"options": {
"baseURL": "https://cloud.infini-ai.com/maas/v1",
"apiKey": "{env:GENSTUDIO_API_KEY}"
},
"models": {
"deepseek-v3": { "name": "DeepSeek V3" },
"deepseek-r1": { "name": "DeepSeek R1" },
"kimi-k2.5": { "name": "Kimi K2.5" },
"kimi-k2-thinking": { "name": "Kimi K2 Thinking" }
}
},
"genstudio-anthropic": {
"npm": "@ai-sdk/anthropic",
"name": "GenStudio (Anthropic Compatible)",
"options": {
"baseURL": "https://cloud.infini-ai.com/maas/v1",
"apiKey": "{env:GENSTUDIO_API_KEY}"
},
"models": {
"minimax-m2.1": { "name": "MiniMax M2.1" },
"glm-4.7": { "name": "GLM-4.7" },
"glm-4.5-air": { "name": "GLM-4.5 Air" }
}
}
}
}注意
上述配置使用了 {env:GENSTUDIO_API_KEY} 引用环境变量,这是一种更安全的做法。
您需要在 shell 中设置该环境变量:
export GENSTUDIO_API_KEY="sk-..."或者,为了方便(但不推荐用于共享环境),您也可以直接将 apiKey 字段的值替换为您的实际 Key 字符串。
Anthropic 协议模型支持范围
GenStudio 仅为部分模型提供 Anthropic Messages 兼容接口。最新支持情况,请前往 GenStudio 模型广场,使用「Claude 兼容」筛选条件查看支持的模型列表。
选择模型并启动
配置完成后,启动 OpenCode:
# 设置环境变量并启动
export GENSTUDIO_API_KEY="sk-..."
opencode在 OpenCode 界面中:
- 输入
/models命令。 - 您将看到
GenStudio (OpenAI Compatible)和GenStudio (Anthropic Compatible)下的模型列表。 - 选择您需要的模型即可开始使用。