GitHub的Copilot用量指标API开始单独统计BYOK和企业自定义模型：本地BYOK只是下限且不按模型拆分；旧报表日不回填is_custom_enterprise_model标记

2026年11月3日，GitHub更新日志宣布，Copilot用量指标API现在会单独显示“自带密钥”（BYOK）的使用情况，让管理员把它和Copilot托管模型的用量区分开。此前，本地模型和自定义模型的名称常与Copilot的模型同名，BYOK用量混在托管总量里，难以分辨。更新把BYOK分成两类：一类是开发者在自己的客户端里配置的“本地BYOK”，另一类是管理员在GitHub设置里配置的“企业自定义模型”。两类都会出现在企业和组织报告里，既有用户级也有汇总级，1天和28天报告都包含。

本地BYOK指开发者用自己的服务商密钥，或用Ollama、Foundry Local、LM Studio、llama-server等工具提供的本地模型。请求从Copilot CLI或GitHub Copilot应用直接发往开发者自己的服务商或本地模型，不经过GitHub。相关字段有：用户级报告里的used_local_byok，表示该用户当天在Copilot CLI或Copilot应用里是否至少发过一次本地BYOK请求；totals_by_local_byok，按byok_kind（local_managed、local_user、local_auto、remote_user）和surface（copilot_cli、copilot_app）给出会话、请求、提示和token数，用户级和汇总级都有；以及汇总报告里按日、周、月统计的活跃本地BYOK用户数。

企业自定义模型则由管理员在GitHub设置中配置，请求经GitHub转发给你的服务商。新增的is_custom_enterprise_model是totals_by_client里每个模型条目上的布尔值，使用了为企业或组织配置的自定义模型时为true。因为这类请求在GitHub服务端可见，所以覆盖所有客户端，包括各类IDE。同一个模型名如果既作为Copilot托管模型又作为自定义模型使用，会出现为两条记录，数字不会混在一起。自定义模型的条目带有真实的请求数和token数。

这对治理和成本分析有直接用处。管理员可以看出谁在把请求发往自己的服务商密钥、本地模型或企业自定义模型，并与自己的BYOK政策对照；可以把Copilot托管用量与由自己的服务商计费或在免费本地模型上运行的用量分开，让“每用户成本”只反映Copilot实际提供的部分；也可以在一个视图里看全企业各类AI工具的用量，并把使用BYOK或自定义模型的用户与已有的Copilot指标比较。注意这里给出的是会话、请求、提示和token的计数，文章没有说明有美元金额字段，所以不能直接当作账单。

几条重要限制写在“重要说明”里。第一，现有总数不变：BYOK用量本来就已计入，本地BYOK是totals_by_cli和totals_by_copilot_app的子集，自定义模型用量本来就在totals_by_client里。第二，本地BYOK只是下限：这些字段依赖客户端遥测，关闭遥测时会少记，一些本地服务商不报告token用量，所以token数也可能偏低；企业自定义模型由服务端观察，没有这个问题。第三，模型名沿用现有的规范化规则，无法识别的名称显示为unknown，本地BYOK也不按模型名拆分。第四，不回填：发布之前的报告日期不含is_custom_enterprise_model；文章没有说明更早的日期是否有本地BYOK字段。第五，权限：企业所有者、企业账单管理员、组织所有者，以及自定义组织或企业角色中拥有“查看Copilot指标”权限的人可以使用，并且必须启用Copilot用量指标策略。

“子集”这条规则在实践中有一个后果：重复计算。本地BYOK已经包含在totals_by_cli和totals_by_copilot_app里，自定义模型用量已经包含在totals_by_client里，如果仪表盘把新字段加到旧总数上，同一批请求就会被算两次。新字段是用来扣除或筛选的切片，不是要相加的额外行。两类数据的可信度也不同：自定义模型的计数由GitHub服务端观察，本地BYOK的计数来自可以被开发者或策略关闭的客户端遥测，所以本地BYOK曲线下降，可能是用量真的减少，也可能只是遥测变少，仅凭报告无法区分这两种情况，需要结合其他信息判断。

支持文档把这些端点的细节写得更具体：报告通过有时效的签名链接下载，是NDJSON文件；企业端点要求“Copilot usage metrics”策略设为对整个企业启用；企业端点的细粒度权限叫“View Enterprise Copilot Metrics”，组织端点是“View Organization Copilot Metrics”；历史数据可追溯到一年内，最早从2025年10月10日起。需要注意的是，这份REST文档本身没有定义这次新增的BYOK字段，字段含义以更新日志为准；而更新日志写的权限名“View Copilot Metrics”与文档里的两个权限名并不完全一致，文章没有给出对应关系，配置前应在自己的GitHub设置中核对。