Get usage breakdown by request label

GoModel API reference for GET /admin/usage/labels: Get usage breakdown by request label.

GET {base_url}/admin/usage/labels

Error

A valid request URL is required to generate request examples

200

[
  {
    "cache_write_input_tokens": 123,
    "cached_input_cost": 123,
    "cached_input_tokens": 123,
    "input_cost": 123,
    "input_tokens": 123,
    "label": "<string>",
    "local_cached_input_tokens": 123,
    "local_cached_output_tokens": 123,
    "output_cost": 123,
    "output_tokens": 123,
    "requests": 123,
    "total_cost": 123,
    "total_tokens": 123,
    "uncached_input_tokens": 123
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

days · integer

Number of days (default 30)

start_date · string

Start date (YYYY-MM-DD)

end_date · string

End date (YYYY-MM-DD)

model · string

Filter by exact model name

provider · string

Filter by provider name or provider type

label · string

Filter by request label (exact match)

session_id · string

Filter by exact detected session ID

user_path · string

Filter by tracked user path subtree

cache_mode · string

Cache mode filter: uncached, cached, all (default uncached)

Response

200

application/json

OK

cache_write_input_tokens · integer

cached_input_cost · number | null

cached_input_tokens · integer

input_cost · number | null

input_tokens · integer

label · string

local_cached_input_tokens · integer

local_cached_output_tokens · integer

output_cost · number | null

output_tokens · integer

requests · integer

total_cost · number | null

total_tokens · integer

uncached_input_tokens · integer