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
}
]
}
请求头
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
查询参数
string
产品类型。常用值：
summary：总账单。gpu：GPU 实例。serverless：Serverless Endpoint。cloud_storage：云存储。local_storage：本地存储。image：镜像。bare_metal：裸金属。
string
产品名称，支持模糊匹配。
int64
查询开始时间，秒级 Unix 时间戳。
int64
查询结束时间，秒级 Unix 时间戳。
string
资源实例 ID。
当前接口不分页，建议单次查询时间范围不超过 31 天。如需拉取更长时间，建议按自然月或自然周分段请求。
响应参数
object[]
必填
月度账单列表。
隐藏 properties
隐藏 properties
string
必填
用户账号 ID。
string
子用户账号 ID。
string
必填
账单开始时间，秒级 Unix 时间戳。
string
必填
账单结束时间，秒级 Unix 时间戳。
string
必填
产品名称。
string
必填
产品类型。
string
必填
产品 ID。
string
必填
资源实例 ID。
string
必填
计费方式。
monthly 表示包年包月。string
必填
包年包月交易类型。常用值：
monthly_new_buy：新购。monthly_re_buy：续费。monthly_re_config：变更配置或扩容。
int32
必填
计费方式：
1：按量计费。2：包年包月。3：退款。4：Spot 计费。5：Batch API。6：Saving Plan。7：LLM 多模态计费。8：裸金属测试扣分。
string
必填
单价。
string
必填
用量。
gpu 时通常表示 GPU 卡数 × 包月时长；存储资源时通常表示存储容量。string
必填
总费用，单位为 1/10000 元。
string
必填
代金券抵扣费用，单位为 1/10000 元。
string
必填
现金支付费用，单位为 1/10000 元。
float
必填
现金支付费用展示值，单位为元。
int32
必填
价格精度。单价（元）= 单价 / 10000 /
pricePrecision。string
必填
账单创建时间，秒级 Unix 时间戳。
string
必填
计费周期，格式为
YYYY-MM。int32
存储资源使用时长，单位为天。
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
}
]
}
最后修改于 2026年5月25日
⌘I