> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seriora.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hosted accounts and usage

> Sign in, see what you have spent, and know when the allowance resets.

A hosted seri account is an alternative to managing provider keys. You sign in, and seri routes
model requests through its gateway on your behalf.

| Command           | Does                                                            |
| ----------------- | --------------------------------------------------------------- |
| `/signup`         | create an account                                               |
| `/login`          | sign in                                                         |
| `/logout`         | sign out, and drop the cached usage snapshot                    |
| `/usage`          | spend against allowance, reset date, and a burn-rate projection |
| `/usage --detail` | the same, broken down by upstream route                         |

`--detail` is an argument to the slash command, not a process flag.

## What `/usage` shows

The window and the metric depend on the plan.

| Plan | Window    | Metered in                |
| ---- | --------- | ------------------------- |
| free | UTC day   | requests                  |
| paid | UTC month | dollars of upstream spend |

A paid plan also shows requests used today against the daily cap. Reset is the exclusive end of
the current window.

The projection is linear across the current window. If nothing has been used there is no
projected date. If the current pace would not reach the allowance before the window ends, it says
so instead of inventing a date.

Cache hit rate is shown whenever any input tokens were billed. The dollar value of those cache
reads is shown only when the models in the report actually carry a cache-read price.

## Plans

`free`, `pro`, `max` and `ultra`. The free plan is provisioned on first login and is never
bought. Current prices and what each tier includes live in the seri portal rather than here, so
there is one place they can be wrong.

## When you are not signed in

`/usage` says that hosted usage needs `/login`, and that bring-your-own-key spend lives in your
provider's own console. seri keeps no local dollar tally for a key you own.

## If the gateway cannot be reached

`/usage` falls back to the last snapshot it fetched, for up to 60 minutes. Past that it reports
that it could not refresh rather than showing a number that has quietly gone stale.