API Key Configuration

Claudexia API keys support fine-grained controls for rate limits, model restrictions, IP whitelists, and budgets. This guide covers creating, configuring, rotating, and deleting keys.

Creating keys

1. Open Dashboard > API Keys.
2. Click Create Key and enter a name.
3. Copy the key immediately — it is shown only once.
4. Configure rate limits, models, and security after creation.

Key format

All Claudexia keys follow this format:

sk_cdx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The sk_cdx_ prefix identifies the key as a Claudexia key.

Per-key controls

Each key can be independently configured from the dashboard.

Rate limits

• Requests per minute (RPM) — caps how many requests the key can make per minute.
• Max tokens per request — limits output tokens on a single request.
• Daily / weekly / monthly budget — disables the key when the spend threshold is reached.

Model restrictions

Restrict a key to specific model IDs. Any request for a model outside the allowed list returns 403.

IP whitelist

Limit requests to specific IP addresses. Real client IP is resolved from proxy headers (CF-Connecting-IP, X-Forwarded-For).

IDE restrictions

Restrict the key to specific client user-agents, such as Cursor, Claude Code, or VS Code extensions.

Rotating keys

To rotate a key without downtime:

1. Create a new key with the same configuration.
2. Update your application to use the new key.
3. Verify the new key is working.
4. Delete or freeze the old key.

Both keys will work simultaneously during the transition.

Deleting keys

Deleted keys stop working immediately and cannot be restored.

Deletion is permanent. If you only want to temporarily disable a key, use the Freeze function instead.