APIAnalytics

Total LLM tokens

Total LLM tokens used, with per-type breakdown.

GET
/analytics/llm-tokens-total

Total LLM tokens used, with per-type breakdown.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

view_llm_analytics

Query Parameters

start_time*string

Start of the time range to report on, inclusive.

Formatdate-time
end_time*string

End of the time range to report on, exclusive.

Formatdate-time
provider?array<>

Filter to specific LLM telemetry providers.

model?array<string>

Filter to specific model names.

user_id?array<>

Filter to specific users by id.

user_group?array<string>

Filter to users in specific groups.

auth_mode?array<>

Response Body

The request has succeeded.

application/json
  1. response

Total token usage with per-type breakdown.

total*integer

Total tokens used across all matching telemetry.

Formatint64
by_type*array<>

Token totals split by category (input, output, cache).

curl -X GET "https://example.com/analytics/llm-tokens-total?start_time=2019-08-24T14%3A15%3A22Z&end_time=2019-08-24T14%3A15%3A22Z"
{  "total": 0,  "by_type": [    {      "type": "string",      "tokens": 0    }  ]}