外观
用量与账单
用量记录用于回答三个问题：什么时间发生了调用、哪个 Key 或模型产生了调用、最终如何结算。控制台的页面名称和字段会随版本变化，以下内容以核对思路为主。
查看记录
登录 FlashCoding.AI 控制台，在用量、消费或账单相关页面查看数据。常见字段可能包括：
| 字段 | 用途 |
|---|---|
| 时间 | 对照应用日志和故障时间段 |
| API Key 标识 | 区分项目或环境，通常不会展示完整 Key |
| 模型 | 确认实际请求的模型 ID |
| 输入与输出用量 | 分析提示词和回答长度 |
| 其他用量 | 缓存、图片、音频等模型特有单位 |
| 金额或余额变化 | 核对最终结算 |
| 状态 | 区分成功、失败或处理中（若提供） |
具体字段、统计延迟和时间范围以控制台实际页面为准。
为什么用量不等于字符数
文本模型通常按 token 或模型定义的单位计算，而不是按汉字、单词或请求次数简单计数。最终用量还可能受到以下因素影响：
- 系统提示词和历史消息同样属于输入。
- 工具定义、结构化输出约束和多模态内容会增加输入。
- 流式输出只改变传输方式，不一定改变计费方式。
- 缓存输入、推理相关用量或其他特殊字段可能单独统计。
- 不同模型的分词与计费规则不同。
因此，SDK 在本地估算出的 token 数可用于预警，但结算应以 FlashCoding.AI 控制台记录为准。
核对一笔请求
建议在自己的应用日志中为每次调用生成业务请求 ID，并记录：
text
时间（含时区）
业务请求 ID
使用的 Key 别名（不是完整 Key）
模型 ID 与接口路径
HTTP 状态码与耗时
SDK 返回的用量字段（若有）
是否发生重试1
2
3
4
5
6
7
2
3
4
5
6
7
然后按时间、模型和 Key 标识在控制台查找对应记录。响应头中如果包含平台请求标识，也应一并保存，但不要假定每个协议都使用相同的请求头名称。
常见差异来源
应用统计少于控制台
- SDK 或业务层在失败后自动重试，而日志只记录了最终一次。
- 多个环境共用了同一个 Key。
- 流式连接断开后，调用已经在上游产生用量。
- 后台任务、第三方客户端或泄露的 Key 仍在调用。
应用统计多于控制台
- 控制台统计尚未完成刷新。
- 应用在发送前就计数，但请求实际未到达服务端。
- 本地估算规则与模型的实际计量规则不同。
- 查询的时间范围、时区、Key 或分组不一致。
金额与简单估算不同
- 使用了不同模型、渠道或分组。
- 输入、输出和其他用量采用不同单价或单位。
- 价格发生过调整，估算使用了旧数据。
- 存在套餐、赠送额度、倍率或其他当前结算规则。
不要从单条响应反推长期固定价格。请对照请求发生时控制台展示的规则。
建立成本监控
平台记录适合结算核对，应用仍应维护自己的运行监控：
- 为开发、测试、生产和不同业务使用独立 Key。
- 统计每分钟请求数、错误率、延迟与重试次数。
- 按模型、功能和租户聚合 SDK 返回的用量。
- 对异常增长设置告警，并准备快速停用 Key 的流程。
- 定期将内部汇总与控制台数据核对。
若控制台提供下载或导出功能，可以使用其导出结果做周期对账；若没有，不要依赖未公开的页面接口抓取数据。
发现异常用量
- 暂停相关服务或撤销可疑 Key，防止用量继续增长。
- 检查代码仓库、构建产物、前端网络请求和日志中是否泄露密钥。
- 查看部署历史、访问日志和最近新增的客户端。
- 保存异常记录的时间、模型、Key 标识和金额变化。
- 通过官方渠道联系支持，同时说明已经采取的处置措施。
撤销 Key 后，使用它的程序会立即或随后出现鉴权失败。先创建替代 Key、更新受控服务，再按风险决定旧 Key 的撤销顺序。
隐私与留存
对账日志只保留定位问题所需的信息。不要记录完整 API Key、账户密码或不必要的提示词正文；涉及终端用户数据时，还应遵循你的隐私政策和适用要求。