AI usage API

What each reply cost: per-generation model, tokens and credits, an overview across a period, the filters to narrow it, and an export. This is what a charge is made of, so it sits beside billing rather than beside analytics.

Endpoints#

5 operations, each with its parameters, schemas and an example request on its own page.

getExport/api/usage/exportThe usage page and every reply behind it, as a file.
getFilters/api/usage/filtersThe models, agents and channels that have replies in the window.
getGenerations/api/usage/generationsEvery AI reply, newest first: model, tokens, credits, speed, outcome.
getGeneration/api/usage/generations/{message_id}One reply in full: tokens, charge, speed, what it cited and which tools ran.
getOverview/api/usage/overviewTotals, comparison, breakdowns by model/agent/channel, chart, activity.

Authentication#

Every call here needs Authorization: Bearer with a key from the dashboard — Authentication covers keys and scopes.

Something unclear or missing? Tell us and we’ll fix it.