使用 OpenCode 集成 GenStudio API
注意
适用版本
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/v1Endpoints
- Create Chat Completion:
/chat/completions - List Models:
/models
- Create Chat Completion:
Anthropic (Anthropic Messages)
Base URL:
https://cloud.infini-ai.com/maasEndpoints
- Create a Message:
/v1/messages - List Models:
/v1/models
- Create a Message:
通过 API 获取最新可用模型列表
若需获取当前接入方式下最新可用的模型 ID,建议通过 Agent 或手动调用模型列表接口。
使用通用 API Key(sk- 前缀)查询当前可用的模型。模型条目中的 context_length 和 max_output_length 分别表示上下文窗口和最大输出 Token 数。
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 进行安装:
# 使用 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、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-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 中设置该环境变量:
export GENSTUDIO_API_KEY="sk-..."或者,为了方便(但不推荐用于共享环境),您也可以直接将 apiKey 字段的值替换为您的实际 Key 字符串。
选择模型并启动
配置完成后,启动 OpenCode:
# 设置环境变量并启动
export GENSTUDIO_API_KEY="sk-..."
opencode在 OpenCode 界面中:
- 输入
/models命令。 - 您将看到
GenStudio (OpenAI Compatible)和GenStudio (Anthropic Compatible)下的模型列表。 - 选择您需要的模型即可开始使用。
在 OpenCode V2 中配置 Responses
以下以 deepseek-v4.1-flash-1017 为例配置智算云 GenStudio 通用 LLM API 的 Responses 接口。开始前,先通过 /models 确认当前账号可用此模型。
安装 OpenCode V2 后,运行 opencode --version 确认当前版本。若已通过包管理器安装 V1,请按官方迁移指南处理旧版。其他安装方式见 OpenCode 官方安装指南。
curl -fsSL https://opencode.ai/v2/install | bash
opencode --version将下面的 genstudio-responses 条目合并到全局 opencode.json 的 providers 中。V2 也可以读取前文使用 provider 定义的 V1 配置。settings.baseURL 填写到 /v1,OpenCode 会自动追加 /responses。
{
"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 显示的内容一致。
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 替换为刚才的值,再执行恢复命令。模型应从会话历史中返回相同内容。
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 配置文件示例:
{
"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 将拦截该请求并返回错误,提示该模型无法读取或查看图像。