余额与用量 - Tapapi 文档

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

控制台里看什么

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

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

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

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

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 找支持

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

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

更多支持入口见联系支持。