Copilot 用量报表可区分自带密钥调用
GitHub 为企业和组织的 Copilot 用量 API 增加了自带密钥(BYOK)字段,用户级和汇总报表都能区分 Copilot 托管模型与自带密钥或自定义模型的用量。开发者在客户端配置的密钥由对应模型供应商计费,本地模型调用无需向模型供应商付费。
AI 深度解读
同一个模型名出现在 Copilot 用量报表里,背后可能是三种账务处理。GitHub 托管的用量走 Copilot 席位和 AI credits,自带云模型密钥的用量由模型供应商计费,本机模型则没有供应商账单。以前这些用量混在一起,仅看报表很难解释团队的 AI 编程支出。
2026 年 11 月 3 日,GitHub 给企业和组织的 Copilot usage metrics API 加了 BYOK 字段。原文拆解了两类自带模型的用量该怎么看,以及为什么拿到新报表后,还得检查遥测覆盖、核对供应商账单。
两类 BYOK,在报表里从哪里看?
BYOK(Bring Your Own Key)通常指自带密钥,这里的本地 BYOK 也包含直接调用本机模型。开发者在客户端配置,Copilot CLI 或 GitHub Copilot app 把请求直接发给开发者配置的供应商,或者发给由 Ollama、Foundry Local、LM Studio、llama-server 等工具提供的本机模型。
用户级报表里的 used_local_byok 表示某位用户当天是否至少发过一次本地 BYOK 请求。totals_by_local_byok 按 byok_kind 和使用入口拆出会话、请求、提示词及 token 数,入口分为 Copilot CLI 和 Copilot app。汇总报表还提供本地 BYOK 的日、周、月活跃用户数。统计 28 天内有多少人用过时,可以按用户去重。同一位开发者连续用了几天,仍然只算一人。
企业自定义模型由管理员在 GitHub 设置中配置,请求经 GitHub 转发给模型供应商。识别它要看 totals_by_client 下每条模型记录的布尔字段 is_custom_enterprise_model。同一个模型既以 Copilot 托管方式使用,又被配置为企业自定义模型时,报表会给出两条记录。做聚合时保留这个字段,同名模型的两路用量才不会被重新合并。
两类 BYOK 都出现在 1 天和 28 天报表里。前提是启用 Copilot usage metrics 策略。企业所有者、企业账单管理员、组织所有者,以及通过自定义角色获得 View Copilot Metrics 权限的人可以读取。
本地用量有漏计,怎么判断缺口?
GitHub 原先已经把 BYOK 请求计入总量,这次更新保留了原有总量,同时把来源拆了出来。历史报表有一个直接限制。上线前的报表日缺少 is_custom_enterprise_model,靠这个字段无法把旧数据按来源补拆。
本地 BYOK 的计数应当视为已观测到的下限。 它依赖客户端遥测,关闭遥测的客户端可能漏报请求。有些本地供应方也不返回 token 用量,即使请求记到了,token 数仍可能偏低。企业自定义模型的请求经过 GitHub,服务端能观察实际请求数和 token 数。本地 BYOK 没有模型名维度,企业自定义模型名则沿用已有的名称归一化规则,无法识别的名字显示为 unknown。
11 月 5 日补充的字段能帮你读懂这个缺口。client_telemetry_present 标记用户是否有客户端遥测,missing_client_telemetry_user_count 给出每日缺少遥测的用户数。usage_metrics_requirements 和 below_usage_metrics_minimum_user_count 则用来识别 IDE 或扩展版本低于用量统计门槛的情况。同一人可能同时落入两组,直接相加会重复计数。字段值为 null 时,应当按数据不可用处理。原文提到了最低版本门槛,没给出具体版本号。
算每人成本,还得接哪张账单?
假设一个团队有一半请求走自带供应商密钥。把两路请求都归到 Copilot 头上,会夸大 GitHub 承担的用量。如果用 GitHub 账单除以混合后的请求总数,算出的单次成本又会被摊薄。团队的人均 AI 支出也可能看起来很低,因为供应商账单还没归到这个团队。
做归集时,可以用同一套团队口径关联 GitHub 和供应商账单。GitHub 在 11 月 3 日新增的 REST API 支持按用户、组织、仓库或企业团队查询所属的成本中心,可以用来辅助归属。自带密钥的实际金额仍要到供应商账单或控制台查。做预测时可以给 Copilot 席位与 AI credits 单列一行,给按供应商费率计费的 BYOK 单列一行。本机模型的活动则保留在用量里,单独标明没有供应商账单。
我的判断
把计费来源带进用量报表,比按模型名猜归属稳妥。模型名相同、计费路径不同,正是按名称分组最容易出错的地方。只做预算汇总时,直接汇总各供应商账单也能回答花了多少钱。接入用量报表的价值在于进一步解释哪些团队在用、走了哪条路径,以及 GitHub 的 credits 消耗该怎么预估。
原文依据 GitHub 更新说明解释字段和限制,没有给实际团队对账样本,也没有比较新旧口径下的人均支出差了多少。对常见的共享供应商密钥,归属还取决于账单或内部记录是否有可匹配的项目、账号等维度。报表能分开用量来源,能分摊到什么粒度,要看团队手里有哪些账单明细。客户端遥测缺口大时,本地 BYOK 数字也适合用来确认已观察到的使用情况,拿它做团队间使用率排名容易误读。
能拿来做什么
- 团队有开发者用 Copilot CLI 接自己的密钥或本机模型时,可以先拉 28 天用户报表,按
used_local_byok统计去重用户,再结合每日遥测缺失人数和版本门槛指标判断覆盖情况。 - 写 Node 报表脚本时,把
is_custom_enterprise_model一起纳入模型记录的分组键。对上线前缺字段的记录保留未分类状态,并在处理遥测指标时保留null,避免报表把历史缺口算成零。 - 做月度预算时,把 Copilot 的席位和 AI credits 与供应商账单按同一团队口径归集,分别列出金额和用量。对共享密钥下无法归属的支出单列一行,让团队人均成本的计算口径一眼可查。