Authentication
One header, one key. Send it with every request and you're in. Authorization header on each call.
The Authorization header
Prefix your key with Bearer and pass it as the Authorization header:
curl https://api.scarleta.ai/v1/batches \
-H "Authorization: Bearer $SCARLETA_API_KEY"Treat your key like a password. Keep it on the server, never ship it in client-side code or commit it to source control, and rotate it if it's ever exposed.
Key prefixes
The first characters of a key tell you what it is. Every key you'll use falls into one of these two tiers:
| Prefix | Tier | Notes |
|---|---|---|
scar_live_* | Paid, production | Your live key for real, billed traffic. |
sk_free_* | Free user | Issued with a one-time grant of 300 free tokens to get you started. |
Each account can make 100 requests per hour on a free key and 10,000 requests per hour on a paid key. Past that the API answers 429 rate_limit_exceeded; wait for the Retry-After header, then retry.
Don't have a key yet? Create one for free . The free tier includes a one-time 300-token grant so you can start calling the API right away.