查询账单列表｜管理 API

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",
      "originAmountDecimal": "1.23456789",
      "amountDecimal": "1.000019",
      "payableDecimal": "1.000019",
      "voucherAmountDecimal": "0",
      "originAmount": "12345",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>"
    }
  ]
}

GET

openapi

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",
      "originAmountDecimal": "1.23456789",
      "amountDecimal": "1.000019",
      "payableDecimal": "1.000019",
      "voucherAmountDecimal": "0",
      "originAmount": "12345",
      "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 天。如需拉取更长时间，建议按自然月或自然周分段请求。

金额精度说明

originAmountDecimal、amountDecimal、payableDecimal 和 voucherAmountDecimal 为高精度金额字段，类型为十进制字符串，单位为元，无需除以 10000。具有对应 Decimal 字段的旧整数金额字段已标记为【弃用】，仍保留兼容，JSON 中以字符串返回，单位为 1/10000 元。

响应参数

object[]

必填

账单列表。

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

必填

原始金额（未抵扣），十进制字符串，单位为元。

string

必填

总费用，十进制字符串，单位为元。

string

必填

现金支付费用，十进制字符串，单位为元。

string

必填

代金券抵扣费用，十进制字符串，单位为元。

float

必填

现金支付费用展示值，单位为元。

int32

必填

价格精度。单价（元）= 单价 / 10000 / pricePrecision。

string

大语言模型系列。

string

请求次数。

object

多模态模型计费明细。

object

阶梯计费配置。

string

必填

已弃用

【弃用】原始金额（未抵扣），整数以字符串返回，单位为 1/10000 元。请使用单位为元的 originAmountDecimal。

string

必填

已弃用

【弃用】总费用，整数以字符串返回，单位为 1/10000 元。请使用单位为元的 amountDecimal。

string

必填

已弃用

【弃用】代金券抵扣费用，整数以字符串返回，单位为 1/10000 元。请使用单位为元的 voucherAmountDecimal。

string

必填

已弃用

【弃用】现金支付费用，单位为 1/10000 元。请使用单位为元的 payableDecimal。

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",
      "originAmountDecimal": "1.23456789",
      "amountDecimal": "1.000019",
      "payableDecimal": "1.000019",
      "voucherAmountDecimal": "0",
      "originAmount": "12345",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>"
    }
  ]
}

最后修改于 2026年10月21日

账单管理

Quota 管理

预算管理

API Key 模型访问

API Key 网络访问

查询账单列表

请求头

查询参数

金额精度说明

响应参数

​请求头

​查询参数

​金额精度说明

​响应参数

请求头

查询参数

金额精度说明

响应参数