文档中心

Appearance

✨费用中心控制台

在 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。

GenStudio 通用 LLM API ​

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

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

    获取通用 API Key

    信息

    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

通过 InfiniAI Copilot 扩展 ​

通过 InfiniAI Copilot 扩展，您可以在 VS Code 的 Copilot Chat 中使用 GenStudio 提供的大语言模型。扩展会自动处理 API 路由和服务模式选择，提供开箱即用的体验。

配置步骤 ​

  1. 安装扩展：安装 InfiniAI Copilot 扩展。要求 VS Code 最新版本。

    提示

    在终端运行 code --version 可检查当前版本。如非最新，请前往 VS Code 官网 下载。

  2. 设置 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，无需手动修改。

  3. 启用模型：打开 Copilot Chat（Cmd+Shift+I / Ctrl+Shift+I），点击模型选择器 → Manage Models... → Add Models → InfiniAI，勾选目标模型。 选择模型

  4. 开始对话：在模型选择器中选中 InfiniAI 提供的模型，即可开始对话。

信息

此扩展目前仅支持 Chat 对话功能（Ask/Edit/Agent/Plan）和编辑器内 Inline Chat，不提供编辑器内代码自动补全功能。

使用图片理解 ​

部分模型支持多模态输入（图片理解），例如 kimi-k2.5 支持 Base64 编码的图片输入。不同模型的多模态能力可能存在差异，请以实际使用为准。如果模型支持多模态但默认未启用图片输入，可通过 VS Code 设置强制开启：

  1. 打开 VS Code 设置（Cmd+, / Ctrl+,）。

  2. 在搜索框中输入以下设置项之一：

    • 强制启用图片输入：infiniai.imageInputModels
    • 强制禁用图片输入：infiniai.disableImageInputModels

  3. 输入模型名称（支持 * 通配符），例如 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。按以下步骤添加：

  1. 在 Copilot Chat 的模型选择器中点击齿轮图标，或按 Cmd+Shift+P / Ctrl+Shift+P 输入 Chat: Manage Language Models，打开语言模型管理器。
  2. 点击 Add Models，选择 Custom Endpoint。
  3. 输入分组名称，例如 GenStudio。该名称会显示在模型选择器中。
  4. 输入显示名称和 API Key。
  5. API 类型选择 Chat Completions。
  6. VS Code 会打开 chatLanguageModels.json 文件，将内容替换为以下配置并保存。保存后如果模型未立即显示，请重启 VS Code。

将 apiKey 替换为您的通用 API Key（以 sk- 开头），url 中的模型 ID 可按需替换：

language-json
[
  {
    "name": "GenStudio",
    "vendor": "customendpoint",
    "apiKey": "<您的 API Key，以 sk- 开头>",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "glm-5.1",
        "name": "GLM-5.1",
        "url": "https://cloud.infini-ai.com/maas/v1/chat/completions",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 128000,
        "maxOutputTokens": 4096
      },
      {
        "id": "deepseek-v3",
        "name": "DeepSeek-V3",
        "url": "https://cloud.infini-ai.com/maas/v1/chat/completions",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 128000,
        "maxOutputTokens": 8192
      }
    ]
  }
]

提示

以上示例仅包含两个模型。您可以根据需要添加更多模型，id 必须与 GenStudio API 支持的模型名称保持一致。前往 模型广场 查看完整模型列表。

Anthropic 协议 ​

如果需要使用 GenStudio 的 Anthropic 兼容端点（Messages API），按以下步骤添加：

  1. 在 Copilot Chat 的模型选择器中点击齿轮图标，或按 Cmd+Shift+P / Ctrl+Shift+P 输入 Chat: Manage Language Models，打开语言模型管理器。
  2. 点击 Add Models，选择 Custom Endpoint。
  3. 输入分组名称，例如 GenStudio Anthropic。
  4. 输入显示名称和 API Key。
  5. API 类型选择 Messages。
  6. VS Code 会打开 chatLanguageModels.json 文件，将内容替换为以下配置并保存。保存后如果模型未立即显示，请重启 VS Code。

将 apiKey 替换为您的通用 API Key（以 sk- 开头）：

language-json
[
  {
    "name": "GenStudio Anthropic",
    "vendor": "customendpoint",
    "apiKey": "<您的 API Key，以 sk- 开头>",
    "apiType": "messages",
    "models": [
      {
        "id": "claude-opus-4-6",
        "name": "Claude Opus 4.6",
        "url": "https://cloud.infini-ai.com/maas/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 128000
      }
    ]
  }
]

提示

Anthropic 协议端点仅对 GenStudio 已支持的 Claude 系列模型有效。如果不需要 Claude 模型，可跳过本节，仅使用 OpenAI 兼容协议即可。

启用模型并开始对话 ​

  1. 打开 Copilot Chat 侧边栏（点击左侧活动栏的 Copilot 图标，或按 Cmd+Shift+I / Ctrl+Shift+I）。
  2. 点击聊天输入框上方的模型选择器，在列表中找到刚添加的 GenStudio 模型。
  3. 如果模型未显示，点击齿轮图标打开语言模型管理器，确认模型左侧的眼睛图标为可见状态。
  4. 选中模型后，即可在 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 服务：

GenStudio 通用 LLM API：可使用模型广场中列出的全部大语言模型。

在 chatLanguageModels.json 中添加模型时，id 字段必须与 GenStudio API 支持的模型名称完全一致。前往模型广场查看完整列表：

模型广场

故障排除 ​

如果在使用过程中遇到问题，请参考以下常见问题及解决方案。

扩展相关问题 ​

API Base URL 配置不正确 ​

全新安装情况下，无需手动配置 API Base URL。

从旧版扩展升级，或曾经手动修改 API Base URL 配置时，如果遇到问题，请参考上文「获取 API 接入信息」，修改扩展配置中的 Base URL 值。

API 密钥错误，看到「无效的 API 密钥」或「未授权」消息 ​

  • 检查输入的 GenStudio API 密钥是否正确

验证 API 密钥格式：通用 API 以 sk- 开头

通用 API 对应 /maas/v1

模型列表为空或无法加载 ​

  • 确认网络连接正常
  • 检查是否已正确配置 API 密钥
  • 尝试重新安装 InfiniAI Copilot 扩展

BYOK 相关问题 ​

添加的模型未出现在选择器中 ​

  • 保存 chatLanguageModels.json 后重启 VS Code
  • 确认 JSON 格式正确：打开命令面板运行 Chat: Manage Language Models，如果配置有语法错误，VS Code 会在输出面板中提示
  • 确认模型的 vendor 值为 "customendpoint"

API 密钥错误或连接失败 ​

  • 检查 API Key 前缀是否与配置匹配

通用 API Key 以 sk- 开头

url通用 API 使用 https://cloud.infini-ai.com/maas/v1

apiType``"chat-completions"``"messages"### 通用问题

代码补全不生效或响应缓慢 ​

  • 检查网络连接状态
  • 切换到响应速度更快的模型（如 glm-4.5-air）
  • 确认 API 频率限制未超额

VS Code 版本过低 ​

  • 更新 VS Code 到最新版本
  • 访问 VS Code 官网 下载最新版本

相关文档 ​

更多关于 GenStudio API 的使用说明，请参考以下文档。