连接 AI 助手

Codex

本机 Codex · 需要 Codex CLI

安装后验证

开启新会话,运行 /mcp 检查文档连接。

请助手搜索并读取一篇本站文档,确认回答附带原文链接。

详细步骤与其他插件安装方式
备选:手动连接 MCP

没有插件入口时使用。已安装插件时,无需重复添加 MCP。

Skip to content

使用 OpenCode 集成 GenStudio API ​

AI 助手

注意

适用版本

Chat Completions 和 Anthropic Messages 的示例使用 OpenCode V1 配置格式。Responses 示例适用于 OpenCode V2 2.2.7。

OpenCode 是一款在终端中运行的 CLI + TUI AI 编程代理工具,同时也提供 IDE 插件集成。它支持通过配置自定义 Provider 来连接第三方 API 服务。本教程将指导用户如何在 OpenCode 中集成 GenStudio 的 API 服务。

获取 API 接入信息 ​

在配置之前,您需要先获取对应的 API Key。

GenStudio 通用 LLM API ​

适用于按量付费、包并发服务等场景,可用于大语言模型、生图模型、视频模型等。LLM API 按 Token 计费,请关注账户余额。GenStudio 通用 LLM API 使用平台通用的的 Base URL 和 Endpoints,请根据您的客户端工具支持的协议(OpenAI 兼容或 Anthropic)来配置。

  • API Key: 创建以 sk- 前缀的 API 密钥。详见 GenStudio API 快速集成。

    注意

    GenStudio 通用 LLM API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费,以及享受的 API 频率上限。详见 LLM API 计费规则。

  • OpenAI (OpenAI Compatible)

    • Base URL: https://cloud.infini-ai.com/maas/v1

    • Endpoints

      • Create Chat Completion: /chat/completions
      • List Models: /models
  • Anthropic (Anthropic Messages)

    • Base URL: https://cloud.infini-ai.com/maas

    • Endpoints

      • Create a Message: /v1/messages
      • List Models: /v1/models

通过 API 获取最新可用模型列表 ​

若需获取当前接入方式下最新可用的模型 ID,建议通过 Agent 或手动调用模型列表接口。

使用通用 API Key(sk- 前缀)查询当前可用的模型。模型条目中的 context_length 和 max_output_length 分别表示上下文窗口和最大输出 Token 数。

language-shell
curl --request GET \
  --url 'https://cloud.infini-ai.com/maas/v1/models' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

在控制台查看上下文长度和最大输出长度 ​

如需查看模型的上下文长度和最大输出长度,请前往模型广场查看对应模型卡片。模型卡片会展示每个模型的上下文长度、最大输出长度等信息。

部分模型提供 Anthropic Messages 兼容接口。最新支持情况可前往 GenStudio 模型广场查看「Claude 兼容」筛选结果。

在 OpenCode V1 中配置 Chat Completions 和 Anthropic Messages ​

OpenCode 允许用户通过配置文件添加自定义模型提供商。以下是配置步骤:

安装 OpenCode V1 ​

如果您尚未安装 OpenCode,可以使用官方安装脚本或 npm 进行安装:

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

或者:

language-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、Kimi 等 OpenAI 兼容模型。使用 @ai-sdk/openai-compatible 适配器。
  • Provider 2 (genstudio-anthropic): 适用于 MiniMax、GLM 等 Anthropic 兼容模型。使用 @ai-sdk/anthropic 适配器。

将以下内容添加到您的 opencode.json 配置文件中:

language-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-v4-flash": {
                    "name": "DeepSeek V4 Flash"
                }
            }
        },
        "genstudio-anthropic": {
            "npm": "@ai-sdk/anthropic",
            "name": "GenStudio (Anthropic Compatible)",
            "options": {
                "baseURL": "https://cloud.infini-ai.com/maas",
                "apiKey": "{env:GENSTUDIO_API_KEY}"
            },
            "models": {
                "minimax-m2.7": { "name": "MiniMax M2.7" },
                "glm-5.1": { "name": "GLM-5.1" }
            }
        }
    }
}

注意

关于 API Key 上述配置使用了 {env:GENSTUDIO_API_KEY} 引用环境变量,这是一种更安全的做法。

您需要在 shell 中设置该环境变量:

language-bash
export GENSTUDIO_API_KEY="sk-..."

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

选择模型并启动 ​

配置完成后,启动 OpenCode:

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

在 OpenCode 界面中:

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

在 OpenCode V2 中配置 Responses ​

以下以 deepseek-v4.1-flash-1017 为例配置智算云 GenStudio 通用 LLM API 的 Responses 接口。开始前,先通过 /models 确认当前账号可用此模型。

安装 OpenCode V2 后,运行 opencode --version 确认当前版本。若已通过包管理器安装 V1,请按官方迁移指南处理旧版。其他安装方式见 OpenCode 官方安装指南。

language-bash
curl -fsSL https://opencode.ai/v2/install | bash
opencode --version

将下面的 genstudio-responses 条目合并到全局 opencode.json 的 providers 中。V2 也可以读取前文使用 provider 定义的 V1 配置。settings.baseURL 填写到 /v1,OpenCode 会自动追加 /responses。

language-json
{
  "providers": {
    "genstudio-responses": {
      "name": "GenStudio Responses",
      "package": "@opencode/ai/providers/openai-compatible/responses",
      "env": ["GENSTUDIO_API_KEY"],
      "settings": {
        "baseURL": "https://cloud.infini-ai.com/maas/v1"
      },
      "body": {
        "store": false
      },
      "models": {
        "deepseek-v4.1-flash-1017": {
          "name": "GenStudio DeepSeek V4.1 Flash",
          "limit": { "context": 1048576 },
          "capabilities": { "tools": true }
        }
      }
    }
  }
}

注意

使用 GPT 系列模型

通过 /models 查询当前账号可用的模型 ID 和 context_length,并确认目标模型可通过 Responses 调用。将 models 下的键名及命令中 genstudio-responses/ 后的模型 ID 替换为目标 ID,并更新 name 和 limit.context。如需指定推理强度,在该模型条目的 settings.reasoningEffort 中填写它在 Responses 接口支持的档位。

在 macOS 或 Linux 上,将 GENSTUDIO_API_KEY 设为 GenStudio 通用 API Key,再运行以下命令。JSON 输出中应有完成的 read 工具调用,模型返回的文本应与 cat 显示的内容一致。

language-bash
export GENSTUDIO_API_KEY="sk-xxxxxxxxxx"
cd "$(mktemp -d)"
printf 'GENSTUDIO-RESPONSES-%s\n' "$(date +%s)" > responses-check.txt
cat responses-check.txt
opencode run --standalone --format json --model genstudio-responses/deepseek-v4.1-flash-1017 \
  '用读取工具读取 responses-check.txt,仅回复文件中的一行内容。'

命令退出后,从 JSON 输出中复制 sessionID。在同一目录删除测试文件,将下面的 SESSION_ID 替换为刚才的值,再执行恢复命令。模型应从会话历史中返回相同内容。

language-bash
rm responses-check.txt
opencode run --standalone --session 'SESSION_ID' --model genstudio-responses/deepseek-v4.1-flash-1017 \
  '根据会话历史,仅回复上一轮从文件读取的那一行内容。请勿调用工具。'

在 OpenCode V1 中使用图片理解 ​

默认情况下,OpenCode 会假设您连接的任何模型都仅支持纯文本。它不会自动检测模型的视觉能力;如果需要使用模型的图像理解能力,您需要在 OpenCode 配置文件中显式声明模型具备该能力。

当您在 opencode.json(或 opencode.jsonc)文件中为模型定义添加 modalities(模态)参数时,它就会知道该模型具备视觉理解能力。

如何配置视觉能力 ​

要为具备视觉能力的模型启用图像处理,请先在 GenStudio 模型广场确认目标模型支持当前 API 协议下的图片输入,再修改或添加 modalities 字段,确保 input 数组中定义 "image"。

OpenCode 配置文件示例:

language-json
{
  "models": {
    "YOUR_VISION_MODEL_ID": {
      "name": "YOUR_VISION_MODEL_NAME",
      "modalities": {
        "input": ["text", "image"],
        "output": ["text"]
      }
    }
  },
  "name": "GenStudio (OpenAI Compatible)",
  "npm": "@ai-sdk/openai-compatible",
  "options": {
    "apiKey": "sk-xxxxxx",
    "baseURL": "https://xxxxx"
  }
}

请将示例中的 YOUR_VISION_MODEL_ID 和 YOUR_VISION_MODEL_NAME 替换为模型广场中当前可用且明确支持图片输入的模型信息。

注意

如果不配置会怎样?

如果您在未配置 modalities 字段的情况下尝试将图像传递给模型,OpenCode 将拦截该请求并返回错误,提示该模型无法读取或查看图像。

相关文档 ​