自带 API Key 接入 Claude、OpenAI、DeepSeek

自带 API Key，把 OpenAI、Claude、DeepSeek、Gemini、Kimi、智谱、通义、OpenRouter 接入 SideBoo 谷歌浏览器插件：各家密钥怎么申请，怎么填。

8 分钟阅读 · 最后更新 2026-08-27

概览

SideBoo 自己不提供模型，也不代理任何请求。命令面板里的「问 AI」、网页摘要等能力，都跑在你自己配置的模型服务上：密钥保存在本机浏览器，请求由浏览器直接发往你填写的接口地址。

这篇文档解决三件事：怎么把一家模型服务接进来、各家的密钥去哪申请、接不通时怎么排查。

一、开始之前

SideBoo 只对接 OpenAI 兼容接口。一家服务只要满足下面两点就能接：

请求路径用途
{API 地址}/chat/completions对话。实际生成走这里。
{API 地址}/models模型发现。设置页「测试服务」用它探活并自动拉取模型清单。

所以你在设置页填的 API 地址是「基址」，必须带版本号路径（例如 https://api.openai.com/v1），而不是完整的 /chat/completions 地址。多余的结尾斜杠会被自动去掉。

二、三分钟接入流程

打开扩展的设置页，在左侧选「AI 助手」：

  1. 添加提供商 点「添加提供商」，从预设卡片里选一家（接口地址会自动填好），或选底部那张虚线的「自定义 OpenAI 兼容服务」卡片，然后点「继续」。
  2. 粘贴 API Key 预设服务旁有「获取密钥」按钮，直接跳到对应控制台。密钥申请方式见下方「三、各家服务的密钥申请」。
  3. 点「测试服务」 成功会显示「连接正常 · 发现 N 个可用模型 · 耗时 xx ms」，同时把该服务的模型清单拉下来。
  4. 勾选要用的模型 只有勾选过的模型，才会出现在默认模型下拉和「问 AI」的模型切换里。建议只勾 2–3 个常用的，列表太长反而难选。
  5. 设置默认模型 回到 AI 页顶部的「默认模型」下拉选一个。这是「问 AI」和网页摘要的默认调用对象。
  6. 保存 配置保存后立刻生效。

列表里每家服务会显示状态徽章，可以一眼看出还差什么：

徽章含义
需设置还没填 API Key（指向 localhost / 127.0.0.1 的本机服务除外）。
未填写地址API 地址是空的 —— 只有自定义服务会出现这个状态。
待选模型有 Key 了，但一个模型都没勾选。
已就绪可以用了。

三、各家服务的密钥申请

以下 8 家是内置预设，选中后接口地址自动填好，你只需要粘贴密钥。

OpenAI
API 地址
https://api.openai.com/v1
常用模型
gpt-4o-mini、gpt-4o、gpt-4.1-mini

API 与 ChatGPT 网页版是两套独立服务，开通 ChatGPT Plus 不会给你 API 额度，需要单独在开发者平台充值。未绑卡的新账号速率限制极低，容易报 429。

Claude
API 地址
[https://api.anthropic.com/v1](https://api.anthropic.com/v1)（OpenAI 兼容层，对话走 /chat/completions）
常用模型
claude-opus-5、claude-sonnet-5、claude-haiku-4-5

Anthropic 这家预设在弹窗里就叫「Claude」。它的 /models 是原生接口，认的是 x-api-key 而不是 Bearer。SideBoo 已针对这家做了鉴权头适配，用预设添加即可；如果你手动建成「自定义服务」再填这个地址，测试服务会因鉴权风格不对而失败。

DeepSeek
API 地址
https://api.deepseek.com/v1
常用模型
deepseek-chat、deepseek-reasoner

注册后需在控制台先充值才有额度。

Moonshot Kimi
API 地址
https://api.moonshot.cn/v1
常用模型
moonshot-v1-8k、moonshot-v1-32k、kimi-latest

未充值账号的每分钟请求数限制很严，连续提问基本必然报错，建议先小额充值。

智谱 GLM
API 地址
https://open.bigmodel.cn/api/paas/v4
常用模型
glm-4-plus、glm-4-flash

智谱 AI，预设在弹窗里用的就是中文名。地址末尾是 /v4 而非 /v1，别按习惯改。glm-4-flash 一类轻量模型适合做摘要，成本低。

通义千问
API 地址
https://dashscope.aliyuncs.com/compatible-mode/v1
申请密钥
百炼控制台
常用模型
qwen-plus、qwen-turbo、qwen-max

阿里的 Qwen，预设用中文名列出，走百炼开通。必须用 compatible-mode 这个 OpenAI 兼容入口，DashScope 的原生接口 SideBoo 不识别。首次使用需在控制台开通模型服务。

OpenRouter
API 地址
https://openrouter.ai/api/v1
申请密钥
openrouter.ai/keys
常用模型
openai/gpt-4o-mini、anthropic/claude-3.5-sonnet

聚合网关，一个 Key 可调用几百个模型，模型 ID 带「厂商/」前缀。有若干免费模型，适合先试用再决定接哪家。「测试服务」拉回来的清单会很长，用列表上方的搜索框过滤。

Google Gemini
API 地址
https://generativelanguage.googleapis.com/v1beta/openai
常用模型
gemini-2.0-flash、gemini-1.5-pro

地址结尾的 /openai 是 OpenAI 兼容入口，不能省。该服务有地区限制，部分地区（含香港）IP 不可用。共享 IP 或高频调用可能被判定为滥用而封禁密钥。

四、自定义 OpenAI 兼容服务

在「添加提供商」弹窗底部选「自定义 OpenAI 兼容服务」，可以接入：中转 / 聚合网关、企业内部代理、Azure OpenAI 部署、本地推理服务等。

自定义服务需要你自己填三项：名称（用于在列表里区分）、API 地址、API Key。

填地址的判断方法

拿到服务商给的完整对话地址后，去掉尾部的 /chat/completions，剩下的就是 API 地址：

https://your-gateway.com/v1/chat/completions   ← 服务商给的
https://your-gateway.com/v1                    ← 填这个

本地模型（Ollama / LM Studio 等）

本机服务通常不校验密钥，API Key 可以留空——SideBoo 检测到地址指向 localhost / 127.0.0.1 / [::1] 时不会拦你。

以 Ollama 为例：安装后用 ollama pull <模型名> 拉取模型，服务默认监听 11434 端口，OpenAI 兼容地址是 http://localhost:11434/v1。扩展已放开 http://localhost/* 与 http://127.0.0.1/* 的访问权限，不限端口，明文 http:// 也能直连。

另外，Ollama 默认拒绝跨源请求，对浏览器扩展直接回 403，需要把 OLLAMA_ORIGINS 设成 chrome-extension://* 后重启服务：

  • macOS：launchctl setenv OLLAMA_ORIGINS "chrome-extension://*"，然后从菜单栏退出 Ollama 再打开；
  • Linux：sudo systemctl edit ollama.service，加一行 Environment="OLLAMA_ORIGINS=chrome-extension://*"，再 daemon-reload 并重启；前台跑就用 OLLAMA_ORIGINS="chrome-extension://*" ollama serve；
  • Windows：先从托盘退出 Ollama，在用户环境变量里新建 OLLAMA_ORIGINS=chrome-extension://*，再重新启动。

这个变量只在启动时读一次，大家漏掉的正是「重启」这一步。《Ollama、LM Studio 与任意 OpenAI 兼容端点》里把三个平台都写全了。

接口不返回模型清单时

点「手动添加模型 ID」，直接填服务商文档里写的模型名（例如 gpt-4o-mini）。手动添加的模型会自动勾选，可直接设为默认模型。

五、测试服务失败了怎么办

「测试服务」的报错已经翻译成人话，对照下表处理：

提示原因与处理
密钥被拒绝（401 / 403）Key 复制时带了空格或换行；Key 已过期或被吊销；账号未开通对应模型权限。重新生成一个 Key 再试。
接口不存在（404）地址少了版本号路径（漏了 /v1、/v4、/compatible-mode/v1 之类），或误填成了完整的 /chat/completions 地址。预设服务可点「API 地址」右上角的「恢复默认」一键还原。
请求过于频繁（429）触发了服务商的速率限制。未充值账号限制通常极严，等一会儿再试或先充值。
无法连接到该地址地址拼错、服务没启动、网络不通；或本机服务用了 localhost / 127.0.0.1 以外的写法（见上一节）。
连接正常但发现 0 个模型该服务没实现 /models。手动添加模型 ID 即可，不影响对话。
本机 Ollama 回 403Ollama 的来源校验。按上面设置 OLLAMA_ORIGINS 再重启即可，问题不在 Key。

如果测试通过但「问 AI」仍然报错，多半是模型 ID 对了、但该账号没有这个模型的权限——换一个已勾选的模型试试。

六、费用与隐私

费用完全由你选择的服务商收取，与 SideBoo 无关。各家计费方式不同（多数按 token 计费，输入输出分别计价），请自行关注控制台的额度与账单，避免意外扣费。网页摘要这类会把整页正文送进模型的功能，单次消耗明显高于普通提问，用便宜的轻量模型（如 gpt-4o-mini、glm-4-flash、qwen-turbo）性价比更好。

隐私方面：

  • API Key 只写入本机浏览器的 storage.local，不同步到任何账号，也不会离开你的设备。
  • 所有模型请求由你的浏览器直连你配置的服务地址，SideBoo 不经手、不中转、不记录。
  • 你的对话内容和被摘要的网页内容会发送给你自己选择的那家服务商，其数据处理方式适用该服务商的隐私政策。
  • 在提供商详情页点「移除提供商」，该服务的密钥与模型配置会一并删除，保存后生效，不可撤销。
这篇文档解决了你的问题吗？

返回 常见问题