AI_ALLOWANCE_EXHAUSTED.
Prerequisites
- A role that manages Ankra AI (
ai.manage): owners and admins. Anyone else sees Your role can look but not change. on Models and provider. - An OpenRouter account at openrouter.ai with credits available.
Add the Key
1
Create an API key at OpenRouter
Sign in at openrouter.ai and create a new API key from the Keys page. Copy the key - it starts with
sk-or-.2
Save the key in Ankra
--api-key. Ankra validates the key live against OpenRouter before storing it. These errors can come back:- Invalid API key - the key was rejected by OpenRouter. Check you copied the full key and that it has not been revoked.
- API key has no remaining credits on OpenRouter - the key is valid but its OpenRouter account has no credits left. Top up at OpenRouter, then save again.
- API key does not have permission to use OpenRouter - the key may not call models. Check its settings on OpenRouter.
- Could not reach OpenRouter to validate the key. Please try again. - nothing was saved. Try again in a moment.
3
Activate the provider
4
Verify
ankra ai status shows the active provider and a masked preview of the stored key (for example sk-or-...wxyz). Open the AI Assistant (⌘J / Ctrl+J) and send a message - the run appears in your OpenRouter activity.In the portal
- Go to Ankra AI → Models and provider (
/next/organisation/ai-models). - In AI provider, press Set up… on Your OpenRouter key. The dialog Save your OpenRouter API key says where to make one: at openrouter.ai, under Keys.
- Paste the
sk-or-...key into OpenRouter API key and press Save key. The same validation runs.
Rotating the Key
Save a new key over the old one -ankra ai openrouter set again, or Replace key… on the same row in the portal. The new key goes through the same live validation, and the old one is replaced on save - no downtime and no provider switch needed.
Removing the Key
Removing the key (ankra ai openrouter remove, or Remove the key… in the row’s options menu in the portal, then Remove key) stops Ankra using the stored key and deletes it from the secret store; if that delete fails, the key stays in the store but is no longer used. AI features that used it run on Ankra’s managed access and the free monthly allowance instead. If the allowance is already exhausted for the month, AI features pause until it resets or you add a key again.
Security
- The key is stored only in Ankra’s secret store (HashiCorp Vault or OpenBao) - never in the database, which records only that a key is configured.
- It is never shown again after saving; Ankra only ever displays its last characters.
- Saving and removing the key require the
ai.managepermission. - The key is never included in exports.
Related Pages
- Models and Cost - every provider mode, the default models, and what the free allowance covers