用量与费用 API

团队费用报表使用 Admin API Basic auth。日汇总、当前账期支出和细粒度事件的字段与单位不同，不把请求数、模型估算和实际收费混为同一指标。

三个主要入口

方法与路径	目的
POST /teams/daily-usage-data	指定日期范围的每日活动
POST /teams/spend	当前账单周期支出
POST /teams/filtered-usage-events	过滤用量、token 和收费事件

日数据要求 startDate/endDate 为 epoch 毫秒，最多 30 天；不传分页只返回活跃用户。同时传 page/pageSize 才包含期间有成员资格的所有用户，并返回 isActive；请求期间以后才加入的人不会出现。该接口每分钟 20 次。

细粒度事件每分钟 60 次。两种用量接口按小时聚合，官方建议最多每小时拉取一次。

支出单位与对账

spendCents 是 on-demand，overallSpendCents 包含套餐内和 on-demand，单位为 cents，可能含小数精度。limit 字段使用 dollars；hardLimitOverrideDollars 的 0 表示无该 override，不要把它套到写入接口 spendLimitDollars 的零额度语义。

细粒度事件对账应累加 chargedCents；它包含适用时的模型费和 Cursor Token Rate。tokenUsage.totalCents 仅是模型成本，cursorTokenFee 仅在适用第三方模型请求时出现。

daily-usage-data 的 subscriptionIncludedReqs、usageBasedReqs、apiKeyReqs 统计原始事件，不是旧 request-based 套餐的计费请求单位；后者应汇总 filtered-usage-events 的 requestsCosts。

时间窗口与分页

filtered-usage-events 的 startDate/endDate 都是包含边界的 epoch 毫秒。分日导入时，上一天结束设为 23:59:59.999，避免与次日 00:00:00.000 重叠。page 从 1，pageSize 默认 100、最大 1000。

事件 timestamp 返回毫秒字符串，别误按秒解析。conversationId、serviceAccountId、cloudAgentId、automationId 只在适用时出现；可用 conversationId 联到代码归属信息。

筛选自托管与自动化

可按 email/userId、serviceAccountId、cloudAgentId、automationId 过滤，多个条件取 AND。cloudAgentId/automationId 的 * 表示所有相应任务。

hostingType 可为 CLOUD、SELF_HOSTED、SELF_HOSTED_POOL、SELF_HOSTED_MACHINE；未知值返回 400，不是零结果。该筛选只计算推理费用，自托管计算资源在用户机器运行，不由 Cursor 计量。