用途:从运行中的 LiteLLM 代理查询每日活动和花费数据,支持按整体、用户、团队、组织、标签或作业查看用量。
主要能力:可查询整体花费、整体请求与 token 量、按团队、按组织、按用户、按标签或作业的每日活动,以及按标签统计的 top 花费。作业成本归因依赖请求标签,建议为作业请求打稳定标签(如 job:<作业名>),再通过标签接口查询。
使用方式:需提供 LITELLM_BASE_URL(如 https://my-proxy.example.com)和 LITELLM_API_KEY(代理管理员密钥)。需询问查看维度、日期范围(未给则默认当月)、可选的模型筛选和作业标签。常用接口包括 /user/daily/activity、/global/activity、/team/daily/activity、/organization/daily/activity、/tag/daily/activity 和 /global/spend/tags。请求使用 curl 携带 Authorization: Bearer $KEY。可用 python3 对返回 JSON 做汇总,输出 Date | Requests | Tokens | Spend 表格并显示合计、标出失败请求大于 0 的日期。
限制:返回 JSON 顶层键是 results;401/403 表示密钥无效或过期;404 表示端点不可用或代理版本不支持;结果为空表示该日期范围无活动。分页信息在 metadata 中,若 total_pages 大于 1 需另行获取剩余页。