逐条明细

逐条明细（L2）提供单次请求级别的用量明细，用于精确对账与异常排查。宁享Token 提供多种协议兼容端点，均支持 cursor 分页。

所有端点使用 TokenAuth 鉴权，按 API Key 隔离。

Base URL

/  （部署域名，例如 https://your-domain.com）

nxtoken 原生：用量明细

GET/v1/billing/usage/detail

获取当前 API Key 的逐条用量明细，支持 cursor 分页与多维度过滤。

Bearer Token

请求参数

请求参数

参数	类型	必填	默认值	描述
start_date	string	是	-	起始日期，格式 YYYY-MM-DD
end_date	string	是	-	结束日期，格式 YYYY-MM-DD
model	string	否	-	按模型名过滤
modality	string	否	-	模态过滤：text / image / audio
limit	integer	否	20	每页条数，1-100
cursor	string	否	-	分页游标，首次请求不传

请求示例

curl "/v1/billing/usage/detail?start_date=2025-01-01&end_date=2025-01-31&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "/v1/billing/usage/detail",
    params={
        "start_date": "2025-01-01",
        "end_date": "2025-01-31",
        "limit": 20,
    },
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())

响应示例

成功响应

{
  "data": [
    {
      "request_id": "req_abc123",
      "timestamp": 1735689600,
      "model": "glm-5.2",
      "modality": "text",
      "input_tokens": 1000,
      "output_tokens": 250,
      "total_tokens": 1250,
      "cost": 0.0125,
      "currency": "CNY"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJjdXJzb3IiOiJuZXh0In0="
}

分页说明

• 首次请求不传 cursor。
• 响应中 has_more 为 true 时，使用 next_cursor 作为下一次请求的 cursor 参数。
• 当 has_more 为 false 时，已到最后一页。

OpenAI 兼容：补全用量明细

GET/v1/usage/completions

OpenAI 兼容端点，返回补全请求级别的用量明细，支持 cursor 分页。

Bearer Token

请求参数

请求参数

参数	类型	必填	默认值	描述
start_time	string	是	-	起始时间，Unix 秒
limit	integer	否	20	每页条数，1-100
after	string	否	-	分页游标（对应 OpenAI after）

请求示例

curl "/v1/usage/completions?start_time=1735689600&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

成功响应

{
  "object": "list",
  "data": [
    {
      "request_id": "req_abc123",
      "created_at": 1735689600,
      "model": "glm-5.2",
      "input_tokens": 1000,
      "output_tokens": 250
    }
  ],
  "has_more": true,
  "first_id": "req_abc123",
  "last_id": "req_abc123"
}

可灵兼容：账单包查询

POST/account/billing/package

可灵兼容端点，返回可灵原生账单包结构。使用 POST 方法。

Bearer Token

请求头

Content-Type: application/json

请求参数

请求参数

参数	类型	必填	默认值	描述
page	integer	否	1	页码，从 1 开始
page_size	integer	否	20	每页条数
model	string	否	-	按模型名过滤

请求示例

curl -X POST "/account/billing/package" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page": 1, "page_size": 20}'

响应示例

成功响应

{
  "data": [
    {
      "deduction_time": "2025-01-01 10:00:00",
      "model_name": "kling-3.0",
      "amount": 0.5,
      "task_id": "req_abc123",
      "amount_micro": 500000
    }
  ],
  "total": 100
}

火山兼容：账单明细列表

GET/ListBillDetail

火山引擎兼容端点，返回火山原生账单明细结构。

Bearer Token

请求参数

请求参数

参数	类型	必填	默认值	描述
BillDate	string	是	-	账单日期，格式 YYYY-MM-DD
PageNum	integer	否	1	页码，从 1 开始
PageSize	integer	否	20	每页条数
Product	string	否	-	按产品名过滤

请求示例

curl "/ListBillDetail?BillDate=2025-01-01&PageNum=1&PageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

成功响应

{
  "Result": {
    "BillList": [
      {
        "Product": "glm-5.2",
        "BillCategory": "消费-使用",
        "ExpenseTime": "2025-01-01 00:00:00"
      }
    ],
    "Total": 100
  }
}

相关文档

• 对账 API 概览
• 余额查询
• 用量汇总
• 厂商兼容端点总表