1. 模型账单

• Token: 此接口需要 Token 调用，需要先调用登录接口换取 Token。

• 流量限制：每token每秒50次。
• 接口作用：查询模型账单

接口路径

• 公网地址：https://console.casdao.com:9001/casdao/api/v1.0/k8s/bill/query

请求方式

GET 方式

输入说明

请求头

请求头	说明
X-Auth-Token	Token 值

请求体

参数通过 URL Query 传递。

参数	类型	必填	默认值	说明
bill_type	string	是	null	账单类型，只支持 model
start_time	datetime	否	null	开始时间，例如 2026-07-01T00:00:00
end_time	datetime	否	null	结束时间，例如 2026-07-31T23:59:59
search	string	否	null	模糊搜索账单描述或子账号名称
page	integer	否	1	页码，从 1 开始
size	integer	否	20	每页数量，必须大于 0

调用示例

curl

curl -G 'https://console.casdao.com:9001/casdao/api/v1.0/k8s/bill/query' \
  -H 'X-Token: your-token' \
  --data-urlencode 'start_time=2026-08-06 00:00:00' \
  --data-urlencode 'end_time=2026-08-07 23:59:59' \
  --data-urlencode 'bill_type=model' \
  --data-urlencode 'page=1' \
  --data-urlencode 'size=20'

输出说明

字段	类型	说明
v	string	API 版本号
code	integer	业务状态码，200 表示成功
msg	string	返回消息
data	object	返回数据

data 字段

字段	类型	说明
data	array	当前页账单列表
total	integer	符合条件的账单总数
page	integer	当前页码
size	integer	每页数量

账单对象字段

字段	类型	说明
username	string	父账号名称
account_name	string	子账号名称
bill_time	datetime	账单时间
describe	object|null	账单描述，接口会将 JSON 字符串解析为对象
bill_balance	number|string	账单金额
coupon	number|string	优惠券金额
balance_type	string	余额变动类型，例如 扣费、退费

示例

{
  "v": "0.0.2",
  "code": 200,
  "msg": "查询成功",
  "data": {
    "data": [
      {
        "username": "xxx",
        "account_name": "xxx",
        "bill_time": "2026-08-07T16:01:27",
        "describe": "{\"CacheContractUnitPrice\":\"0.06\",\"CacheCreateContractUnitPrice\":\"0.744\",\"CompletionContractUnitPrice\":\"3.57\",\"PromptContractUnitPrice\":\"0.595\",\"cache_tokens\":0,\"completion_tokens\":80,\"created_at\":\"2026-08-07T15:57:22\",\"model_name\":\"gpt-5.6-luna\",\"prompt_tokens\":82248,\"request_id\":\"20260807075716316718734964372cb1r1EhaxY\",\"type\":1}",
        "bill_balance": 0.0,
        "coupon": 0.049224,
        "balance_type": "扣费"
      }
    ],
    "total": 1,
    "page": 1,
    "size": 20
  }
}