GitHub Copilot 用量 API 新增 BYOK 与企业自定义模型统计

GitHub 于 2026 年 11 月发布 Copilot 用量指标 API 更新，新增对 BYOK 与企业自定义模型的独立统计。此前这类调用常因模型名称与 Copilot 托管模型重合而混入总量，现在企业所有者、账单管理员等角色可在报告中分别查看本地 BYOK 与企业自定义模型的请求和 token 数据。

本地 BYOK 的统计字段与覆盖范围

本地 BYOK 指开发者在自己客户端配置的提供商密钥，或由 Ollama、Foundry Local、LM Studio、llama-server 等工具提供的本地模型。请求从 Copilot CLI 或 GitHub Copilot 应用直接发往开发者自己的提供商密钥或本地模型，不经过 GitHub 服务器。

API 为此提供三类字段：used_local_byok 表示用户当天是否至少发起过一次本地 BYOK 请求，出现在用户级报告中；totals_by_local_byok 给出会话、请求、提示词和 token 计数，并按 byok_kind（local_managed、local_user、local_auto、remote_user）和 surface（copilot_cli 或 copilot_app）拆分，出现在用户级与聚合报告中；daily_active_local_byok_users、weekly_active_local_byok_users 和 monthly_active_local_byok_users 则统计日、自然周、自然月内有本地 BYOK 活动的去重用户数，出现在聚合报告中。

企业自定义模型的识别方式

企业自定义模型由管理员在 GitHub 设置中配置，请求经 GitHub 路由到企业自己的模型提供商。API 在 totals_by_client 的每个 totals_by_model 条目上新增布尔字段 is_custom_enterprise_model，当请求使用了为企业或组织配置的自定义模型时该值为 true。

由于 GitHub 在服务端观测这些请求，该字段覆盖包括 IDE 在内的所有客户端。若同一模型既作为 Copilot 托管模型又作为自定义模型使用，会以两条独立条目出现，计数保持分开；自定义模型条目包含真实的请求数和 token 数。

报告维度与访问权限

两类数据均出现在企业与组织报告中，支持用户级和聚合级，并提供 1 天与 28 天报告周期。可访问的角色包括企业所有者、企业账单管理员、组织所有者，以及拥有授予 View Copilot Metrics 权限的自定义组织或企业角色，同时需要启用 Copilot 用量指标策略。

GitHub 在说明中强调，现有总量没有变化：BYOK 用量此前已被计入，本地 BYOK 是 totals_by_cli 和 totals_by_copilot_app 的子集，自定义模型用量也已在 totals_by_client 中，本次更新只是将其拆分出来。

统计限制与已知偏差

本地 BYOK 字段依赖客户端遥测，遥测关闭时会低估实际用量；部分本地提供商不上报 token 用量，token 计数也可能偏低。企业自定义模型计数由服务端观测，不受这一限制影响。

在模型名称方面，自定义模型沿用现有的模型名称规范化处理，无法识别的名称会显示为 unknown；本地 BYOK 用量不按模型名称拆分。此外本次发布不做回溯填充，发布之前的报告日期不包含 is_custom_enterprise_model 字段。

知序观察

观察：这次更新的价值在于把原本混在 Copilot 托管模型总量里的 BYOK 与企业自定义模型调用拆开，让企业能按提供商和模型来源核对 BYOK 政策与成本归属。需要注意的是，本地 BYOK 数据依赖客户端遥测，且不按模型名拆分，因此更适合作为治理参考而非精确账单依据；企业自定义模型由服务端观测，数据完整性相对更高。