API keys
Add, check, change and remove your keys, and how they are stored.
Kongo runs on your own AI account. Tortilloid has built-in key handling for OpenAI, Anthropic and OpenCode Zen.
Where keys live
Open Settings with Tortilloid › Preferences… (Cmd+,) and choose AI & Providers. Each provider has a row showing Connected or Not connected, and how many models it offers.
| Provider | Key looks like | Get a key |
|---|---|---|
| OpenAI | sk-... | platform.openai.com/api-keys |
| Anthropic | sk-ant-... | console.anthropic.com/settings/keys |
| OpenCode Zen | Zen API key | opencode.ai/zen |
Add a key
- Click the provider's row to open it.
- Paste your key into the field.
- Click anywhere outside the field. The key saves on its own, there is no Save button.
- The row now says Connected.
No key yet? Click Get a key in the open row to go to the provider's page. Click Show to see what you pasted, and Hide to mask it again.
You can also paste a key on first launch, on the Kongo needs a key. card. Or skip it. Free Agent works without one.
Check a key
Open the provider's row in AI & Providers and click Check key. Tortilloid sends one free request to the provider's list of models and shows the result in the row. The last setup card, You're all set., checks every saved key the same way.
| Shown | Meaning |
|---|---|
| Works | The provider accepted the key. |
| Rejected. Check the key and try again | The provider refused the key. |
| Couldn't reach it to check | No answer, for example when you're offline. This never means the key is wrong. |
| Saved, checked on first use | OpenCode Zen keys can't be tested for free, so they're tested the first time Kongo uses them. |
Check key is greyed out until a key is saved, and the result clears when you change the key.
Change or remove a key
- Change. Open the row, replace the key and click outside the field.
- Remove. Open the row and click Remove. The saved key is deleted from your Mac, and the row shows Not connected.
How keys are stored
- Keys you type into Settings are encrypted with your Mac's Keychain. Only the encrypted form is saved.
- If the Keychain isn't available, the key is kept for the current session only and never written to disk.
- Each key only ever goes to the provider it belongs to.
- Credentials for services Kongo connects to are kept the same way. Kongo is given a connection id, never the credential itself.
Environment variables
If you start Tortilloid from a terminal, it also reads these. Apps opened from Finder or the Dock don't see variables set in your shell profile. A key saved in Settings takes over once Tortilloid has loaded.
| Variable | Provider |
|---|---|
OPENAI_API_KEY | OpenAI |
ANTHROPIC_API_KEY | Anthropic |
OPENCODE_ZEN_API_KEY or OPENCODE_API_KEY | OpenCode Zen |
When a key is missing or wrong
Kongo tells you in the chat. The message says whether Kongo couldn't sign in with the key, the model needs a paid key, a free allowance or account credit has run out, or the provider's rate limit was reached.
What Kongo sends once a key works is covered in What model providers see.