GET/v1/billing/details

查询费用明细

当前查询对象为商户维度的费用明细，支持分页和多条件过滤。

基础信息

鉴权	Authorization: Bearer 管理 token
请求类型	none
响应类型	application/json

请求参数

Query

字段

类型

必填

位置

说明

pageNum

integer

否

query

页码。

示例：1

pageSize

integer

否

query

每页数量。

示例：20

startDate

string

否

query

开始日期。

示例："2026-04-01"

endDate

string

否

query

结束日期。

示例："2026-04-13"

billingType

string

否

query

计费类型。

示例："TOKEN"

modelId

string

否

query

模型 ID 过滤。

示例："gpt-4o"

响应示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "rows": [
      {
        "billingTime": "2026-04-13 10:15:00",
        "billingType": "TOKEN",
        "modelId": "gpt-4o",
        "inputTokens": 320,
        "outputTokens": 180,
        "amount": 0.56,
        "balanceChange": -0.56,
        "remark": "chat completion"
      }
    ],
    "total": 1
  }
}

错误码

HTTP	code	说明
401	`unauthorized`	管理开放 API 鉴权失败。
400	`validation_error`	请求参数格式错误或取值不满足约束。
404	`not_found`	目标资源不存在或不属于当前商户。

在线调试

Playground · 浏览器直连网关

查询费用明细

按时间范围与计费类型查询财务明细。

Base URL Token / API Key

pageNum pageSize startDate endDate billingType modelId

json

尚未发起请求。

bash

curl --location --request GET 'https://api.harnmodel.com/v1/billing/details?pageNum=1&pageSize=20&startDate=2026-04-01&endDate=2026-04-13&billingType=TOKEN' \
  --header 'Authorization: Bearer mgmt-token-xxx'

多语言示例

bash

curl --location --request GET 'https://api.harnmodel.com/v1/billing/details?pageNum=1&pageSize=20&startDate=2026-04-01&endDate=2026-04-13&billingType=TOKEN' \
  --header 'Authorization: Bearer mgmt-token-xxx'