Overview

Authentication

Secure every request with a bearer token using your EmpirioLabs API key

All EmpirioLabs API requests must include a bearer token in the Authorization header.

API key format

API keys use the sk-empiriolabs- prefix. You can generate up to 50 API keys per account from the dashboard.

1Authorization: Bearer sk-empiriolabs-...

Header format

Include the header on every request:

$curl "https://api.empiriolabs.ai/v1/models" \
>  -H "Authorization: Bearer sk-empiriolabs-your_key_here"

Rate limits

Each account starts with default rate limits:

LimitDefault
Requests per minute50 RPM
Tokens per minute2,000,000 TPM

If you need higher limits, email support@empiriolabs.ai. See Limits and API Keys for full details.

  • Generate separate API keys for production, staging, and development
  • Rotate keys on a regular schedule and immediately after suspected exposure
  • Store keys in a secret manager or deployment platform; never in client-side code, public repos, or logs
  • Delete unused keys from the dashboard promptly

Test your credentials

A quick way to verify your key is working:

$curl "https://api.empiriolabs.ai/v1/models" \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

A 200 response with the model catalog confirms your key is valid and your account has been set up correctly.

Common authentication responses

Status codeMeaningWhat to do
401 UnauthorizedThe token is missing, malformed, or not foundVerify the Authorization: Bearer sk-empiriolabs-... header format and that the key exists in your dashboard
402 Payment RequiredThe account has insufficient creditsTop up credits on the dashboard Billing page
429 Too Many RequestsRate limit exceeded (50 RPM default)Retry with exponential backoff and review your request volume

For the complete list of status codes across every endpoint, see Errors and Status Codes.