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>"
}
]
}
请求头
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
查询参数
string
必填
统计粒度。取值：
Hour：按小时。Day：按天。Week：按周。Month：按月。
string
必填
产品类型。常用值：
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：裸金属。
string
产品名称，支持模糊匹配。
string
产品子分类。
integer
查询开始时间，秒级 Unix 时间戳（int64）。
integer
查询结束时间，秒级 Unix 时间戳（int64）。
string
资源实例 ID。
当前接口不分页，建议单次查询时间范围不超过 31 天。如需拉取更长时间，建议按自然月或自然周分段请求。
响应参数
object[]
必填
账单列表。
隐藏 properties
隐藏 properties
string
必填
用户账号 ID。
string
必填
账单开始时间，秒级 Unix 时间戳。
string
必填
账单结束时间，秒级 Unix 时间戳。
int32
必填
计费方式：
1（按量计费）、2（包年包月）。string
必填
产品名称。
string
必填
产品类型或产品子分类。
string
必填
资源实例 ID。
string
必填
产品 ID。
string
必填
用量字段 0。不同产品类型含义不同：
llm：输入 Token 数。gpu：卡数 × 计费时长。cloud_storage：存储容量 × 计费时长。serverless：所有 worker 数量 × 时长之和。
string
必填
用量字段 1。
llm 时通常表示输出 Token。string
必填
用量字段 2。
llm 时通常表示读 Cache Token。string
必填
用量字段 3。
llm 时通常表示写 5min Cache Token。string
必填
用量字段 4。
llm 时通常表示输出 Reasoning Token，当前不支持。string
必填
用量字段 5。
llm 时通常表示写 1h Cache Token。string
用量字段 6。
string
用量字段 7。
string
用量字段 8。
string
用量字段 9。
string
用量字段 10。
string
用量字段 11。
string
用量字段 12。
string
用量字段 13。
string
用量字段 14。
string
用量字段 15。
string
必填
原价字段 0。
llm：输入 / 1M Token 单价。gpu：单价 / 卡 / 小时。cloud_storage：单价 / GB / 天。
string
必填
原价字段 1。
llm 时通常表示输出 / 1M Token 单价。string
必填
原价字段 2。
llm 时通常表示读 Cache / 1M Token 单价。string
必填
原价字段 3。
llm 时通常表示写 5min Cache / 1M Token 单价。string
必填
原价字段 4。
llm 时通常表示写 Reasoning Token / 1M Token 单价。string
必填
原价字段 5。
llm 时通常表示写 1h Cache / 1M Token 单价。string
必填
折后单价字段 0。
llm：输入 / 1M Token 折后单价。gpu：折后单价 / 卡 / 小时。cloud_storage：折后单价 / GB / 天。
string
必填
折后单价字段 1。
llm 时通常表示输出 / 1M Token 折后单价。string
必填
折后单价字段 2。
llm 时通常表示读 Cache / 1M Token 折后单价。string
必填
折后单价字段 3。
llm 时通常表示写 5min Cache / 1M Token 折后单价。string
必填
折后单价字段 4。
llm 时通常表示写 Reasoning Token / 1M Token 折后单价。string
必填
折后单价字段 5。
llm 时通常表示写 1h Cache / 1M Token 折后单价。string
必填
总费用，单位为 1/10000 元。
string
必填
代金券抵扣费用，单位为 1/10000 元。
string
必填
现金支付费用，单位为 1/10000 元。
float
必填
现金支付费用展示值，单位为元。
int32
必填
价格精度。单价（元）= 单价 / 10000 /
pricePrecision。string
大语言模型系列。
string
请求次数。
object
多模态模型计费明细。
object
阶梯计费配置。
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>"
}
]
}
最后修改于 2026年6月2日
⌘I