数据统计

数据统计接口用于查询 API 使用统计和账单数据。

接口地址

GET https://ai-tokenhub.com/v1/statistics/usage
GET https://ai-tokenhub.com/v1/statistics/cost
GET https://ai-tokenhub.com/v1/statistics/models

查询参数

参数	类型	说明
start_date	string	开始日期 (YYYY-MM-DD)
end_date	string	结束日期 (YYYY-MM-DD)
group_by	string	分组方式 (day/month/model)
api_key_id	string	API Key ID (可选)

使用量统计

curl "https://ai-tokenhub.com/v1/statistics/usage?start_date=2024-01-01&end_date=2024-01-31&group_by=day" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "object": "usage",
  "data": [
    {
      "date": "2024-01-01",
      "total_tokens": 150000,
      "prompt_tokens": 100000,
      "completion_tokens": 50000,
      "request_count": 500,
      "avg_latency": 1200
    }
  ],
  "summary": {
    "total_tokens": 4500000,
    "prompt_tokens": 3000000,
    "completion_tokens": 1500000,
    "request_count": 15000
  }
}

成本统计

curl "https://ai-tokenhub.com/v1/statistics/cost?start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "object": "cost",
  "data": [
    {
      "date": "2024-01-01",
      "input_cost": 15.00,
      "output_cost": 7.50,
      "total_cost": 22.50
    }
  ],
  "summary": {
    "total_input_cost": 450.00,
    "total_output_cost": 225.00,
    "total_cost": 675.00
  }
}

模型使用统计

curl "https://ai-tokenhub.com/v1/statistics/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "object": "model_usage",
  "data": [
    {
      "model": "gpt-4o",
      "request_count": 10000,
      "total_tokens": 2000000,
      "cost": 300.00,
      "percentage": 45.5
    },
    {
      "model": "gpt-4o-mini",
      "request_count": 20000,
      "total_tokens": 1500000,
      "cost": 75.00,
      "percentage": 11.4
    }
  ]
}

导出报表

curl "https://ai-tokenhub.com/v1/statistics/export?format=csv&start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o report.csv