Authentication
API keys, Bearer authentication and key rotation.
本文档适用于 API V1。
本页内容
Bearer authentication
All API requests require an API key in the Authorization header. Keys use the sk_ prefix followed by a random secret.
Authorization: Bearer sk_xxxKeeping keys safe
Only the key hash is stored server-side. Never commit keys to source control; use environment variables or a secrets manager. Rotate keys from the dashboard — old keys keep working for a configurable grace period to avoid downtime.
Authentication errors
| Code | HTTP | Description |
|---|---|---|
| UNAUTHORIZED | 401 | Missing or invalid API key. |
| FORBIDDEN | 403 | The key does not have access to this endpoint. |