导出 Usage 使用明细
Usage 明细用于成本核对、项目分摊、异常排查和企业对账。建议生产业务定期导出并归档。
常见用途
- 按 API Key 统计费用。
- 按模型统计请求量。
- 核对某个时间段的 Token 消耗。
- 排查异常高费用请求。
- 为企业内部项目做成本分摊。
查询维度
| 字段 | 说明 |
|---|---|
| 请求 ID | 单次请求的唯一标识 |
| 时间 | 请求创建时间 |
| API Key | 调用来源 |
| 模型 ID | 实际调用模型 |
| 输入 Token | 请求输入消耗 |
| 输出 Token | 模型输出消耗 |
| 费用 | 本次请求费用 |
| 状态 | 成功、失败、超时等 |
API 示例
实际接口路径以控制台开放能力为准。下面是常见设计示例：
GET /v1/usage?start_time=1784044800&end_time=1784131200
Authorization: Bearer sk-your-dinghui-key
curl "https://www.tophdd.cn/v1/usage?start_time=1784044800&end_time=1784131200" \
-H "Authorization: Bearer sk-your-dinghui-key"
示例响应：
{
"start_time": 1784044800,
"end_time": 1784131200,
"requests": 86,
"input_tokens": 120000,
"output_tokens": 32000,
"total_amount": {
"value": "1.280000",
"currency": "CNY"
}
}
导出建议
- 查询时间范围不要过大，按天或按周导出。
- 用同一个时区做对账。
- 保存原始导出文件，避免后续价格变化影响历史核算。
- 对企业客户，建议按 Key 命名规则关联项目或团队。
异常排查
| 现象 | 处理 |
|---|---|
| 某个 Key 费用突增 | 先停用 Key，再查来源工具 |
| 输出 Token 异常高 | 检查 Prompt 是否要求长篇输出 |
| 输入 Token 异常高 | 检查 Agent 是否读取了大量文件 |
| 失败请求很多 | 按错误码定位配置或上游问题 |