AI Logs AI调用日志 模块 API 文档

基础信息

  • Base URL: /api/admin
  • 认证方式: JWT Bearer Token

数据库表

  • api_usage_logs — AI 调用日志表
  • users — 用户表

接口列表

1. 获取 AI 日志统计

GET /api/admin/api-logs/stats

响应:

{
  "calls": 1234,
  "tokens": 567890
}

2. 获取 AI 日志每日统计

GET /api/admin/api-logs/daily-stats

说明: 获取最近30天每日调用量和 token 消耗

响应:

[{
  "date": "2024-01-01",
  "calls": 45,
  "prompt_tokens": 1234,
  "completion_tokens": 567,
  "total_tokens": 1801
}]

3. 获取 AI 日志列表(分页)

GET /api/admin/api-logs

Query 参数:

参数类型必填说明
pagenumber选填页码(默认1)
limitnumber选填每页条数(默认30)

响应:

{
  "logs": [{
    "id": "string",
    "user_id": "string",
    "user_nickname": "string",
    "model": "string",
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "total_tokens": 150,
    "created_at": "ISO8601"
  }],
  "totalPages": 5,
  "currentPage": 1,
  "stats": {
    "total_calls": 1234,
    "total_tokens": 567890
  }
}
GET/admin/api-logs/public
**说明**:公开接口,供未登录用户查看平台 AI 调用统计(仅系统级日志)。响应包含每日使用量、模型统计、7天趋势。 **响应**:
{
  logs: [...],
  totalPages: number,
  stats: {
    total_calls: number,
    daily_used: number,
    daily_limit: number,
    user_daily_limit: number
  },
  modelStats: [{model, calls}],
  dailyTrend: [{date, tokens}]
}