Skip to content
LLMFLUX

Account

Usage and balance

Inspect metered requests and account credit without exposing prompts or provider credentials.

Read usage

GET /v1/usage requires an active API key. Its balance and usage totals are account-wide, not scoped to that key.

curl https://api.llmflux.dev/v1/usage \
  -H "Authorization: Bearer $LLMFLUX_API_KEY"

Response fields

  • tokens_used: sum of recorded account usage.
  • tokens_remaining: current materialized balance; a stream in flight lowers it by its hold, and the unused part returns when that stream ends.
  • tokens_total: current balance plus recorded usage, not an immutable plan quota.
  • credits_remaining and tokens_per_credit: balance conversion using current configuration.
  • status: active when balance is positive, otherwise exhausted.

Dashboard analytics

Use Usage Analytics for usage breakdowns and API Requests for the per-request log: one row per metered request, every figure derived by the server. Search filters the currently loaded request page. The API does not store request bodies in these usage records.

  • latency_ms: whole-request time in milliseconds, measured by the gateway when the request is metered.
  • ttft_ms: time to the first streamed byte; streaming requests only.
  • API key: the issuing key's name with a masked prefix. The secret and its hash are never returned. Playground runs carry no key and are labelled Playground, and a key you delete later is still identified by the name and prefix recorded on the row.
  • A dash means that row has no measurement: it predates these columns, or the request ended before metering ran. It is never a stand-in for a number we chose not to record, and a measured 0 renders as 0 ms.
Token counts come from the upstream provider: streaming accounting depends on usage frames, and a successful stream alone is not proof that every provider supplied complete token details. Timing is different — the gateway measures latency and first-byte time itself, so an aborted or failed stream still gets a timed row with zero tokens. A dash in those columns means no measurement exists for that row, never a number we chose not to record.