知识库章节 ▾

导航

▸ 从这里开始 按角色

类别

工具 52
词汇表 12

工具

GitHub Copilot BYOK — 使用自己的模型替代配额限制

BYOK (bring your own key) 是 GitHub Copilot 的官方机制，允许你连接自己的模型服务商，并在 Agent 会话中使用该模型，而不是使用内置的 GPT 和 Claude。自 2026 年 1 月起，支持任何 OpenAI 兼容的端点；自 6 月 23 日起，BYOK 已在所有付费计划的 Copilot 应用中公测，7 月 14 日起支持 JetBrains 版本。这意味着你可以将 Copilot 仅用作外壳，而通过 JoinGonka Gateway 进行推理——按去中心化网络 Gonka 的价格计费，且不会消耗订阅额度中的高级请求。在 VS Code 中使用 BYOK 无需 Copilot 计划，也无需登录 GitHub 账户。

BYOK 的优势及适用场景

Copilot 订阅对 premium 请求有限制：代理会话、重构和多步骤任务消耗配额最快。BYOK 将这些调用转移到您的提供商：消耗按其价格计费，且不扣除 Copilot premium 配额。密钥存储在系统 keychain 中，接口无法读取。

如果您达到配额限制、想要使用开源模型或希望显著降低推理成本，BYOK 是明智的选择：Gonka 网络提供的开源模型价格比供应商的零售价便宜数百倍 — 实时费率始终可在 网关价格列表 中查看。

时间线：功能上线记录

时间更新内容
2025 年 11 月BYOK 公测：支持 Anthropic, OpenAI, xAI, Microsoft Foundry；在 VS Code, JetBrains, Eclipse, Xcode 中支持 Agent, Plan, Ask, Edit 模式
2026 年 1 月支持任何 OpenAI 兼容的服务商 + AWS Bedrock 和 Google AI Studio；支持 Responses API 模型
2026 年 6 月 23 日GitHub Copilot 应用内开启 BYOK —— 所有付费计划公测
2026 年 6 月 18 日VS Code：BYOK 无需 GitHub 登录及 Copilot 订阅；费用由服务商结算，不消耗 Copilot 请求额度
2026 年 7 月 14 日Copilot for JetBrains 支持自定义 OpenAI 兼容端点 —— 覆盖所有订阅等级

连接 JoinGonka Gateway：分步指南

你需要一个 jg-… 密钥——在网关注册时发放，同时赠送 3M 免费起始 token，无需绑卡。密钥和模型需要在每个 Copilot 客户端中分别设置——以下是三种方式。

VS Code——Custom Endpoint 提供商。这是当前推荐的方式：原有的「OpenAI Compatible」提供商和 github.copilot.chat.customOAIModels 设置均已弃用。

步骤操作
1. 模型编辑器命令面板 → Chat: Manage Language Models（或聊天模型列表中的齿轮图标）
2. 提供商Add Models → Custom Endpoint；分组名称例如 JoinGonka
3. 密钥粘贴你的 jg-…——VS Code 会将其存入自有的安全存储，而非文件中
4. API 类型Chat Completions
5. 模型VS Code 会打开 chatLanguageModels.json——用下方代码块替换新分组的 "models" 数组并保存文件
6. 选择在聊天模型列表中选择该模型；若未出现，重启 VS Code
"models": [
  {
    "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "name": "DeepSeek V4 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 347232,
    "maxOutputTokens": 32768
  },
  {
    "id": "MiniMaxAI/MiniMax-M2.7",
    "name": "MiniMax M2.7 (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 191808,
    "maxOutputTokens": 8192
  },
  {
    "id": "zai-org/GLM-5.3-Flash",
    "name": "GLM 5.3 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 381808,
    "maxOutputTokens": 8192
  }
]

maxInputTokens 是模型上下文窗口减去回复上限后的值：它与 maxOutputTokens 共同定义了窗口大小。若缺少 toolCalling: true，模型在处理智能体时不会出现在列表中。

Copilot CLI——仅支持环境变量。该提供商没有配置文件，需在启动 copilot 的 shell 中设置：

export COPILOT_PROVIDER_BASE_URL=https://gate.joingonka.ai/v1
export COPILOT_PROVIDER_TYPE=openai
export COPILOT_PROVIDER_API_KEY=jg-your-key
export COPILOT_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=347232
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=32768
copilot

只有 Copilot CLI 会读取 COPILOT_PROVIDER_* 这些名称，因此该设置不会影响你其他工具。CLI 要求模型支持 tool calling 和 streaming——网络中的所有模型均具备这两项能力。

JetBrains——GitHub Copilot 插件。打开 Copilot Chat → 模型列表 → Manage Models，选择具有 OpenAI 兼容 endpoint 的提供商，点击 Add Models 并填入 Base URL https://gate.joingonka.ai/v1、jg-… 密钥和模型标识符。点击 Save，在你的密钥下勾选该模型并再次保存——它便会与内置模型一同出现在列表中。

提示。命令 npx @joingonka/setup --tool copilot-byok 会打印出全部三个章节，已填好你的密钥和所选模型的真实限额——包括可直接用于 VS Code 的 "models" 数组——并通过实时请求验证网关是否接受该密钥和模型。它不写入任何文件：每个 Copilot 客户端都将密钥保存在各自的存储中。

如何选择网络模型

所有三种网络模型都支持流式传输和 tool calling。deepseek-ai/DeepSeek-V4-Flash-0731 拥有网络中最长的上下文之一（380K token）和最大的输出，高达 32768 token：适合大型代码库和长时间的代理会话。MiniMaxAI/MiniMax-M2.7 是通用的，输出高达 8192 token。zai-org/GLM-5.3-Flash 是 Z.ai 的推理模型，拥有网络中最长的上下文（390K token）：在回答前会先进行推理，输出高达 8192 token；响应预算的一部分用于推理，因此请勿在设置中将输出限制设得太低。

关于 public preview 限制的说明

BYOK 涵盖了 Agent 会话和聊天；内联建议和语义项目搜索仍由 Copilot 模型处理，并且需要 GitHub 账户 — 这是 Copilot 本身的限制，而不是提供程序的限制。在 Copilot Business 和 Enterprise 中，本地 BYOK 由管理员策略（“Bring Your Own Language Model Key”）管理：如果界面中没有该选项，则说明它在组织层面被禁用了。Vision 任务无法通过网关运行：网络模型仅为文本模型。如果工具以 Responses API 格式发送请求，网关会接受它们：POST /v1/responses，流式传输和 function tools 均可工作。我们不存储对话，因此 store 会被忽略，previous_response_id 会返回错误 — 请在 input 中传递完整历史记录。

BYOK 将 Copilot 从限额订阅转变为你的推理接口。在 VS Code 中使用 Chat: Manage Language Models → Add Models → Custom Endpoint，在 Copilot CLI 中使用 COPILOT_PROVIDER_* 变量，在 JetBrains 中使用 Manage Models → Add Models；使用 gate.joingonka.ai/v1 地址和 jg- 密钥，Agent 会话将运行在 Gonka 网络模型上，按实时网络价格计费，不占用你的 Copilot 请求配额。从免费启动代币开始吧。
← JetBrains IDE + JoinGonka Gateway — 使用自己的 endpoint 替代点数消耗 Zed + JoinGonka Gateway — 编辑器中的低成本推理 →

想了解更多？

探索其他章节或立即开始赚取 GNK。

获取免费代币 →