Every request is authenticated with an API key sent as a bearer token:
There is no separate secret or signing step — the key is the credential.
Getting a key
- Sign in to the dashboard.
- Create a key.
- Copy it once and store it somewhere safe.
A key spends against your account balance and can call the models your account is
entitled to. GET /models returns exactly that set for the key you call it with.
Using the key
Pass it on the Authorization header of every call. With an OpenAI SDK, set it as the
api_key / apiKey:
Keeping keys safe
Never embed a key in client-side code, a mobile app, or a public repository. Anyone with
the key can spend against your account. Call the API from your backend and keep the key in
a server-side secret or environment variable.
- Rotate a key immediately if it may have leaked — create a new one in the dashboard
and delete the old one.
- Environment variables (e.g.
PRIMALABS_API_KEY) keep keys out of source control.
- A missing or invalid key returns
401; a key that cannot access the
requested model returns 403.