Skip to Content
Getting startedKeys and authentication

Keys and authentication

Audience: members and administrators. Creating and managing shared keys is covered in Shared API keys.

Two kinds of key, billed differently

Personal keyEnterprise shared key
Managed inConsole → API keys (/keys)Console → Shared API keys (/org/tokens)
Belongs toYouThe enterprise — not attributed to a member
SpendsYour own balanceThe enterprise shared balance
When the enterprise balance is shortn/aNo fallback to your personal wallet
Constrained byYour own quota and subscriptionThe key’s own quota
Who can createYouEnterprise administrators

A shared key does not fall back to a personal wallet. It draws on the enterprise balance, and when that is exhausted the request is rejected rather than charged to the caller. Handing someone a shared key hands them the enterprise balance — set the key’s quota deliberately.

Which side a member’s own calls are charged to is a per-enterprise billing policy: with enterprise billing enabled, calls draw on the enterprise balance, and only when the enterprise allows “personal wallet fallback” does an insufficient enterprise balance fall through to the member’s own balance. Those switches live in Settings.

Authenticating

Following the OpenAI convention:

Authorization: Bearer sk-...
PurposeAddress
OpenAI-compatible APIhttps://alltokens.si/v1
Gateway health check (no key needed)https://alltokens.si/api/status

Key states

StateMeaningWhat to do
EnabledUsable—
DisabledSwitched off manually; requests are rejectedRe-enable it
ExpiredPast its configured lifetimeCreate a new one
ExhaustedReached its quotaRaise the quota or create a new key

Hygiene

  • A key is money. Never commit it, paste it into chat, or ship it in front-end code.
  • Inject keys through environment variables or a secret manager.
  • Use a separate key per purpose: one leak then affects one place, and you can tell sources apart in Request logs.
  • If you suspect a leak, disable or delete the key immediately and issue a new one.
  • The plaintext is usually shown once at creation — save it then.