在 VS Code 中使用 GenStudio 模型
VS Code 内置的 Copilot Chat 可接入 GenStudio API,您可以选择以下方式:
- 通过 InfiniAI Copilot 扩展:安装专用扩展后,在命令面板中粘贴 API Key 即可完成配置;扩展会自动处理 API 路由、密钥类型识别和不同模型家族的推理内容(Preserved Thinking)回放。
- 通过 VS Code 内置 BYOK 功能:无需安装额外扩展,直接在 VS Code 语言模型管理器中填写端点和 API Key 即可接入;配置简单、即插即用,适合使用通用 LLM API 的用户。
提示
确认 VS Code 为最新版本,并准备好您的 GenStudio API 密钥。
获取 API 接入信息
在配置之前,您需要先获取对应的 API Key。
Infini 编码套餐 (Coding Plan)
适用于订阅了预付费编程套餐的开发者,提供专享配额与预算控制。Coding Plan 使用专用的 Base URL 和 Endpoints,请根据您的客户端工具支持的协议(OpenAI 兼容或 Anthropic)来配置。详见 Infini 编码套餐。
API Key:前往编码套餐页面创建 API 密钥。Infini 编码套餐专用 API 密钥均带有
sk-cp-前缀。警告
- Infini 编码套餐 (Coding Plan) 要求使用 InfiniAI Copilot 扩展 最低版本为 0.1.8。
- Infini 编码套餐 (Coding Plan) 仅支持部分模型。实际支持情况请以平台编码套餐页面显示为准。
OpenAI (OpenAI Compatible)
- Base URL:
https://cloud.infini-ai.com/maas/coding/v1 - Endpoints
- Create Chat Completion:
/chat/completions - List Models:
/models
- Create Chat Completion:
- Base URL:
Anthropic (Anthropic Messages)
- Base URL:
https://cloud.infini-ai.com/maas/coding - Endpoints
- Create a Message:
/v1/messages - List Models:
/v1/models
- Create a Message:
- Base URL:
通过 InfiniAI Copilot 扩展
通过 InfiniAI Copilot 扩展,您可以在 VS Code 的 Copilot Chat 中使用 GenStudio 提供的大语言模型。扩展会自动处理 API 路由和服务模式选择,提供开箱即用的体验。
配置步骤
安装扩展:安装 InfiniAI Copilot 扩展。要求 VS Code 最新版本。
提示
在终端运行
code --version可检查当前版本。如非最新,请前往 VS Code 官网 下载。设置 API Key:按
Cmd+Shift+P/Ctrl+Shift+P打开命令面板,输入Infiniai: Set InfiniAI Apikey,选择服务模式并输入对应的 API Key。
- Standard Plan:按量计费,使用通用 API Key(
sk-开头) - Coding Plan:编码套餐,使用套餐 API Key(
sk-cp-开头)
扩展会自动根据所选模式配置 Base URL,无需手动修改。
- Standard Plan:按量计费,使用通用 API Key(
启用模型:打开 Copilot Chat(
Cmd+Shift+I/Ctrl+Shift+I),点击模型选择器 → Manage Models... → Add Models → InfiniAI,勾选目标模型。
开始对话:在模型选择器中选中 InfiniAI 提供的模型,即可开始对话。
信息
此扩展目前仅支持 Chat 对话功能(Ask/Edit/Agent/Plan)和编辑器内 Inline Chat,不提供编辑器内代码自动补全功能。
使用图片理解
部分模型支持多模态输入(图片理解),例如 kimi-k2.5 支持 Base64 编码的图片输入。不同模型的多模态能力可能存在差异,请以实际使用为准。如果模型支持多模态但默认未启用图片输入,可通过 VS Code 设置强制开启:
打开 VS Code 设置(
Cmd+,/Ctrl+,)。在搜索框中输入以下设置项之一:
- 强制启用图片输入:
infiniai.imageInputModels - 强制禁用图片输入:
infiniai.disableImageInputModels
- 强制启用图片输入:
输入模型名称(支持
*通配符),例如kimi-*为所有 kimi 系列模型启用图片输入,kimi-k2.5仅指定单个模型。
提示
当多模态模型名称不包含 -vision 等标识时,可使用 infiniai.imageInputModels 强制启用图片输入。
通过 VS Code 内置 BYOK 功能
VS Code 的 Copilot Chat 支持自带语言模型密钥(Bring Your Own Key, BYOK),无需安装额外扩展即可接入 GenStudio API。BYOK 模式无需登录 GitHub 账户或订阅 Copilot 计划,配置模型后即可直接使用 Chat、工具和 MCP 服务器。但也存在功能限制:语义搜索、行内代码补全和依赖 Embedding 的功能不可用。关于 BYOK 的完整说明,参见 VS Code 官方文档 — Bring Your Own Language Model Key。
信息
以下功能需要 GitHub 账户和 Copilot 计划,BYOK 模式下不可用:语义搜索、行内代码补全、Next Edit Suggestions、依赖 Embedding 的功能。
前提条件
- VS Code 最新版本
- 已获取 GenStudio API 密钥(参见上方「获取 API 接入信息」)
添加 GenStudio 模型提供方
VS Code 通过「语言模型管理器」添加第三方模型提供方。根据 GenStudio API 的协议类型,选择对应的添加方式:
- OpenAI 兼容协议(Chat Completions API):适用于大多数大语言模型,配置较简单
- Anthropic 协议(Messages API):适用于 Claude 系列模型,需要额外指定 API 类型
两种协议可以在同一个 VS Code 中共存,按需分别添加。
提示
配置完成后,如需更新 API Key、添加模型或重命名分组,可直接在语言模型管理器中操作,无需手动编辑 JSON 文件。
OpenAI 兼容协议
GenStudio 的 OpenAI 兼容端点使用 Chat Completions API。按以下步骤添加:
- 在 Copilot Chat 的模型选择器中点击齿轮图标,或按
Cmd+Shift+P/Ctrl+Shift+P输入Chat: Manage Language Models,打开语言模型管理器。 - 点击 Add Models,选择 Custom Endpoint。
- 输入分组名称,例如
GenStudio。该名称会显示在模型选择器中。 - 输入显示名称和 API Key。
- API 类型选择 Chat Completions。
- VS Code 会打开
chatLanguageModels.json文件,将内容替换为以下配置并保存。保存后如果模型未立即显示,请重启 VS Code。
将 apiKey 替换为您的编码套餐 API Key(以 sk-cp- 开头),url 中的模型 ID 可按需替换:
[
{
"name": "GenStudio Coding Plan",
"vendor": "customendpoint",
"apiKey": "<您的 API Key,以 sk-cp- 开头>",
"apiType": "chat-completions",
"models": [
{
"id": "GLM-5.1",
"name": "GLM-5.1",
"url": "https://cloud.infini-ai.com/maas/coding/v1/chat/completions",
"toolCalling": true,
"vision": false,
"maxInputTokens": 128000,
"maxOutputTokens": 4096
},
{
"id": "DEEPSEEK-V3",
"name": "DEEPSEEK-V3",
"url": "https://cloud.infini-ai.com/maas/coding/v1/chat/completions",
"toolCalling": true,
"vision": false,
"maxInputTokens": 128000,
"maxOutputTokens": 8192
}
]
}
]提示
以上示例仅包含两个模型。您可以根据需要添加更多模型,id 必须与 GenStudio API 支持的模型名称保持一致。前往 模型广场 查看完整模型列表。
Anthropic 协议
如果需要使用 GenStudio 的 Anthropic 兼容端点(Messages API),按以下步骤添加:
- 在 Copilot Chat 的模型选择器中点击齿轮图标,或按
Cmd+Shift+P/Ctrl+Shift+P输入Chat: Manage Language Models,打开语言模型管理器。 - 点击 Add Models,选择 Custom Endpoint。
- 输入分组名称,例如
GenStudio Anthropic。 - 输入显示名称和 API Key。
- API 类型选择 Messages。
- VS Code 会打开
chatLanguageModels.json文件,将内容替换为以下配置并保存。保存后如果模型未立即显示,请重启 VS Code。
将 apiKey 替换为您的编码套餐 API Key(以 sk-cp- 开头):
[
{
"name": "GenStudio Anthropic Coding Plan",
"vendor": "customendpoint",
"apiKey": "<您的 API Key,以 sk-cp- 开头>",
"apiType": "messages",
"models": [
{
"id": "glm-5.1",
"name": "GLM-5.1",
"url": "https://cloud.infini-ai.com/maas/coding/v1/messages",
"toolCalling": true,
"vision": false,
"maxInputTokens": 200000,
"maxOutputTokens": 128000
}
]
}
]提示
Anthropic 协议端点仅对 GenStudio 已支持的 Claude 系列模型有效。如果不需要 Claude 模型,可跳过本节,仅使用 OpenAI 兼容协议即可。
启用模型并开始对话
- 打开 Copilot Chat 侧边栏(点击左侧活动栏的 Copilot 图标,或按
Cmd+Shift+I/Ctrl+Shift+I)。 - 点击聊天输入框上方的模型选择器,在列表中找到刚添加的 GenStudio 模型。
- 如果模型未显示,点击齿轮图标打开语言模型管理器,确认模型左侧的眼睛图标为可见状态。
- 选中模型后,即可在 Chat 中开始对话。
信息
BYOK 模式下,Copilot Chat 支持 Ask/Edit/Agent/Plan 和编辑器内 Inline Chat,但不支持行内代码补全。
配置后台任务模型
VS Code 的后台任务(标题生成、提交信息生成、意图检测等)默认使用 GitHub Copilot 内置模型。BYOK 模式下未登录 GitHub 时,这些任务需要手动指定模型。VS Code 会在聊天输入框中显示提示,引导您配置。
通过以下设置将后台任务切换到 GenStudio 模型:
chat.utilityModel:覆盖标题生成、摘要、设置搜索等通用后台任务使用的模型。chat.utilitySmallModel:覆盖提交信息、重命名建议、分支名生成等轻量任务使用的模型。建议选择响应速度快的模型。
在 VS Code 设置(Cmd+, / Ctrl+,)中搜索上述设置项,选择已添加的 GenStudio 模型即可。
查看可用模型
可用模型取决于您使用的 API 服务:
Infini 编码套餐 (Coding Plan):仅开放部分模型,实际可用模型以平台编码套餐页面显示为准。
在 chatLanguageModels.json 中添加模型时,id 字段必须与 GenStudio API 支持的模型名称完全一致。前往模型广场查看完整列表:
故障排除
如果在使用过程中遇到问题,请参考以下常见问题及解决方案。
扩展相关问题
API Base URL 配置不正确
全新安装情况下,无需手动配置 API Base URL。
从旧版扩展升级,或曾经手动修改 API Base URL 配置时,如果遇到问题,请参考上文「获取 API 接入信息」,修改扩展配置中的 Base URL 值。
无法配置编码套餐
Infini 编码套餐 (Coding Plan) 要求使用 InfiniAI Copilot 扩展 最低版本为 0.1.8。
部分情况下,可能需要卸载旧版扩展插件并完全清除扩展配置缓存,然后重新安装。
API 密钥错误,看到「无效的 API 密钥」或「未授权」消息
- 检查输入的 GenStudio API 密钥是否正确
验证 API 密钥格式:编码套餐以 sk-cp- 开头
编码套餐对应 /maas/coding/v1
模型列表为空或无法加载
- 确认网络连接正常
- 检查是否已正确配置 API 密钥
- 尝试重新安装 InfiniAI Copilot 扩展
BYOK 相关问题
添加的模型未出现在选择器中
- 保存
chatLanguageModels.json后重启 VS Code - 确认 JSON 格式正确:打开命令面板运行
Chat: Manage Language Models,如果配置有语法错误,VS Code 会在输出面板中提示 - 确认模型的
vendor值为"customendpoint"
API 密钥错误或连接失败
- 检查 API Key 前缀是否与配置匹配
编码套餐 API Key 以 sk-cp- 开头
url编码套餐使用 https://cloud.infini-ai.com/maas/coding/v1
apiType``"chat-completions"``"messages"#### Coding Plan 模型返回 404 或无法调用
Coding Plan 要求模型 id 使用全大写形式。例如应使用 GLM-5.1 而非 glm-5.1,DEEPSEEK-V3 而非 deepseek-v3。
通用问题
代码补全不生效或响应缓慢
- 检查网络连接状态
- 切换到响应速度更快的模型(如 glm-4.5-air)
- 确认 API 频率限制未超额
VS Code 版本过低
- 更新 VS Code 到最新版本
- 访问 VS Code 官网 下载最新版本
相关文档
更多关于 GenStudio API 的使用说明,请参考以下文档。