跳转到主要内容
GET
/
openapi
/
v1
/
billing
/
bill
/
monthly
/
list
curl --request GET \
  --url 'https://api.ppio.com/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "bills": [
    {
      "userId": "<string>",
      "memberId": "<string>",
      "startTime": "1764547200",
      "endTime": "1767225599",
      "productName": "<string>",
      "productCategory": "gpu",
      "ownerID": "<string>",
      "tradeMode": "monthly",
      "tradeType": "monthly_new_buy",
      "basePrice": "1000000",
      "billNum": "1",
      "amount": "1000000",
      "voucherAmount": "0",
      "payAmount": "1000000",
      "payAmountDisplay": 100,
      "pricePrecision": 1,
      "createTime": "1764547200",
      "cycle": "2025-12",
      "productId": "<string>",
      "billingMethod": 2
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://ppio.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
请求头

​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
查询参数

​
category
string
产品类型。常用值：
  • summary：总账单。
  • gpu：GPU 实例。
  • serverless：Serverless Endpoint。
  • cloud_storage：云存储。
  • local_storage：本地存储。
  • image：镜像。
  • bare_metal：裸金属。
​
productName
string
产品名称，支持模糊匹配。
​
startTime
int64
查询开始时间，秒级 Unix 时间戳。
​
endTime
int64
查询结束时间，秒级 Unix 时间戳。
​
ownerId
string
资源实例 ID。
当前接口不分页，建议单次查询时间范围不超过 31 天。如需拉取更长时间，建议按自然月或自然周分段请求。

​
响应参数

​
bills
object[]
必填
月度账单列表。
curl --request GET \
  --url 'https://api.ppio.com/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "bills": [
    {
      "userId": "<string>",
      "memberId": "<string>",
      "startTime": "1764547200",
      "endTime": "1767225599",
      "productName": "<string>",
      "productCategory": "gpu",
      "ownerID": "<string>",
      "tradeMode": "monthly",
      "tradeType": "monthly_new_buy",
      "basePrice": "1000000",
      "billNum": "1",
      "amount": "1000000",
      "voucherAmount": "0",
      "payAmount": "1000000",
      "payAmountDisplay": 100,
      "pricePrecision": 1,
      "createTime": "1764547200",
      "cycle": "2025-12",
      "productId": "<string>",
      "billingMethod": 2
    }
  ]
}