基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
编程提效2026-11-20 22:00

Copilot 用量报表可区分自带密钥调用

dev.to · AI#Copilot#成本归因#自带密钥
Editor brief · 编辑速览

GitHub 为企业和组织的 Copilot 用量 API 增加了自带密钥(BYOK)字段,用户级和汇总报表都能区分 Copilot 托管模型与自带密钥或自定义模型的用量。开发者在客户端配置的密钥由对应模型供应商计费,本地模型调用无需向模型供应商付费。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 与供应商账单按同一团队口径归集,分别列出金额和用量。对共享密钥下无法归属的支出单列一行,让团队人均成本的计算口径一眼可查。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
让 AI 排查布局问题时,截图和 CSS 一起发
下一篇
只算 FLOPs,微调工期平均错了 12 小时

资讯速览

dev.to · AI · 2026-11-20 22:00

AI 评分 8.0 / 10

相关标签

#Copilot#成本归因#自带密钥

继续阅读

  • 量化 70B 模型为何仍会撑爆 48GB 显存
  • 让 AI 排查布局问题时,截图和 CSS 一起发
  • 只算 FLOPs,微调工期平均错了 12 小时
  • 识别冒牌 GPTBot 要看来源 IP
  • 给编程智能体提供 Markdown 版 API 文档