用途:Venice 的只读计费与用量分析接口,用于查询账户余额、逐请求用量明细和聚合统计。
主要能力:GET /billing/balance 返回 canConsume、consumptionCurrency、各币种余额(DIEM、USD、bundledCredits、earnedCredits)及 diemEpochAllocation。GET /billing/usage-history 返回逐请求账本,支持游标分页,可输出 JSON 或 CSV。GET /billing/usage-analytics 返回按日期、模型、API 密钥的聚合数据,标注为 Beta。GET /billing/usage 已停用,2026-09-16 起对所有请求返回 410。
使用方式:三个在用接口都需 Bearer ADMIN 密钥,INFERENCE 密钥返回 401;不接受 x402 钱包认证。usage-history 使用 startTimestamp/endTimestamp(ISO 8601 UTC,含 Z)与 pageSize(10–1000),续页时仅传 cursor;usage-analytics 使用 lookback=Nd 或 startDate/endDate(YYYY-MM-DD,最多 90 天)。CSV 模式用 Accept: text/csv,续页令牌在 x-next-cursor 响应头。
限制:计费按 DIEM、EARNED_CREDITS、BUNDLED_CREDITS、USD 顺序扣费;VCU 不再作为可消费币种。analytics 缓存 10 分钟,且不含 EARNED_CREDITS 支出。一次推理可能产生多行账本,需按 requestId 去重后再汇总 token。钱包余额请改用 venice-x402。