在 AIStudio 镜像中心使用 Dockerfile 自助构建最新版 vLLM 镜像在 AIStudio 镜像中心使用 Dockerfile 自助构建最新版 vLLM 镜像 ,无需访问 DockerHub立即构建
Skip to content
回到全部文章

使用 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 进行安装:

bash
# 使用 curl 安装
curl -fsSL https://opencode.ai/install | bash

或者:

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 配置文件中:

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 中设置该环境变量:

bash
export GENSTUDIO_API_KEY="sk-..."

或者,为了方便(但不推荐用于共享环境),您也可以直接将 apiKey 字段的值替换为您的实际 Key 字符串。

Anthropic 协议模型支持范围

GenStudio 仅为部分模型提供 Anthropic Messages 兼容接口。最新支持情况,请前往 GenStudio 模型广场,使用「Claude 兼容」筛选条件查看支持的模型列表。

选择模型并启动

配置完成后,启动 OpenCode:

bash
# 设置环境变量并启动
export GENSTUDIO_API_KEY="sk-..."
opencode

在 OpenCode 界面中:

  1. 输入 /models 命令。
  2. 您将看到 GenStudio (OpenAI Compatible)GenStudio (Anthropic Compatible) 下的模型列表。
  3. 选择您需要的模型即可开始使用。

相关资源

找不到想要的答案?
让 AI 助手为您解答