{"meta":{"title":"账单报告参考资料","intro":"计费报告显示帐户的详细 GitHub 使用情况、 AI credits 使用情况 和计费信息。","product":"计费与付款","breadcrumbs":[{"href":"/zh/billing","title":"计费与付款"},{"href":"/zh/billing/reference","title":"参考"},{"href":"/zh/billing/reference/billing-reports","title":"账单报告"}],"documentType":"article"},"body":"# 账单报告参考资料\n\n计费报告显示帐户的详细 GitHub 使用情况、 AI credits 使用情况 和计费信息。\n\n使用情况报告显示有关帐户 GitHub 使用情况的详细信息，包括使用的每个 SKU 数量以及生成的可计费金额。\n\n要生成使用情况报告，请参阅“[查看按流量计费的产品和许可证的使用情况](/zh/billing/how-tos/products/view-productlicense-use#downloading-usage-reports)”。\n\n## 报表类型\n\n以下报表类型可用。\n\n* 按流量计费的使用情况页：\n  * **汇总使用情况报告**：所有付费产品的使用情况摘要，最长为一年。\n  * **详细使用情况报告**：所有付费产品的详细使用情况报告，最长期限为 31 天。\n* AI 使用情况页：\n  * **AI 使用情况报告**：详细列出了最长 31 天内每个用户消耗的 AI credits。\n\n### 汇总使用情况报告\n\n该报告会根据以下数值组合，对 `quantity`、`gross_amount`、`discount_amount` 和 `net_amount` 字段进行求和：`date`、`sku`、`repository`、`cost_center_name`。 如果使用情况报告适用于具有组织的企业，则金额也将按组织价值进行汇总。\n\n### 详细使用情况报告\n\n详细使用情况报告包含与汇总报告相同的字段，并添加 `username` 和 `workflow_path`。\n\n该报告会根据以下数值组合，对 `quantity`、`gross_amount`、`discount_amount` 和 `net_amount` 字段进行求和：`date`、`sku`、`organization`、`repository`、`cost_center_name`、`username`、`workflow_path`。\n\n> \\[!NOTE] 详细使用情况报告的数据只能通过 GitHub Web 界面获取，不能通过 REST API `/usage` 终结点获取。 REST API 仅提供对汇总计费信息的访问权限。\n\n### AI 使用情况报告\n\n本报告包含有关 AI credits 消耗的更多详细信息。 报告根据以下值的组合对`quantity`、`gross_amount`、`discount_amount` 和`net_amount`字段进行求和：`date`、`model`、`username`。 对于每个模型，报表还会将令牌使用情况分解为`input`“、`output``cache_read`”和`cache_write`“字段”，以便可以看到每个模型AI credits消耗背后的令牌详细信息。\n\n## 使用情况报告字段\n\n使用情况报告包含以下字段。\n\n| 字段                          | 说明                                                                                          |\n| --------------------------- | ------------------------------------------------------------------------------------------- |\n| `date`                      | 发生使用的日期。 所有使用情况均以 UTC 格式记录。                                                                 |\n| `product`                   | 所使用的GitHub产品。                                                                               |\n| `sku`                       | 使用的特定 GitHub 产品 SKU。                                                                        |\n| `quantity`                  | 已使用的 SKU 的数量。                                                                               |\n| `unit_type`                 | 产品 SKU 的度量单位。                                                                               |\n| `applied_cost_per_quantity` | 产品 SKU 的单位成本。                                                                               |\n| `gross_amount`              | 已使用的产品 SKU 的数量。                                                                             |\n| `discount_amount`           | 折扣后的使用量。 账户包含的使用量折扣会在此字段中反映 还包括对公共存储库中标准 GitHub Actions 托管的运行器以及自托管运行器的 GitHub 使用折扣。        |\n| `net_amount`                | 应用 `discount_amount` 后的可计费使用量。 这是你的帐户将被计费的金额。 `gross_amount - discount_amount = net_amount` |\n| `username`                  | 与使用情况关联的用户（如适用）。 <br><br> 不包括在`Summarized usage report`内。                                   |\n| `organization`              | 与使用情况关联的组织（如适用）。                                                                            |\n| `repository`                | 与使用情况关联的仓库（如适用）。                                                                            |\n| `workflow_path`             | 生成使用情况的 GitHub Actions 工作流的路径（如果适用）。 <br><br>仅在 `Detailed usage report` 中可用                 |\n| `cost_center_name`          | 与使用情况关联的成本中心（如适用）。                                                                          |\n|                             |                                                                                             |\n| `model`                     | 所使用的模型，例如 `claude-sonnet-4`。 <br><br>仅在 `AI usage report` 中可用                               |\n| `input`                     | 模型使用的输入令牌数。 <br><br>仅在 `AI usage report` 中可用                                                |\n| `output`                    | 模型生成的输出令牌数。 <br><br>仅在 `AI usage report` 中可用                                                |\n| `cache_read`                | 为模型读取的缓存令牌数。 <br><br>仅在 `AI usage report` 中可用                                               |\n| `cache_write`               | 为模型编写的缓存令牌数。 <br><br>仅在 `AI usage report` 中可用                                               |\n|                             |                                                                                             |\n\n## 接收报告\n\n使用情况报告通过电子邮件发送到与帐户 GitHub 关联的默认电子邮件地址。 每个帐户一次只能请求一份使用情况报告。\n\n## 计量使用报告中已关闭的字段\n\nGitHub 旨在最大程度地减少对使用情况报表结构的更改，但有时报表结构或字段可能会更改。\n\n已从使用情况报表中删除以下字段。\n\n| 字段              | 替代                     |\n| --------------- | ---------------------- |\n| `usage_at`      | 请改为参考 `date`。          |\n| `workflow_name` | 请改为参考 `workflow_path`。 |"}