GitHub 在 Copilot 使用量 API 中新增指标，分别标识通过开发者个人密钥或本地模型处理的请求，以及通过组织指定模型处理的请求。企业和组织管理员可将其与现有 Copilot 提供的模型使用量区分开，在报告中了解使用路径、成本归属及费用承担方的划分方式。

1. 分别统计两种 BYOK 路径

GitHub 在 2026年11月3日的更新公告中表示，新指标同时面向企业和组织报告提供。可在按用户报告、汇总报告、单日报告和 28 天报告中查看。

本地 BYOK 是指开发者连接自己的服务商密钥或本地模型。开发者在客户端配置后，Copilot CLI 或 GitHub Copilot 应用的请求会直接发送至相应服务商或本地模型。

组织自定义模型由管理员在 GitHub 设置中指定。请求经 GitHub 转发至组织的服务商，GitHub 在服务端观测这些请求。因此，无论客户端类型如何，包括 IDE 在内，这条路径的使用量都会被记录。

2. 展示用户活动及请求和令牌数量

按用户报告中的 used_local_byok 表示该用户当天是否曾在 CLI 或应用中发送过本地 BYOK 请求。细分统计 totals_by_local_byok 按 BYOK 类型及 CLI、应用分别统计会话、请求、提示和令牌数量，并纳入按用户报告及整体汇总报告。

活跃用户数按日、自然周和自然月提供，同一用户不会被重复计算。这些数据可在汇总报告中查看。

组织自定义模型通过各模型汇总条目的 is_custom_enterprise_model 是否为真来识别。如果同一模型既作为 Copilot 提供的模型使用，也作为自定义模型使用，其条目会分开，自定义模型条目包含实际请求数和令牌数。

3. 现有总量不变，成本解读方式发生变化

此次变化并非向现有统计中增加新的使用量，而是按路径细分原已包含在总量中的使用量。本地 BYOK 使用量属于现有 CLI 及 Copilot 应用总量的一部分，组织自定义模型使用量也已计入各客户端总量。因此，新指标可以帮助区分使用量来源和费用承担方。

管理员可单独查看 Copilot 提供的使用量，从而更容易理解每位用户的 Copilot 成本。而发送至自有服务商的请求费用，需要查看该服务商的账单，免费本地模型的使用量也可单独查看。

还可以按 BYOK 或自定义模型的使用情况对用户分组，并与此前跟踪的 Copilot 使用指标比较。这也有助于确认谁通过哪条路径发送请求，并与组织的 BYOK 政策对照。

4. 获取 API 报告的方法与访问条件

报告 API 返回会在一定时间后过期的下载链接。可以请求企业和组织的单日报告或最近 28 天报告。

根据文档，企业单日报告从 2025年10月10日的数据起提供，最多可访问查询时点之前 1 年的数据。最近 28 天报告覆盖以最近一个已完成处理的日期为结束日的完整 28 天。

企业报告面向企业所有者、账单管理员或获授相应指标读取权限的用户提供。组织报告可由组织所有者和拥有该组织指标读取权限的用户使用。还必须在整个企业范围内启用 Copilot 使用量指标策略。

请求最近 28 天用户报告的示例如下。

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/copilot/metrics/reports/users-28-day/latest

5. 解读需考虑记录发送状态与部署时间

本地 BYOK 依赖客户端发送的使用记录，因此，若记录发送被关闭，或部分服务商未发送令牌数，使用量或令牌数可能低于实际值。组织自定义模型标记不会追溯添加到此次变更部署日期之前的报告中。

新指标的核心在于不改变现有使用量总计，而是揭示处理路径，从而更准确地审视成本与使用策略。