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

核心事实

GitHub 在更新日志中宣布，Copilot 用量指标 API 现可单独呈现「自带密钥」（BYOK）用量，将其与 Copilot 托管模型的用量区分开。据该更新日志，报告覆盖两类 BYOK：一是开发者在客户端配置的本地 BYOK，请求由 Copilot CLI 或 GitHub Copilot 应用直接发往开发者自己的服务商密钥或本地模型，对应字段为 used_local_byok、totals_by_local_byok 及活跃用户数；二是管理员在 GitHub 设置中配置的企业自定义模型，请求经 GitHub 路由至服务商，通过 totals_by_client 中的 is_custom_enterprise_model 识别。两类数据均出现在企业与组织报告中，含用户级与汇总级，提供 1 天与 28 天报告。

背景与影响

GitHub 表示，此前 BYOK 用量会混入 Copilot 托管模型的总量，因为本地模型与自定义模型常与 Copilot 模型同名。新字段可用于核查 BYOK 策略执行情况、区分 Copilot 托管用量与由自有服务商计费或本地免费模型运行的用量，并在企业范围内统一查看不同模型与服务商的 AI 使用情况。GitHub 强调，现有总量口径不变：本地 BYOK 是 totals_by_cli 与 totals_by_copilot_app 的子集，自定义模型用量原本已计入 totals_by_client。

限制与来源

GitHub 说明，本地 BYOK 字段依赖客户端遥测，遥测关闭时会低估；部分本地服务商不上报 token 用量，token 数也可能偏低。企业自定义模型计数在服务端观测，不受此限制。自定义模型名称沿用既有归一化规则，无法识别的名称显示为 unknown，本地 BYOK 不按模型名拆分。本次发布之前的报告日期不含 is_custom_enterprise_model，且不做回填。该功能面向企业所有者、企业账单管理员、组织所有者及拥有查看 Copilot 指标权限的自定义角色，并需启用 Copilot 用量指标策略。具体可用范围与字段定义请以 GitHub 官网当前文档为准。来源：GitHub Changelog，2026 年 11 月 3 日。