curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/bill/list?cycleType=Day&productCategory=llm&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"startTime": "1764547200",
"endTime": "1764633599",
"billingMethod": 1,
"productName": "<string>",
"category": "llm",
"ownerID": "<string>",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": "<string>"
}
]
}
账单管理
查询账单列表
GET
/
openapi
/
v1
/
billing
/
bill
/
list
curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/bill/list?cycleType=Day&productCategory=llm&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"startTime": "1764547200",
"endTime": "1764633599",
"billingMethod": 1,
"productName": "<string>",
"category": "llm",
"ownerID": "<string>",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": "<string>"
}
]
}
请求头
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 天。如需拉取更长时间，建议按自然月或自然周分段请求。
响应参数
账单列表。
隐藏 properties
隐藏 properties
用户账号 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。大语言模型系列。
请求次数。
多模态模型计费明细。
阶梯计费配置。
curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/bill/list?cycleType=Day&productCategory=llm&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"startTime": "1764547200",
"endTime": "1764633599",
"billingMethod": 1,
"productName": "<string>",
"category": "llm",
"ownerID": "<string>",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": "<string>"
}
]
}
⌘I