Authentication
Authenticate Bitdeer AI API requests with a bearer API key.
All API requests must include a bearer token in the Authorization header.
Get your API key
- Log in to Bitdeer AI Console.
- Navigate to Models → API Keys (direct link).
- Click Generate API Key and copy it — the secret is only shown once.
Usage examples
Anthropic-style x-api-key header
Anthropic SDKs and tools can send the key in the x-api-key header instead:
x-api-keyis accepted only for 20-character API keys (keys that do not start withak-), and only when noAuthorizationheader is sent.- Keys that start with
ak-must useAuthorization: Bearer. Authorization: Bearerworks for every key format and every endpoint.
Key handling best practices
- Never commit keys or bundle them into client-side code.
- Load from environment variables or a secrets manager.
- Rotate by creating a new key, deploying it, then revoking the old key.
Unauthorized responses
Missing, malformed, unknown or expired API keys return 401 Unauthorized (code invalid_api_key) — see Errors for the response body shape. A Bearer token shaped like a JWT (starting with eyJ and containing two dots) is not an API key and is refused with 501.
Last updated on