Authentication

Authentication

All inference requests authenticate with an API key passed as a bearer token:

Authorization: Bearer sk-crustoff-...

Create and revoke keys in your dashboard. A key is shown in full once, at creation — we only store a hash, so we can’t recover it later. If you lose it, revoke it and create a new one.

⚠️

API keys are machine credentials with spending power. Keep them on your server, never in browser or mobile client code, and never commit them to source control. Use an environment variable (CRUSTOFF_API_KEY).

Two kinds of credentials

Crustoff has two separate auth planes — don’t mix them up:

CredentialUsed forWhere
sk-crustoff-… API keyThe inference API (/v1/*)Your code / SDKs
Dashboard loginManaging keys, credits, usagecrustoff.app/dashboard

The API key authenticates machines calling the model endpoints. Your dashboard login (email + password) is for humans managing the account, and is never used to call the inference API.

Revoking a key

Revoke from the dashboard. Revocation takes effect within seconds — any app still using the key will start receiving 401 errors.

Errors

StatuscodeMeaning
401missing_api_keyNo Authorization header
401invalid_api_keyUnknown key
401inactive_api_keyKey was revoked
403inactive_accountAccount is suspended

See Errors for the full error shape.