Skip to content

Bringing your own key

TabOasis sells no AI credits and runs no model. Every AI feature is off until you paste in a key from a provider you have an account with. From then on, every request goes from your browser straight to that provider and is billed to you.

Two providers are supported:

Provider Get a key from Notes
Google Gemini Google AI Studio the default; building the AI search index is free
OpenAI OpenAI API keys building the index is paid, roughly $0.001 per 1,000 items
  1. Open the gear → AI Assistant. Until a key is saved it reads Not configured.
  2. Pick your provider from the dropdown: Google Gemini or OpenAI.
  3. Paste the key into API Key and press Save API key beside it. The eye icon shows and hides what you typed.
  4. Choose a Model. Once the key is saved, TabOasis asks the provider which models your account can use and lists them; Refresh re-fetches. Only chat-capable models are offered.

A green line then reads AI configured with encrypted key storage. See Where the key lives.

You can keep a key for both providers. The panel has a tab for each, and the Use this provider button switches which one your actions run against without deleting the other.

Press Remove API key, the button on the API Key field. It removes the key for the provider whose tab you are on and leaves the other one alone; switching provider removes nothing. To stop the key working everywhere, revoke it where you generated it. See Where the key lives.

Every AI action is a request to your provider, on your account, at their prices. TabOasis adds no markup and does not see the bill. In practice:

  • Editor actions are one request each, over the selected text or the whole note.
  • AI Generate and Suggest Column are one small request each.
  • AI search needs an index, built once over everything you have saved. After that, a search costs zero or one request, depending on whether reranking is on.

Advanced Settings in the same panel caps the response length per feature: Description, Column Suggest, Smart Search, Editor AI and Similar Bookmarks. Each is a token limit. 0 means unlimited, which is the default and what the panel recommends. Set one low and the model gets cut off mid-sentence. These limits are for capping spending; a lower one does not improve results.

The key is yours on either plan, and a Free plan can configure AI and use it. Pro changes which actions you may run:

  • Free: the editor’s Fix Grammar & Spelling.
  • Pro: every other editor action, Custom Prompt, and AI search.

Locked entries show a padlock and open the upgrade dialog. See Free vs Pro.

  • The AI button in the note editor is grayed out, or its menu says Configure AI in settings first. There is no saved key for the selected provider.
  • You get “Please configure AI settings first”. Same cause, from a different entry point.
  • The model list is empty. The provider rejected the key. Check it where you generated it; a key that has been revoked or has no billing attached lists nothing.
  • A key you saved weeks ago now reads Not configured. A browser update can make the stored key unreadable. Paste it in again; nothing else is affected. See Where the key lives.