Usage Message Costs

Message-level cost drilldown for the app behind this runtime key.

This complements GET /v1/usage. The aggregate usage endpoint stays a compact ledger rollup; this endpoint is the audit/drilldown surface for reply and image costs by end-user/character pair.

Authentication

AuthorizationBearer

LoreOS API key, sent as Authorization: Bearer <key>.

Query parameters

viewstringOptionalformat: "^(users|characters)$"Defaults to users

fromstring or nullOptional

tostring or nullOptional

external_user_refstring or nullOptional

character_slugstring or nullOptional

session_idstring or nullOptionalformat: "uuid"

modalityenumOptionalDefaults to all

Allowed values:

limitintegerOptional1-100Defaults to 20

messages_per_pairintegerOptional0-25Defaults to 5

include_previewbooleanOptionalDefaults to false

Response

Successful Response

Errors

422

Unprocessable Entity Error