用量统计

用量统计

获取你的账户或特定 API key 的用量指标。

端点

GET /v1/usage

参数

参数	类型	说明
period	string	today、week、month 或 ISO 日期区间
key_id	string	按特定 API key 过滤（可选）
group_by	string	day、hour、target（可选）

响应

{
  "period": "2026-05-01/2026-05-30",
  "total_requests": 1250000,
  "total_bytes": 53687091200,
  "total_bytes_human": "50 GB",
  "unique_targets": 342,
  "heal_events": 1893,
  "avg_latency_ms": 187,
  "daily": [
    { "date": "2026-05-30", "requests": 45000, "bytes": 1932735283 }
  ]
}