Loading the documentation…

Use your own API keys

Once your company turns on BYOK in DataMind Oda, you can add your own API keys from Anthropic, OpenAI, Google Gemini and OpenRouter and chat with those providers' models next to the DataMind models. It works the same in the DataMind Oda desktop app and in VS Code. Your keys stay encrypted on your computer, and Oda sends those requests straight to the provider, billed to the key's owner.

Before you start

Add a key

  1. Open Settings > Models. The Your API keys section, tagged Allowed by your company, sits above the DataMind models. A provider without keys shows a tile that reads No keys; a provider with keys gets a card that lists them.
  2. Choose Add key on the provider's tile, or on its card to add another key.
  3. In Add API key, pick the Provider, type a Name such as Main, and paste the key into API key. The eye button, Show key, shows what you pasted.
  4. Choose Check and save. While the button reads Checking…, Oda checks the key with the provider by reading its model list, and it saves the key once the provider accepts it.

Put your keys in order

A provider with several keys lists them in priority order, numbered from 1. Drag a key to a new place, or select its handle and press the up or down arrow key. Oda always uses the first key in the list that can answer, and moves down only when a key cannot.

A key with no tag is ready. Otherwise each key shows how it stands:

Key showsWhat it means
In useOda sent this provider's latest request with this key.
Rate limited · free at 14:35The key reached a per-minute limit and rests until the time shown. Oda uses the next key meanwhile.
Credit used up · free at 15:10The key's credit or monthly spend is used up. It rests for 1 hour, or until you choose Check again.
Refused by Anthropic: key invalid or revokedThe provider refused the key. Oda skips it, and the line under it reads "skipped until you replace it".
Checking…Oda is checking the key with the provider after you chose Check again.

The menu at the end of each key offers Rename, Replace key, Check again and Delete. A refused key also shows Replace key on its row.

How Oda moves between keys

When every key is at its limit

Choose which models the picker shows

Under your keys, each provider with a key lists its current models that can use tools and read images, for example under Anthropic models from your keys, with "Only models that can use tools and read images are listed. Refresh picks up new ones." Rows show Tools and Images, and the model's id.

Choose how much the model thinks

Models on your keys that can reason show Effort at the bottom of the model picker, as the DataMind models do: Low, Medium, High and Max. A chat on your key starts at Medium.

See what your keys cost

Requests on your keys show their cost in the chat statistics, next to Cache hit, and as Cost (your API keys) in Session statistics and in a turn's usage details.

What stays on your computer

When your company turns it off

Questions, answered

Does DataMind see my API key?

No. The key is encrypted on your computer and sent only to its provider. Your DataMind server never receives it.

Who pays for requests on my key?

The key's owner, through the provider's own billing. These requests do not count toward your AI limits in DataMind OS and are not recorded in Observability.

Why did Oda switch to my second key?

Your first key reached a limit or was refused. The note above the message box reads, for example, Key "Main" hit its limit. Using "Backup 1"., and Settings > Models shows when the first key is free again. Oda goes back to it as soon as it can answer.

A key reads Refused by its provider. What do I do?

The provider no longer accepts that key, for example because it was revoked. Choose Replace key, paste a working key and choose Check and save. Until then, Oda skips it.

Why is a model from my provider missing?

Oda lists only models that can use tools and read images. Of those, the three newest start shown, so turn the others on in Settings > Models. For a model the provider added recently, choose Refresh.

Does Oda move me to a DataMind model when my keys run out?

Never by itself. When every key rests for longer than a minute, the turn stops and you choose: Continue with your company's default DataMind model, Retry on the same model, or Manage keys.

Why does the cost start with ≈?

Oda worked it out from the tokens and the provider's list prices, because that provider does not report a cost with each answer. Your provider's own bill is the final amount. OpenRouter reports its cost, so it shows without ≈.

Can I get a deleted key back?

No. Delete asks first, and once you confirm, the key is gone from this computer. Add it again with Add key if you still have it.

Can I use my keys on another computer?

Add them there too. Keys stay on the computer where you added them, for your DataMind account only.

What happens to my keys when my company turns BYOK off?

They stay encrypted on your computer and Oda does not use them. Delete saved keys on Settings > Models removes them; if your company turns BYOK on again, they come back.

Do my company's instructions apply to chats on my key?

Yes. Oda adds your company's Organization instructions to every request, whichever model you chat with.

Can someone else on my computer use my keys?

No. Your keys belong to your DataMind account on your DataMind server. Another account that signs in to Oda on the same computer sees none of them.