查询账单列表 - PPIO 派欧云文档中心

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

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>"
    }
  ]
}

请求头

Authorization

string

必填

Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

查询参数

cycleType

string

必填

统计粒度。取值：

Hour：按小时。
Day：按天。
Week：按周。
Month：按月。

productCategory

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：裸金属。

productName

string

产品名称，支持模糊匹配。

响应参数

bills

object[]

必填

账单列表。

隐藏 properties

userId

string

必填

用户账号 ID。

startTime

string

必填

账单开始时间，秒级 Unix 时间戳。

endTime

string

必填

账单结束时间，秒级 Unix 时间戳。

billingMethod

int32

必填

计费方式：1（按量计费）、2（包年包月）。

productName

string

必填

产品名称。

category

string

必填

产品类型或产品子分类。

ownerID

string

必填

资源实例 ID。

productId

string

必填

产品 ID。

billNum0

string

必填

用量字段 0。不同产品类型含义不同：

llm：输入 Token 数。
gpu：卡数 × 计费时长。
cloud_storage：存储容量 × 计费时长。
serverless：所有 worker 数量 × 时长之和。

billNum1

string

必填

用量字段 1。llm 时通常表示输出 Token。

billNum2

string

必填

用量字段 2。llm 时通常表示读 Cache Token。

billNum3

string

必填

用量字段 3。llm 时通常表示写 5min Cache Token。

billNum4

string

必填

用量字段 4。llm 时通常表示输出 Reasoning Token，当前不支持。

billNum5

string

必填

用量字段 5。llm 时通常表示写 1h Cache Token。

billNum6

string

用量字段 6。

billNum7

string

用量字段 7。

billNum8

string

用量字段 8。

billNum9

string

用量字段 9。

billNum10

string

用量字段 10。

billNum11

string

用量字段 11。

billNum12

string

用量字段 12。

billNum13

string

用量字段 13。

billNum14

string

用量字段 14。

billNum15

string

用量字段 15。

basePrice0

string

必填

原价字段 0。

llm：输入 / 1M Token 单价。
gpu：单价 / 卡 / 小时。
cloud_storage：单价 / GB / 天。

basePrice1

string

必填

原价字段 1。llm 时通常表示输出 / 1M Token 单价。

basePrice2

string

必填

原价字段 2。llm 时通常表示读 Cache / 1M Token 单价。

basePrice3

string

必填

原价字段 3。llm 时通常表示写 5min Cache / 1M Token 单价。

basePrice4

string

必填

原价字段 4。llm 时通常表示写 Reasoning Token / 1M Token 单价。

basePrice5

string

必填

原价字段 5。llm 时通常表示写 1h Cache / 1M Token 单价。

discountPrice0

string

必填

折后单价字段 0。

llm：输入 / 1M Token 折后单价。
gpu：折后单价 / 卡 / 小时。
cloud_storage：折后单价 / GB / 天。

discountPrice1

string

必填

折后单价字段 1。llm 时通常表示输出 / 1M Token 折后单价。

discountPrice2

string

必填

折后单价字段 2。llm 时通常表示读 Cache / 1M Token 折后单价。

discountPrice3

string

必填

折后单价字段 3。llm 时通常表示写 5min Cache / 1M Token 折后单价。

discountPrice4

string

必填

折后单价字段 4。llm 时通常表示写 Reasoning Token / 1M Token 折后单价。

discountPrice5

string

必填

折后单价字段 5。llm 时通常表示写 1h Cache / 1M Token 折后单价。

amount

string

必填

总费用，单位为 1/10000 元。

voucherAmount

string

必填

代金券抵扣费用，单位为 1/10000 元。

payAmount

string

必填

现金支付费用，单位为 1/10000 元。

payAmountDisplay

float

必填

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

pricePrecision

int32

必填

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

llmSeries

string

大语言模型系列。

requestCount

string

请求次数。

multimodalPricing

object

多模态模型计费明细。

tieredConfig

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>"
    }
  ]
}

查询账户余额明细查询包月账单列表

Documentation Index

​请求头

​查询参数

​响应参数

请求头

查询参数

响应参数