Use your own Claude, OpenAI or DeepSeek API key

Bring your own API key to the SideBoo Chrome extension: OpenAI, Claude, DeepSeek, Gemini, Kimi, GLM, Qwen or OpenRouter. Where to get each key, and how.

8 min read · Last updated 2026-08-27

Overview

SideBoo ships no model of its own and proxies nothing. "Ask AI" in the command palette, page summaries, and every other AI feature run on a model service you configure yourself: the key stays in your browser, and requests go straight from your browser to the endpoint you entered.

This page covers three things: how to connect a service, where to get each provider's API key, and what to do when the connection fails.

1. Before you start

SideBoo only talks to OpenAI-compatible endpoints. Any service qualifies if it offers these two paths:

Request pathPurpose
{API URL}/chat/completionsChat. Where generation actually happens.
{API URL}/modelsModel discovery. Used by "Test service" in settings to check connectivity and pull the model list.

So the API URL you enter is a base URL and must include the version path (e.g. https://api.openai.com/v1) — not the full /chat/completions URL. Trailing slashes are stripped automatically.

2. Setup in three minutes

Open the extension's settings page and choose "AI assistant" in the sidebar:

  1. Add a provider Click "Add provider", pick one of the preset cards (the endpoint is filled in for you) or the dashed "Custom OpenAI-compatible service" card at the bottom, and hit Continue.
  2. Paste the API key Presets have a "Get a key" button that opens the right console. See "3. Getting an API key from each provider" below.
  3. Click "Test service" On success you will see "Connected · N models found · xx ms", and the provider's model list is pulled in.
  4. Tick the models you want Only ticked models appear in the default-model dropdown and in the model switcher inside "Ask AI". Two or three is usually plenty — a long list is harder to navigate.
  5. Set the default model Go back to the "Default model" dropdown at the top of the AI page and pick one. This is what "Ask AI" and page summaries call.
  6. Save Your configuration applies on save.

Each provider in the list carries a status badge, so you can see at a glance what's missing:

BadgeMeaning
Needs setupNo API key yet (local services on localhost / 127.0.0.1 are exempt).
No endpoint setThe API URL field is empty — only reachable on a custom service.
Pick modelsKey is in place, but no model is ticked.
ReadyGood to go.

3. Getting an API key from each provider

The eight providers below are built-in presets — pick one and the endpoint is filled in, so all you paste is the key.

OpenAI
API URL
https://api.openai.com/v1
Common models
gpt-4o-mini, gpt-4o, gpt-4.1-mini

The API and ChatGPT are separate products — a ChatGPT Plus subscription grants no API credit, you have to add funds on the developer platform. Accounts without a payment method have very low rate limits and hit 429 easily.

Claude
API URL
https://api.anthropic.com/v1 (OpenAI-compatible layer; chat goes to /chat/completions)
Common models
claude-opus-5, claude-sonnet-5, claude-haiku-4-5

Anthropic's preset is labelled just "Claude" in the dialog. Its /models is a native endpoint that expects x-api-key rather than Bearer. SideBoo handles that automatically when you add Claude from the preset. If you instead create a "custom service" and paste the same URL, the connection test will fail on the auth header.

DeepSeek
API URL
https://api.deepseek.com/v1
Common models
deepseek-chat, deepseek-reasoner

You need to top up in the console before the key has any quota.

Moonshot Kimi
API URL
https://api.moonshot.cn/v1
Common models
moonshot-v1-8k, moonshot-v1-32k, kimi-latest

Unfunded accounts have a very tight per-minute request limit — consecutive questions will almost certainly error. A small top-up fixes it.

智谱 GLM
API URL
https://open.bigmodel.cn/api/paas/v4
Common models
glm-4-plus, glm-4-flash

Zhipu AI — the preset carries its Chinese name in the dialog. The path ends in /v4, not /v1 — do not "correct" it out of habit. Lightweight models like glm-4-flash are a cheap fit for summarisation.

通义千问
API URL
https://dashscope.aliyuncs.com/compatible-mode/v1
Common models
qwen-plus, qwen-turbo, qwen-max

Alibaba's Qwen, listed under its Chinese name and reached through Bailian. You must use the compatible-mode entry point; SideBoo does not speak DashScope's native protocol. Enable the model service in the console before first use.

OpenRouter
API URL
https://openrouter.ai/api/v1
Common models
openai/gpt-4o-mini, anthropic/claude-3.5-sonnet

An aggregator — one key reaches hundreds of models, and model IDs carry a "vendor/" prefix. Several free models make it a good way to try providers before committing. The list pulled by "Test service" is long, so use the search box above it.

Google Gemini
API URL
https://generativelanguage.googleapis.com/v1beta/openai
Common models
gemini-2.0-flash, gemini-1.5-pro

The trailing /openai is the OpenAI-compatible entry point and cannot be dropped. The service is region-restricted and unavailable from some locations (including Hong Kong). Shared IPs or heavy usage can be flagged as abuse and get the key disabled.

4. Custom OpenAI-compatible services

Pick "Custom OpenAI-compatible service" at the bottom of the "Add provider" dialog to connect relay/aggregator gateways, an internal corporate proxy, an Azure OpenAI deployment, or a local inference server.

A custom service needs three fields from you: a name (to tell it apart in the list), the API URL, and the API key.

Working out the URL

Take the full chat URL your provider documents and drop the trailing /chat/completions — what's left is the API URL:

https://your-gateway.com/v1/chat/completions   ← what the provider gives you
https://your-gateway.com/v1                    ← what you enter

Local models (Ollama, LM Studio, …)

Local servers usually don't check credentials, so the API key can stay empty — SideBoo won't block you once it sees the URL points at localhost, 127.0.0.1, or [::1].

Take Ollama: install it, pull a model with ollama pull <model>, and it listens on port 11434 — the OpenAI-compatible URL is http://localhost:11434/v1. The extension holds access permission for http://localhost/* and http://127.0.0.1/* on any port, so plain http:// works.

Ollama also rejects cross-origin requests by default and answers a browser extension with a 403, so set OLLAMA_ORIGINS to chrome-extension://* and restart it:

  • macOS: launchctl setenv OLLAMA_ORIGINS "chrome-extension://*", then quit and reopen Ollama from the menu bar.
  • Linux: sudo systemctl edit ollama.service, add Environment="OLLAMA_ORIGINS=chrome-extension://*", then daemon-reload and restart. For a foreground run, OLLAMA_ORIGINS="chrome-extension://*" ollama serve.
  • Windows: quit Ollama from the tray, add a user environment variable OLLAMA_ORIGINS=chrome-extension://*, then start it again.

The variable is read at startup, so the restart is the part people skip. "Ollama, LM Studio and any OpenAI-compatible endpoint" walks through each platform in full.

When the endpoint returns no model list

Click "Add a model ID manually" and type the name from the provider's docs (e.g. gpt-4o-mini). Manually added models are ticked automatically and can be set as the default straight away.

5. When "Test service" fails

The test reports errors in plain language. Match yours against the table:

MessageCause and fix
Key rejected (401 / 403)The key picked up a stray space or newline when copied; the key expired or was revoked; the account lacks access to that model. Generate a fresh key and retry.
Endpoint not found (404)The URL is missing its version path (/v1, /v4, /compatible-mode/v1, …), or you pasted the full /chat/completions URL. For presets, "Restore default" above the API URL field puts it back.
Too many requests (429)You hit the provider's rate limit. Limits on unfunded accounts are usually severe — wait a while or add credit.
Can't reach that addressTypo in the URL, service not running, no network — or a local service addressed as something other than localhost / 127.0.0.1 (see the previous section).
Connected but 0 models foundThe service doesn't implement /models. Add the model ID manually; chat is unaffected.
403 from a local OllamaOllama's origin check. Set OLLAMA_ORIGINS as above and restart it — the key is not the problem.

If the test passes but "Ask AI" still errors, the model ID is usually valid while your account has no access to that particular model — try another one you have ticked.

6. Cost and privacy

All charges are billed by the provider you chose and have nothing to do with SideBoo. Pricing models differ (most bill per token, with input and output priced separately), so keep an eye on quota and billing in your provider's console to avoid surprises. Features like page summarisation send an entire article to the model and cost noticeably more per call than a short question — cheap lightweight models (gpt-4o-mini, glm-4-flash, qwen-turbo) are the better value there.

On privacy:

  • API keys are written only to your browser's local storage.local. They sync to no account and never leave your device.
  • Every model request goes from your browser directly to the endpoint you configured. SideBoo doesn't handle, relay, or log it.
  • Your conversations and the page content being summarised are sent to the provider you picked, and that provider's privacy policy governs how the data is handled.
  • "Remove provider" on a provider's detail page deletes its key and model configuration together. It takes effect on save and can't be undone.
Did this article answer your question?

Back to Common questions