> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 余额与用量

> 查询余额、消耗记录和账单对账

余额与用量页用于帮助用户确认：还剩多少额度、每次请求消耗多少、失败请求是否返还、支付订单是否到账。

## 控制台里看什么

| 区域   | 用途                        |
| ---- | ------------------------- |
| 余额   | 当前可用额度                    |
| 已用额度 | 历史成功结算消耗                  |
| 请求次数 | 已记录的 API 请求数量             |
| 用量日志 | 按请求查看模型、消耗、耗时和 request id |
| 充值记录 | 查看近期订单号、支付金额、状态和完成时间      |

普通用户的充值记录主要用于近期排障和对账；长期财务归档建议保存自己的支付凭证、订单号和业务流水。支付成功但余额未到账时，优先在 `/wallet` 里提交订单申诉。

## 用量日志字段

| 字段                         | 用途        |
| -------------------------- | --------- |
| 请求时间                       | 对账定位      |
| `request_id`               | 联系支持时定位请求 |
| 模型名                        | 不同模型价格不同  |
| API Key / Token            | 区分项目或业务线  |
| `quota`                    | 本次最终结算额度  |
| prompt / completion tokens | 文本模型对账    |
| 耗时                         | 排查慢请求     |
| HTTP 状态码和错误信息              | 区分失败类型    |

<Note>用户侧日志会隐藏部分上游渠道身份字段。对外排障时通常不需要上游渠道名称，保留 request id、模型名、时间和错误信息即可。</Note>

## 你需要记录

| 字段                        | 用途              |
| ------------------------- | --------------- |
| 请求时间                      | 对账定位            |
| 模型名                       | 不同模型价格不同        |
| 业务 task\_id               | 和自己系统关联         |
| HTTP 状态码                  | 判断失败类型          |
| 平台请求 ID                   | 联系支持时定位         |
| `error.code`              | 判断余额、参数、限流和上游异常 |
| 请求 `n` 和返回 `data.length`  | 图片接口对账          |
| `metadata.tapapi_partial` | 判断图片批量是否部分成功    |
| 视频 `task_id` 和最终状态        | 视频任务对账          |
| 保存状态                      | 区分生成失败和转存失败     |

## 对账方法

| 类型   | 看什么                                            |
| ---- | ---------------------------------------------- |
| 文本请求 | 模型名、prompt tokens、completion tokens、最终 `quota` |
| 图片请求 | 模型名、请求 `n`、返回 `data.length`、最终 `quota`         |
| 批量任务 | 每个业务 `task_id` 一行记录，不要只看总数                     |
| 失败请求 | HTTP 状态码、`error.code`、是否产生有效结果                 |
| 充值到账 | 充值订单状态、订单号、余额变化                                |

推荐业务侧保存一张对账表：

```text theme={null}
task_id | request_id | model | status | error_code | requested_n | returned_count | saved_count | quota | created_at
```

API 响应头里的 `X-Oneapi-Request-Id` 和控制台用量日志里的 `request_id` 是同一类排障线索。业务侧建议原样保存，不要自己重新生成后覆盖。

## 异常怎么判断

| 现象         | 先看                              |
| ---------- | ------------------------------- |
| 余额不足       | `403 + insufficient_user_quota` |
| 支付成功但余额未增加 | 充值订单状态和订单号                      |
| 觉得被扣错费     | 用量日志里的 `quota` 和业务记录            |
| 图片生成成功但没保存 | 输出保存链路，不等于模型失败                  |
| 请求超时       | 业务任务状态、用量日志和最终余额                |
| 找不到上游细节    | 用户侧日志会隐藏上游身份，带 request id 找支持   |

## API 问题模板

```text theme={null}
账户：
请求时间：
模型：
request_id：
业务 task_id：
HTTP 状态码：
error.code：
请求参数摘要：
返回图片数 / token 用量：
控制台用量截图：
支付订单号（如有）：
```

## 充值问题模板

```text theme={null}
账户：
支付时间：
充值订单号：
支付方式：
支付金额：
控制台订单状态：
当前余额截图：
支付成功截图：
是否重复支付：
```

更多支持入口见 [联系支持](/support/contact)。