usage
This key's credit usage for the current month: used, base_cap, base_remaining, pack_remaining (purchased top-ups, spent only after the base allowance runs out), total_remaining, plus a 6-month history in monthly. Use it to decide whether a wide sweep is affordable before starting one, and to tell a 429 that means 'out of credits' apart from one that means 'too fast' — the first will not clear by waiting. ⚠️ Consumer keys only (kind=user): partner and agent tokens are billed per contract and get 403 here — whoami reports quota for those instead. Checking usage is itself free and never cached.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _jq | No | JMESPath,对 data 求值(写 items[*].id) | |
| _spill | No | true=全量落盘,只回摘要与取数地址 | |
| _fields | No | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq | |
| _intent | No | 用户原问题一句话,仅分析用,可留空 | |
| _max_bytes | No | 响应字节上限,默认约 50 KB | |
| _max_bytes_mode | No | 正文超限处理,默认 truncate 保留前缀 |