curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"startTime": "1767225600",
"endTime": "1767311999",
"billingMethod": 1,
"productName": "<string>",
"category": "llm",
"ownerID": "<api_key_id>",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": "<string>",
"apikeyName": "<string>",
"apikeyMask": "sk-****"
}
]
}
账单管理
查询 API Key 账单
GET
/
openapi
/
v1
/
billing
/
apikey
/
bill
/
list
curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"startTime": "1767225600",
"endTime": "1767311999",
"billingMethod": 1,
"productName": "<string>",
"category": "llm",
"ownerID": "<api_key_id>",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": "<string>",
"apikeyName": "<string>",
"apikeyMask": "sk-****"
}
]
}
请求头
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
查询参数
string
必填
统计粒度。取值：
Day：按天。Week：按周。Month：按月。
string
产品类型或业务分类。常用值：
llm、gen_api、web_search。string
产品名称，支持模糊匹配。
integer
必填
查询开始时间，秒级 Unix 时间戳（int64），必须晚于或等于
2026-01-01 00:00:00。integer
必填
查询结束时间，秒级 Unix 时间戳（int64），必须大于
startTime。该接口仅支持查询
2026-01-01 00:00:00 之后的数据。当前接口不分页，建议单次查询时间范围不超过 31 天。如需拉取更长时间，建议按自然月或自然周分段请求。响应参数
object[]
必填
API Key 账单列表。
隐藏 properties
隐藏 properties
string
必填
用户账号 ID。
string
必填
账单开始时间，秒级 Unix 时间戳。
string
必填
账单结束时间，秒级 Unix 时间戳。
int32
必填
计费方式：
1（按量计费）、2（包年包月）。string
必填
产品名称。
string
必填
产品类型或产品子分类。
string
必填
API Key ID。
string
必填
API Key 名称。
string
必填
脱敏后的 API Key。
string
必填
产品 ID。
string
必填
用量字段 0。
llm 时通常表示输入 / 1M Token 单价；GPU：单价 / 卡 / 小时；存储：单价 / GB / 天。string
必填
用量字段 1。
llm 时通常表示输出 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
用量字段 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：单价 / 卡 / 小时；存储：单价 / 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 时通常表示输入 Token 单价。string
必填
折后单价字段 1。
llm 时通常表示输出 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/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
--header 'Authorization: Bearer <API_KEY>'
{
"bills": [
{
"userId": "<string>",
"startTime": "1767225600",
"endTime": "1767311999",
"billingMethod": 1,
"productName": "<string>",
"category": "llm",
"ownerID": "<api_key_id>",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": "<string>",
"apikeyName": "<string>",
"apikeyMask": "sk-****"
}
]
}
最后修改于 2026年6月2日
⌘I