用量追踪

通过控制台或 API 追踪你的使用情况，按 API Key、模型、日期等维度分析 Token 用量和费用。支持数据导出，方便集成到自有的成本管理系统。

控制台用量查看

在控制台的 Usage 页面可以查看：

总用量概览：请求数、Token 数、费用的汇总统计
按 Key 分析：每个 API Key 的独立用量和费用
按模型分析：每个模型的调用次数和 Token 消耗
按日趋势：每天的用量折线图
导出功能：导出 CSV 或 JSON 格式的详细数据

API 查询用量

通过 API 查询用量数据，方便集成到自有系统：

查询用量 APIBash

# 通过 API 查询用量数据
curl "https://www.ulovegpt.com/v1/usage?start_date=2025-01-01&end_date=2025-01-31" \
  -H "Authorization: Bearer <你的 API_KEY>"

# 按模型筛选
curl "https://www.ulovegpt.com/v1/usage?start_date=2025-01-01&end_date=2025-01-31&model=openai/gpt-5.4-mini" \
  -H "Authorization: Bearer <你的 API_KEY>"

# 按 API Key 筛选
curl "https://www.ulovegpt.com/v1/usage?start_date=2025-01-01&end_date=2025-01-31&api_key=sk-of-xxx" \
  -H "Authorization: Bearer <你的 API_KEY>"

# 按天分组
curl "https://www.ulovegpt.com/v1/usage?start_date=2025-01-01&end_date=2025-01-31&group_by=day" \
  -H "Authorization: Bearer <你的 API_KEY>"

响应格式

用量数据响应Json

{
  "data": [
    {
      "date": "2025-01-15",
      "model": "openai/gpt-5.4-mini",
      "api_key": "sk-of-xxx",
      "requests": 1250,
      "input_tokens": 156000,
      "output_tokens": 48500,
      "cache_read_tokens": 120000,
      "cache_write_tokens": 0,
      "cost_usd": 0.85
    }
  ],
  "total": {
    "requests": 1250,
    "input_tokens": 156000,
    "output_tokens": 48500,
    "cost_usd": 0.85
  }
}

查询参数

参数	类型	说明
`start_date`	string	起始日期，格式 YYYY-MM-DD（必填）
`end_date`	string	结束日期，格式 YYYY-MM-DD（必填）
`model`	string	筛选特定模型
`api_key`	string	筛选特定 API Key
`group_by`	string	分组维度：day / model / api_key

数据导出

控制台支持以下导出方式：

CSV 导出：适合导入 Excel 或 Google Sheets
JSON 导出：适合程序处理和系统集成
定时导出：设置每月自动导出到邮箱

最佳实践

不同 Key 区分环境：开发、测试、生产使用不同 Key 便于追踪
定期审查：每周检查用量趋势，发现异常消耗
设置告警：用量异常时及时通知
缓存优化：关注 cache_read_tokens 占比，提升缓存命中率

← 控制台总览

计费说明 →

了解 Token 定价和计费模型