Bearer tokens
Every request must carry a bearer token in the Authorization header:
Authorization: Bearer tkf_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxNo query-string auth, no basic auth, no cookies. Cookies are deliberately ignored on the API host so cross-site requests cannot pick up a logged-in browser session by accident.
Token format
Tokens are 41 characters total: a fixed tkf_live_ prefix followed by 32 random alphanumerics. The first 13 characters (tkf_live_xxxx) are stored as the key's display prefix so you can recognize a key in the portal without ever seeing its full value again.
Revoking a key
Open API keys, click Revoke, confirm. The key stops authenticating on the next request — no propagation delay.
Rate limits
Two limits run in parallel and are independent of credit consumption:
- 600 requests / minute / IP — guards against runaway clients.
- 1200 requests / minute / API key — guards a single compromised key from hammering the upstream.
When throttled you get 429 rate_limited with a Retry-After header in seconds. Back off and resume.