Usage and spend
ideogram_usageRetrieve billed Ideogram API usage by day or hour, broken down by product, endpoint, cost, and units, then save the buckets to a file for cost analysis. Requires an organization admin API key.
Instructions
Your organization's billed API usage as Ideogram reports it: dense time buckets of line items (product, endpoint, cost, units, the redacted API key), summed per product, unit and currency here, the buckets written unchanged to a file in the output directory (the shape ai-cost reads; printed too when small). Default: the last 7 days by day. Needs an API key whose owner is an organization admin. Reads only.
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": "ideogram_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sources | No | api (API requests), app (web-app usage) or both; default both | |
| end_time | No | End of the range, exclusive, RFC 3339; default now | |
| start_time | No | Start of the range, RFC 3339 (e.g. 2026-10-01T00:00:00Z); default 7 days (1d) or 24 hours (1h) before the end | |
| bucket_width | No | 1d (a range of at most 92 days) or 1h (at most 168 hours); default 1d |