> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 查询账单列表
## 请求头
Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
## 查询参数
统计粒度。取值：
* `Hour`：按小时。
* `Day`：按天。
* `Week`：按周。
* `Month`：按月。
产品类型。常用值：
* `summary`：总账单。
* `gpu`：GPU 实例。
* `llm`：LLM API。
* `serverless`：Serverless Endpoint。
* `cloud_storage`：存储资源。
* `gen_api`：图像/视频/音频生成 API。
* `cloud_sandbox`：Agent 沙箱。
* `llm_dedicated_endpoint`：LLM 专属端点。
* `web_search`：联网搜索。
* `bare_metal`：裸金属。
产品名称，支持模糊匹配。
产品子分类。
查询开始时间，秒级 Unix 时间戳（int64）。
查询结束时间，秒级 Unix 时间戳（int64）。
资源实例 ID。
当前接口不分页，建议单次查询时间范围不超过 31 天。如需拉取更长时间，建议按自然月或自然周分段请求。
## 响应参数
账单列表。
用户账号 ID。
账单开始时间，秒级 Unix 时间戳。
账单结束时间，秒级 Unix 时间戳。
计费方式：`1`（按量计费）、`2`（包年包月）。
产品名称。
产品类型或产品子分类。
资源实例 ID。
产品 ID。
用量字段 0。不同产品类型含义不同：
* `llm`：输入 Token 数。
* `gpu`：卡数 × 计费时长。
* `cloud_storage`：存储容量 × 计费时长。
* `serverless`：所有 worker 数量 × 时长之和。
用量字段 1。`llm` 时通常表示输出 Token。
用量字段 2。`llm` 时通常表示读 Cache Token。
用量字段 3。`llm` 时通常表示写 5min Cache Token。
用量字段 4。`llm` 时通常表示输出 Reasoning Token，当前不支持。
用量字段 5。`llm` 时通常表示写 1h Cache Token。
用量字段 6。
用量字段 7。
用量字段 8。
用量字段 9。
用量字段 10。
用量字段 11。
用量字段 12。
用量字段 13。
用量字段 14。
用量字段 15。
原价字段 0。
* `llm`：输入 / 1M Token 单价。
* `gpu`：单价 / 卡 / 小时。
* `cloud_storage`：单价 / GB / 天。
原价字段 1。`llm` 时通常表示输出 / 1M Token 单价。
原价字段 2。`llm` 时通常表示读 Cache / 1M Token 单价。
原价字段 3。`llm` 时通常表示写 5min Cache / 1M Token 单价。
原价字段 4。`llm` 时通常表示写 Reasoning Token / 1M Token 单价。
原价字段 5。`llm` 时通常表示写 1h Cache / 1M Token 单价。
折后单价字段 0。
* `llm`：输入 / 1M Token 折后单价。
* `gpu`：折后单价 / 卡 / 小时。
* `cloud_storage`：折后单价 / GB / 天。
折后单价字段 1。`llm` 时通常表示输出 / 1M Token 折后单价。
折后单价字段 2。`llm` 时通常表示读 Cache / 1M Token 折后单价。
折后单价字段 3。`llm` 时通常表示写 5min Cache / 1M Token 折后单价。
折后单价字段 4。`llm` 时通常表示写 Reasoning Token / 1M Token 折后单价。
折后单价字段 5。`llm` 时通常表示写 1h Cache / 1M Token 折后单价。
总费用，单位为 1/10000 元。
代金券抵扣费用，单位为 1/10000 元。
现金支付费用，单位为 1/10000 元。
现金支付费用展示值，单位为元。
价格精度。单价（元）= 单价 / 10000 / `pricePrecision`。
大语言模型系列。
请求次数。
多模态模型计费明细。
阶梯计费配置。
```bash theme={null}
curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/bill/list?cycleType=Day&productCategory=llm&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer '
```
```json 200 theme={null}
{
"bills": [
{
"userId": "",
"startTime": "1764547200",
"endTime": "1764633599",
"billingMethod": 1,
"productName": "",
"category": "llm",
"ownerID": "",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": ""
}
]
}
```