Sign in
usage

Get usage by referer for an API key

get/admin/v1/api-keys/{key_id}/usage/by-referer

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /admin/v1/api-keys/{key_id}/usage/by-referer
  • Auth: HTTP bearer

Path parameters

key_idstring uuid required

API key ID

Query parameters

start_datestring nullable

Start date (YYYY-MM-DD)

end_datestring nullable

End date (YYYY-MM-DD)

record_typestring nullable

Hadrian Extension: Filter by record type: "model" (LLM requests) or "tool" (server-side tool invocations). Omit to include both.

Response

Usage breakdown by HTTP referer

audio_secondsinteger required

Hadrian Extension: Audio duration in seconds

character_countinteger required

Hadrian Extension: Character count (TTS input)

http_refererstring nullable

HTTP referer header value

image_countinteger required

Hadrian Extension: Number of images generated

input_tokensinteger required

Input tokens used from this referer

output_tokensinteger required

Output tokens used from this referer

request_countinteger required

Number of requests from this referer

total_costnumber double required

Total cost in dollars from this referer

total_tokensinteger required

Total tokens used from this referer

Changes

No recorded changes to this operation across all 1 revision of this API.