> ## Documentation Index > Fetch the complete documentation index at: https://tennda.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 账单查询 > 按账单日拉取消费明细与日汇总，便于 TenndaAI 对账、成本分析与账单采集 ## 简介 开放两套只读账单接口：按日汇总看净额走势，按明细落到「模型 × Token 类型」。金额统一 `USD`，计费时区 `utc+8`，数据为 **T+1**。 `getDailyList`：粒度 `(账单日 × 账号 × 模型 × Token 类型)`，单次查询跨度 ≤ **92 天**，`pageSize` 上限 100。 `getDailySummary`：粒度 `(账单日 × 账号)`，单次查询跨度 ≤ **366 天**，`pageSize` 上限 400。 ## 接口一览 | 接口 | 方法 / 路径 | 用途 | | ---- | ---------------------------------- | --------- | | 消费明细 | `GET /api/logs/v2/getDailyList` | 明细对账、成本拆分 | | 日汇总 | `GET /api/logs/v2/getDailySummary` | 日趋势、月报概览 | | 项 | 值 | | -------- | ----------------------------------- | | Base URL | `https://client.tennda.ai/prod-api` | | 格式 / 编码 | `application/json` · `UTF-8` | | 协议 | `HTTPS` | | 币种 / 时区 | `USD` · `utc+8` | ## 鉴权 请求头携带 Bearer 凭证，以下两种任选其一： ```http theme={null} Authorization: Bearer Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx ``` | 凭证类型 | 说明 | | ------------------------------------------------------ | ---------------- | | [系统访问令牌](https://client.tennda.ai/#/profile?tab=token) | 控制台「个人中心 - 访问令牌」 | | [API Key](/cn/interface-module/token-management) | 通常以 `sk-` 开头 | 鉴权失败：HTTP `401`，业务码 `40100`。 完整 Key 勿写入 URL、前端、日志或工单。 ## 通用响应 ```json theme={null} { "code": 0, "message": "success", "data": { "total": 128, "rows": [] } } ``` | 字段 | 类型 | 说明 | | ------------ | ------------- | --------------- | | `code` | integer | `0` 成功，非 `0` 失败 | | `message` | string | 提示信息 | | `data` | object / null | 业务体；失败时为 `null` | | `data.total` | integer | 满足条件的总条数（分页用） | | `data.rows` | array | 当前页数据 | ### 业务错误码 | code | HTTP | 说明 | | ----: | ---: | -------------------- | | 0 | 200 | 成功 | | 40001 | 400 | 参数格式错误（日期非法、分页非正整数等） | | 40002 | 400 | 缺少必填参数 | | 40003 | 400 | 日期区间非法（起止颠倒或超跨度上限） | | 40100 | 401 | Token 缺失、无效或过期 | | 50000 | 500 | 服务器内部错误 | *** ## 消费明细 · getDailyList ``` GET https://client.tennda.ai/prod-api/api/logs/v2/getDailyList ``` 返回按 `(账单日 × 账号 × 模型 × Token 类型)` 拆分的消费行。 ### 请求参数 开始日期，`yyyy-MM-dd` 结束日期，`yyyy-MM-dd`；与 `startDate` 跨度不超过 **92 天** 按账号 ID 筛选。多子账号可见需开通「企业管理」，见[约定](#约定)；不传则返回当前凭证可见账号 按账号名精确筛选（企业管理规则同上）；不传则返回当前凭证可见账号 正整数字符串，`1 ~ 100`；超过 100 按 100 正整数字符串，从 `1` 起 分页单位是「明细行」；`data.total` 为明细总条数。 ### 响应字段（`data.rows[]`） | 字段 | 类型 | 说明 | | ----------------------- | ------ | ------------------------------------------------------------------------------------------------- | | `billMonth` | string | 账单月，`yyyyMM` | | `billDay` | string | 账单日，`yyyy-MM-dd` | | `billingDateTimezone` | string | 固定 `utc+8` | | `account` | string | 账号名 | | `modelType` | string | 模型分类，如 `claude`、`gpt`、`gemini` | | `modelName` | string | 模型名称 | | `tokenType` | string | Token 类型，见下表 | | `tokenCount` | string | 该类型 Token 数量（整数字符串） | | `tokenUnit` | string | 固定 `million`（按百万 Token 计价） | | `currency` | string | 固定 `USD` | | `subtotalBeforeTax` | string | 折前税前金额（8 位小数） | | `subtotalAfterDiscount` | string | 折后税前金额（8 位小数） | | `totalAmountAfterTax` | string | 折后税后金额（8 位小数） | | `price` | string | 每百万 Token 折前单价（8 位小数）。`subtotalBeforeTax = price × tokenCount ÷ 1,000,000`；`tokenCount` 为 0 时可能省略 | | `entryType` | string | `normal` 表示正常消费 | ### `tokenType` | 值 | 含义 | | ---------------------------------------- | -------------- | | `textInputTokens` | 文本输入 | | `textOutputTokens` | 文本输出 | | `reasoningTokens` | 推理 / 思考 | | `cacheCreationTokens5m` | 缓存创建（5 分钟 TTL） | | `cacheCreationTokens1h` | 缓存创建（1 小时 TTL） | | `cacheTokens` | 缓存命中（读取） | | `imageInputTokens` / `imageOutputTokens` | 图片输入 / 输出 | | `audioInputTokens` / `audioOutputTokens` | 音频输入 / 输出 | | `videoInputTokens` / `videoOutputTokens` | 视频输入 / 输出 | 排序：`billDay` 降序，再按 `account`、`modelName`、`tokenType`、`currency` 升序。 ### 请求示例 ```bash theme={null} curl "https://client.tennda.ai/prod-api/api/logs/v2/getDailyList?startDate=2026-07-27&endDate=2026-07-27&pageSize=100&pageNum=1" \ -H "Authorization: Bearer " ``` ### 响应示例 ```json theme={null} { "code": 0, "message": "success", "data": { "total": 23, "rows": [ { "billMonth": "202607", "billDay": "2026-07-27", "billingDateTimezone": "utc+8", "account": "your_account", "modelType": "claude", "modelName": "claude-opus-4-8", "tokenType": "textOutputTokens", "tokenCount": "2931", "tokenUnit": "million", "currency": "USD", "subtotalBeforeTax": "0.07327564", "subtotalAfterDiscount": "0.07327564", "totalAmountAfterTax": "0.07327564", "price": "25.00021836", "entryType": "normal" } ] } } ``` *** ## 日汇总 · getDailySummary ``` GET https://client.tennda.ai/prod-api/api/logs/v2/getDailySummary ``` 按天返回消费净额，响应更轻，适合账单总览与趋势报表。 ### 请求参数 开始日期，`yyyy-MM-dd` 结束日期，`yyyy-MM-dd`；与 `startDate` 跨度不超过 **366 天** 按账号 ID 筛选（企业管理规则同明细接口） 按账号名精确筛选（企业管理规则同明细接口） 正整数字符串，`1 ~ 400`；超过 400 按 400 正整数字符串，从 `1` 起 分页单位是「账单日 × 账号」；`data.total` 为组合总数。 ### 响应字段（`data.rows[]`） | 字段 | 类型 | 说明 | | ----------------------- | ------ | ---------------- | | `billMonth` | string | 账单月，`yyyyMM` | | `billDay` | string | 账单日，`yyyy-MM-dd` | | `billingDateTimezone` | string | 固定 `utc+8` | | `account` | string | 账号名 | | `currency` | string | 固定 `USD` | | `subtotalBeforeTax` | string | 当日折前税前净额（8 位小数） | | `subtotalAfterDiscount` | string | 当日折后税前净额（8 位小数） | | `totalAmountAfterTax` | string | 当日折后税后净额（8 位小数） | 排序：`billDay` 降序，再按 `account` 升序。 ### 请求示例 ```bash theme={null} curl "https://client.tennda.ai/prod-api/api/logs/v2/getDailySummary?startDate=2026-07-01&endDate=2026-07-27&pageSize=31&pageNum=1" \ -H "Authorization: Bearer " ``` ### 响应示例 ```json theme={null} { "code": 0, "message": "success", "data": { "total": 2, "rows": [ { "billMonth": "202607", "billDay": "2026-07-27", "billingDateTimezone": "utc+8", "account": "your_account", "currency": "USD", "subtotalBeforeTax": "0.26569400", "subtotalAfterDiscount": "0.26569400", "totalAmountAfterTax": "0.26569400" } ] } } ``` *** ## 约定 1. **金额**：一律 `string`，保留 8 位小数，请用 Decimal / BigDecimal，勿转二进制浮点。 2. **一致性**：同一账单日、同一账号下，日汇总各金额 = 当日明细对应字段之和（需跨页累加）。 3. **零消费**：区间内无消费的日期不返回。 4. **时效**：账单 **T+1**，最新一日次日可查。 5. **账号范围**：默认仅本账号。开通「**企业管理**」的主账号可查全部子账号——不传 `userId` / `userName` 返回全部，传入则筛选；子账号凭证仅能查自己。开通请联系 TenndaAI 管理员。 6. **越界页**：`pageNum` 超出总页数时 `rows` 为空，`total` 仍为真实总数。