开发文档
用量查询 API
从外部读取计费与聚合数据,用于对接企业内部 BI 或成本看板。
只读密钥
访问必须使用用量查询密钥,而非服务密钥。每个组织最多三个,且必须设置 IP 白名单。
路径
按日聚合与按请求列表分别提供。按日聚合会附带路由决策摘要。
| Method | Path | Returns |
|---|---|---|
| GET | /usage/daily | Daily totals and routing summary |
| GET | /usage/requests | Per-request records |
| GET | /usage/keys | Totals grouped by key |
分页
采用游标方式。next_cursor 为空即表示结束。单页最多 1000 条。
数据延迟
聚合最多延迟 5 分钟。若需实时拦截,请改用密钥预算功能。