Tortilloid
Security and privacy / API keys

Docs / Security and privacy / API keys

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.

ProviderKey looks likeGet a key
OpenAIsk-...platform.openai.com/api-keys
Anthropicsk-ant-...console.anthropic.com/settings/keys
OpenCode ZenZen API keyopencode.ai/zen

Add a key

  1. Click the provider's row to open it.
  2. Paste your key into the field.
  3. Click anywhere outside the field. The key saves on its own, there is no Save button.
  4. 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.

ShownMeaning
WorksThe provider accepted the key.
Rejected. Check the key and try againThe provider refused the key.
Couldn't reach it to checkNo answer, for example when you're offline. This never means the key is wrong.
Saved, checked on first useOpenCode 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.

VariableProvider
OPENAI_API_KEYOpenAI
ANTHROPIC_API_KEYAnthropic
OPENCODE_ZEN_API_KEY or OPENCODE_API_KEYOpenCode 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.