知识库章节 ▾

导航

▸ 从这里开始 按角色

类别

工具 36
词汇表 12

copilot-byok.tag

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

BYOK (bring your own key) 是 GitHub Copilot 的官方机制,允许您连接自己的模型提供商并在其上进行代理会话,而不是使用内置的 GPT 和 Claude。自 2026 年 1 月起,支持任何 OpenAI 兼容的 endpoint;从 6 月 23 日起,BYOK 已在所有付费计划的 Copilot App 中以 public preview 形式提供,并于 7 月 14 日在 JetBrains 版本中推出。这意味着您可以将 Copilot 保留为外壳,而通过 JoinGonka Gateway 进行推理 — 按去中心化 Gonka 网络价格计费,且不消耗订阅的 premium 请求配额。

BYOK 的优势及适用场景

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

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

时间线:功能上线记录

时间功能上线
2025 年 11 月BYOK public preview: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 App 中的 BYOK — 所有付费计划的 public preview
2026 年 7 月 14 日JetBrains Copilot 中的自定义 OpenAI 兼容 endpoint (Pro 及以上计划)

连接 JoinGonka Gateway:分步指南

你需要一个 jg-… 密钥 — 它是在网关注册时提供的,并附赠 10M 免费起始 Token,无需信用卡。

1. 设置打开 Settings → Model Providers (VS Code 中通过 Copilot Chat 打开,Copilot 应用程序中在账户设置里)
2. 提供商添加一个类型为 “OpenAI compatible” 的提供商,Endpoint 为 https://gate.joingonka.ai/v1
3. 密钥粘贴你的 jg-… — 它会被保存在本地钥匙串 (keychain) 中
4. 模型网络模型会出现在内置模型旁边的切换器中;当前列表请参考 GET /v1/models: moonshotai/Kimi-K2.6, MiniMaxAI/MiniMax-M2.7, deepseek-ai/DeepSeek-V4-Flash-0731
5. 会话为每个会话选择模型 — Copilot 托管模型和 BYOK 模型可以自由切换

提示: 命令 npx @joingonka/setup --tool copilot-byok 会打印出下方字段所需的预设值(Base URL、密钥、带有当前限额的模型 ID),并进行实时请求以验证网关是否接受它们。Copilot 本身只能通过 UI 进行配置 — 没有可安全修改的配置文件,因此必须手动输入这些值。

如何选择网络模型

所有三种网络模型均支持 streaming 和 tool calling。deepseek-ai/DeepSeek-V4-Flash-0731 拥有网络中最长的上下文 (380K token) 和高达 32768 token 的输出:适用于大型仓库和长代理会话。moonshotai/Kimi-K2.6 是适用于多步骤任务的强力代理模型。MiniMaxAI/MiniMax-M2.7 是通用型模型;Kimi 和 MiniMax 支持高达 8192 token 的输出。

关于 public preview 限制的说明

BYOK 覆盖代理会话和聊天;编辑器中的 inline 建议 可能仍会继续运行在 Copilot 的模型上 — 这是 Copilot 本身的限制,而非提供商的问题。Enterprise 版本的 BYOK 在组织层面进行配置,适用于 GitHub Enterprise/Business。通过网关无法进行 Vision 任务:网络模型是纯文本的。如果工具通过 Responses API 格式发送请求,目前网关尚不支持,请选择 Chat Completions。

BYOK 将 Copilot 从有配额限制的订阅转化为您推理任务的外壳:Settings → Model Providers → endpoint gate.joingonka.ai/v1 + 密钥 jg- — 代理会话即可按 Gonka 网络价格运行,而不占用 premium 配额。从 10M 免费 token 开始体验吧。

想了解更多?

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

copilot-byok.cta.text →