查询 API Key 账单

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>'

curl --request GET \
  --url 'https://api.ppio.com/openapi/v1/billing/apikey/bill/list?cycleType=Hour&category=llm&startTime=1767225600&endTime=1767830399' \
  --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-****"
    }
  ]
}

GET

openapi

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>'

curl --request GET \
  --url 'https://api.ppio.com/openapi/v1/billing/apikey/bill/list?cycleType=Hour&category=llm&startTime=1767225600&endTime=1767830399' \
  --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

必填

统计粒度。取值：

Hour：按小时。
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 之后的数据。当前接口不分页，单次查询的时间跨度按统计粒度分档限制：

cycleType=Hour：最长 7 天。
cycleType=Day、Week、Month：最长 31 天。

超出上限时接口返回参数错误，错误信息中带有该粒度对应的上限天数和粒度名，例如 time range must not exceed 7 days for cycleType "Hour"。如需拉取更长时间，请按自然周或自然月分段请求。cycleType=Hour 时，返回的每条账单对应一个自然小时：startTime 为该小时的整点，endTime 为该小时的 59 分 59 秒。

时间跨度上限本次新增为服务端校验。此前该限制只在控制台生效，直接调用本接口不做校验，因此原先发送更长跨度请求（例如以 Month 粒度查询 3 个月）的调用方，会从本次更新起收到参数错误。请按上述上限分段请求，并在代码中处理该错误。

响应参数

object[]

必填

API Key 账单列表。

隐藏 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>'

curl --request GET \
  --url 'https://api.ppio.com/openapi/v1/billing/apikey/bill/list?cycleType=Hour&category=llm&startTime=1767225600&endTime=1767830399' \
  --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年8月12日

账单管理

Quota 管理

预算管理

API Key 模型访问

请求头

查询参数

响应参数

​请求头

​查询参数

​响应参数

请求头

查询参数

响应参数