get_usage_stats
Retrieve usage statistics for credits, characters, or minutes over a specified time period, with optional breakdowns by voice or model.
Instructions
Get character/credit usage statistics over a time window.
Args: start_unix: window start (unix seconds). Defaults to 30 days ago. end_unix: window end (unix seconds). Defaults to now. metric: one of "credits", "tts_characters", "minutes_used", "request_count". breakdown_type: e.g. "none", "voice", "model", "api_keys". aggregation_interval: "hour", "day", "week", "month", or "cumulative".
Returns usage data as JSON.
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": "get_usage_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metric | No | credits | |
| end_unix | No | ||
| start_unix | No | ||
| breakdown_type | No | none | |
| aggregation_interval | No | day |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |