curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"memberId": "<string>",
"startTime": "1764547200",
"endTime": "1767225599",
"productName": "<string>",
"productCategory": "gpu",
"ownerID": "<string>",
"tradeMode": "monthly",
"tradeType": "monthly_new_buy",
"basePrice": "1000000",
"billNum": "1",
"amount": "1000000",
"voucherAmount": "0",
"payAmount": "1000000",
"payAmountDisplay": 100,
"pricePrecision": 1,
"createTime": "1764547200",
"cycle": "2025-12",
"productId": "<string>",
"billingMethod": 2
}
]
}
账单管理
查询包月账单列表
GET
/
openapi
/
v1
/
billing
/
bill
/
monthly
/
list
curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"memberId": "<string>",
"startTime": "1764547200",
"endTime": "1767225599",
"productName": "<string>",
"productCategory": "gpu",
"ownerID": "<string>",
"tradeMode": "monthly",
"tradeType": "monthly_new_buy",
"basePrice": "1000000",
"billNum": "1",
"amount": "1000000",
"voucherAmount": "0",
"payAmount": "1000000",
"payAmountDisplay": 100,
"pricePrecision": 1,
"createTime": "1764547200",
"cycle": "2025-12",
"productId": "<string>",
"billingMethod": 2
}
]
}
请求头
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
查询参数
产品类型。常用值：
summary：总账单。gpu：GPU 实例。serverless：Serverless Endpoint。cloud_storage：云存储。local_storage：本地存储。image：镜像。bare_metal：裸金属。
产品名称，支持模糊匹配。
查询开始时间，秒级 Unix 时间戳。
查询结束时间，秒级 Unix 时间戳。
资源实例 ID。
当前接口不分页，建议单次查询时间范围不超过 31 天。如需拉取更长时间，建议按自然月或自然周分段请求。
响应参数
月度账单列表。
隐藏 properties
隐藏 properties
用户账号 ID。
子用户账号 ID。
账单开始时间，秒级 Unix 时间戳。
账单结束时间，秒级 Unix 时间戳。
产品名称。
产品类型。
产品 ID。
资源实例 ID。
计费方式。
monthly 表示包年包月。包年包月交易类型。常用值：
monthly_new_buy：新购。monthly_re_buy：续费。monthly_re_config：变更配置或扩容。
计费方式：
1：按量计费。2：包年包月。3：退款。4：Spot 计费。5：Batch API。6：Saving Plan。7：LLM 多模态计费。8：裸金属测试扣分。
单价。
用量。
gpu 时通常表示 GPU 卡数 × 包月时长；存储资源时通常表示存储容量。总费用，单位为 1/10000 元。
代金券抵扣费用，单位为 1/10000 元。
现金支付费用，单位为 1/10000 元。
现金支付费用展示值，单位为元。
价格精度。单价（元）= 单价 / 10000 /
pricePrecision。账单创建时间，秒级 Unix 时间戳。
计费周期，格式为
YYYY-MM。存储资源使用时长，单位为天。
curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"memberId": "<string>",
"startTime": "1764547200",
"endTime": "1767225599",
"productName": "<string>",
"productCategory": "gpu",
"ownerID": "<string>",
"tradeMode": "monthly",
"tradeType": "monthly_new_buy",
"basePrice": "1000000",
"billNum": "1",
"amount": "1000000",
"voucherAmount": "0",
"payAmount": "1000000",
"payAmountDisplay": 100,
"pricePrecision": 1,
"createTime": "1764547200",
"cycle": "2025-12",
"productId": "<string>",
"billingMethod": 2
}
]
}
⌘I