用量统计
用量统计功能帮助您了解 API 的使用情况和费用消耗。
统计概览
仪表盘
控制台首页显示以下统计信息:
- 账户余额 - 当前可用额度
- 今日消耗 - 今日 API 调用消耗的额度
- 今日调用次数 - 今日 API 调用总次数
- 本月消耗 - 本月 API 调用消耗的额度
趋势图表
显示最近 7 天/30 天的使用趋势:
- 每日消耗额度
- 每日调用次数
- 每日 token 使用量
详细统计
按令牌统计
查看每个令牌的使用情况:
| 令牌名称 | 调用次数 | 消耗额度 | Token 使用 |
|---|---|---|---|
| 生产环境 | 10,000 | $50.00 | 5,000,000 |
| 测试环境 | 1,000 | $5.00 | 500,000 |
| 开发环境 | 500 | $2.50 | 250,000 |
按模型统计
查看每个模型的使用情况:
| 模型 | 调用次数 | 消耗额度 | Token 使用 |
|---|---|---|---|
| gpt-4 | 2,000 | $40.00 | 2,000,000 |
| gpt-3.5-turbo | 8,000 | $16.00 | 8,000,000 |
| claude-3-opus | 500 | $10.00 | 500,000 |
按时间统计
查看不同时间段的使用情况:
- 按小时统计
- 按天统计
- 按周统计
- 按月统计
日志查看
日志列表
查看所有 API 调用的详细记录:
| 时间 | 令牌 | 模型 | 状态 | 耗时 | Token |
|---|---|---|---|---|---|
| 2024-01-01 12:00:00 | 生产环境 | gpt-4 | 成功 | 2.5s | 1,500 |
| 2024-01-01 12:01:00 | 测试环境 | gpt-3.5-turbo | 成功 | 0.8s | 800 |
| 2024-01-01 12:02:00 | 生产环境 | gpt-4 | 失败 | - | 0 |
日志详情
点击日志条目可以查看详细信息:
{
"request_id": "req-xxxxx",
"timestamp": "2024-01-01T12:00:00Z",
"token_name": "生产环境",
"model": "gpt-4",
"status": "success",
"latency": 2.5,
"usage": {
"prompt_tokens": 100,
"completion_tokens": 50,
"total_tokens": 150
},
"cost": 0.015,
"request": {
"messages": [
{"role": "user", "content": "你好"}
]
},
"response": {
"choices": [
{"message": {"content": "你好!有什么可以帮助你的吗?"}}
]
}
}
日志筛选
可以按以下条件筛选日志:
- 时间范围 - 选择开始和结束时间
- 令牌 - 选择特定令牌
- 模型 - 选择特定模型
- 状态 - 成功/失败
- 关键词 - 搜索请求内容
日志导出
可以将日志导出为 CSV 文件:
- 设置筛选条件
- 点击「导出」按钮
- 选择导出字段
- 下载 CSV 文件
费用分析
费用构成
查看费用的构成情况:
- 按模型的费用分布
- 按令牌的费用分布
- 按时间段的费用趋势
费用预测
根据历史使用情况预测未来费用:
- 预计本月费用
- 预计下月费用
- 费用增长趋势
成本优化建议
系统会根据使用情况提供优化建议:
- 推荐更经济的模型
- 识别异常使用模式
- 建议调整限速设置
告警设置
额度告警
设置额度使用告警:
- 余额不足告警 - 余额低于阈值时告警
- 消耗过快告警 - 每日消耗超过阈值时告警
- 异常使用告警 - 使用量突然增加时告警
告警方式
支持以下告警方式:
- 邮件通知
- 短信通知
- Webhook 回调
设置告警
- 进入「设置」→「告警设置」
- 设置告警规则
- 配置通知方式
- 保存设置
使用报告
生成报告
可以生成以下类型的报告:
- 每日使用报告
- 每周使用报告
- 每月使用报告
- 自定义时间段报告
报告内容
报告包含以下内容:
- 使用概览
- 详细统计数据
- 费用分析
- 使用趋势
- 优化建议
导出报告
支持以下格式导出:
- PDF 格式
- Excel 格式
- CSV 格式
API 接口
获取统计数据
GET /api/user/stat
参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| start_date | string | 开始日期 |
| end_date | string | 结束日期 |
| token_id | integer | 令牌 ID |
| model | string | 模型名称 |
响应:
{
"total_requests": 10000,
"total_cost": 100.00,
"total_tokens": 1000000,
"by_model": {
"gpt-4": {
"requests": 2000,
"cost": 40.00,
"tokens": 200000
}
}
}
获取日志列表
GET /api/user/logs
参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| page | integer | 页码 |
| page_size | integer | 每页数量 |
| token_id | integer | 令牌 ID |
| model | string | 模型名称 |
| status | string | 状态 |