# AI Configuration
AI Configuration lets you connect your own Anthropic or OpenAI account to Ask Zaphiri and the other AI features. You'll find it under [[Account Settings]] → AI Configuration.
> [!quote] Your key, your models
>
> With your own API key you can use the specific models you prefer, and your AI usage stays under your own account.
## Why use your own key
Every plan includes some AI requests on Zaphiri's key: 25 in total on Solo, and 100 a month on Solo Pro and for every member of a Team or Team Pro workspace. After that, or if you want specific models or direct control of costs, connect your own key. Your own key works on every plan, and your provider bills you for what you use. See [[Plans & Billing#AI requests]] for what counts as a request.
Your key is stored encrypted, and only a masked hint shows after you save. Zaphiri never displays the full key again.
## Supported providers
![[settings-integrations.png]]
AI providers live under **AI Configuration** in the Integrations tab. Each provider has its own **Add Key** action.
### Anthropic
- Claude Haiku 4.5
- Claude Sonnet 4
- Claude Opus 4
### OpenAI
- GPT-4o Mini
- GPT-4o
- GPT-4.1
- GPT-4.1 Mini
## Adding a key
1. Go to [[Account Settings]] and select **AI Configuration**
2. Choose your provider (Anthropic or OpenAI)
3. Paste your API key
4. Select **Test** to validate the key before saving
5. Select **Save**. The key is stored and masked straight away
You can add one key per provider. To replace a key, paste a new one and save. It overwrites the previous entry.
## Badge states
Each provider shows a badge for its current state:
| Badge | Meaning |
|-------|---------|
| Add Key | No key configured |
| Untested | Key saved but not validated |
| Active | Key saved and validated |
| Default | Key is set as the primary provider |
| Invalid | Key failed validation |
## Setting a default
If you have keys for both providers, set one as the default. Ask Zaphiri, the [[AI Chat Assistant]], uses the default key unless you switch providers yourself in the chat panel.
To set a default, open the provider and select **Set as Default**.
## Removing a key
Open the provider entry and select **Remove**. Then choose another configured provider, or Zaphiri, in the chat selector. Zaphiri's included requests still apply when you choose its key.
> [!note] When your included requests run out
> Ask Zaphiri tells you when you have two requests left. Once they're used, add your own key to keep using AI features you start yourself. AI that Zaphiri runs for you, such as task suggestions and Optimize my day, keeps working and does not count.
## Choose a provider for a conversation
The Ask Zaphiri provider selector shows the personal, project and Zaphiri choices available to you. Check the selected provider before you send a message. A personal provider you choose yourself takes priority over the project's default.
If that provider's key is missing, invalid or rejected, use its settings to test or replace the key, or choose another provider. An error never means Zaphiri will send that conversation through a different key on its own.
To review wording before a task edit, follow [[AI Chat Assistant#Draft first, then approve a note change|Draft first, then approve a note change]].
## Project-level keys (Team Projects)
> [!note] Team Pro
> Project-level AI keys are part of the Team Pro plan. See [[Plans & Billing]].
A Team Project **owner** can set a single Anthropic or OpenAI key for the whole project, instead of relying on each member's own key. Once set, it's used for that project's [[AI Chat Assistant|Ask Zaphiri]] chat, transcript summaries and note Q&A.
- **Where to set it**: open the project's Settings, then the **Integrations** tab (owner only)
- **One key per project**: adding a new key replaces the previous one
- **Test before saving**: validate the key the same way you would a personal key
- **Clear to members**: chat and summary responses show whether they used the project's key, a member's personal key or Zaphiri's included allowance
- **Personal keys can still override**: any member can pick their own personal key from the chat provider dropdown instead of the project's
If a project key is rejected, the conversation shows an error. Ask the project owner to check it in the project AI settings, or select another available provider before you retry.
---
**Next:** Start using your key in the [[AI Chat Assistant]].