# 账单报告参考资料

计费报告会显示您账户的详细 GitHub 使用情况、AI credits 消耗情况和计费信息。

使用情况报告显示有关帐户 GitHub 使用情况的详细信息，包括使用的每个 SKU 数量以及生成的可计费金额。

要生成使用情况报告，请参阅“[查看按流量计费的产品和许可证的使用情况](/zh/billing/how-tos/products/view-productlicense-use#downloading-usage-reports)”。

## 报表类型

以下报表类型可用。

* 按流量计费的使用情况页：
  * **汇总使用情况报告**：所有付费产品的使用情况摘要，最长为一年。
  * **详细使用情况报告**：所有付费产品的详细使用情况报告，最长期限为 31 天。
* AI 使用情况页：
  * ```
              **AI 使用情况报告**：详细列出了最长 31 天内每个用户消耗的 AI credits。
    ```

### 汇总使用情况报告

该报告会根据以下数值组合，对 `quantity`、`gross_amount`、`discount_amount` 和 `net_amount` 字段进行求和：`date`、`sku`、`repository`、`cost_center_name`。 如果使用情况报告适用于具有组织的企业，则金额也将按组织价值进行汇总。

### 详细使用情况报告

详细使用情况报告包含与汇总报告相同的字段，并添加 `username` 和 `workflow_path`。

该报告会根据以下数值组合，对 `quantity`、`gross_amount`、`discount_amount` 和 `net_amount` 字段进行求和：`date`、`sku`、`organization`、`repository`、`cost_center_name`、`username`、`workflow_path`。

> \[!NOTE] 详细使用情况报告的数据只能通过 GitHub Web 界面获取，不能通过 REST API `/usage` 终结点获取。 REST API 仅提供对汇总计费信息的访问权限。

### AI 使用情况报告

本报告包含有关 AI credits 消耗的更多详细信息。 报告根据以下值的组合对`quantity`、`gross_amount`、`discount_amount` 和`net_amount`字段进行求和：`date`、`model`、`username`。

## 使用情况报告字段

使用情况报告包含以下字段。

| 字段                          | 说明                                                                                          |
| --------------------------- | ------------------------------------------------------------------------------------------- |
| `date`                      | 发生使用的日期。 所有使用情况均以 UTC 格式记录。                                                                 |
| `product`                   | 所使用的GitHub产品。                                                                               |
| `sku`                       | 使用的特定 GitHub 产品 SKU。                                                                        |
| `quantity`                  | 已使用的 SKU 的数量。                                                                               |
| `unit_type`                 | 产品 SKU 的度量单位。                                                                               |
| `applied_cost_per_quantity` | 产品 SKU 的单位成本。                                                                               |
| `gross_amount`              | 已使用的产品 SKU 的数量。                                                                             |
| `discount_amount`           | 折扣后的使用量。 账户包含的使用量折扣会在此字段中反映 还包括对公共存储库中标准 GitHub Actions 托管的运行器以及自托管运行器的 GitHub 使用折扣。        |
| `net_amount`                | 应用 `discount_amount` 后的可计费使用量。 这是你的帐户将被计费的金额。 `gross_amount - discount_amount = net_amount` |
| `username`                  | 与使用情况关联的用户（如适用）。 <br><br> 不包括在`Summarized usage report`内。                                   |
| `organization`              | 与使用情况关联的组织（如适用）。                                                                            |
| `repository`                | 与使用情况关联的仓库（如适用）。                                                                            |
| `workflow_path`             | 生成使用情况的 GitHub Actions 工作流的路径（如果适用）。 <br><br>仅在 `Detailed usage report` 中可用                 |
| `cost_center_name`          | 与使用情况关联的成本中心（如适用）。                                                                          |
| `model`                     | 所使用的模型，例如 `claude-sonnet-4`。 <br><br>仅在 `AI usage report` 中可用                               |

## 接收报告

使用情况报告通过电子邮件发送到与帐户 GitHub 关联的默认电子邮件地址。 每个帐户一次只能请求一份使用情况报告。

## 计量使用报告中已关闭的字段

GitHub 旨在最大程度地减少对使用情况报表结构的更改，但有时报表结构或字段可能会更改。

已从使用情况报表中删除以下字段。

| 字段              | 替代                     |
| --------------- | ---------------------- |
| `usage_at`      | 请改为参考 `date`。          |
| `workflow_name` | 请改为参考 `workflow_path`。 |