自带 API Key 接入大模型：五步配置
五步走完：选服务商、申请 API Key、粘进 SideBoo、点「测试服务」。另外说清楚哪些数据会离开浏览器，以及大概要花多少钱。
6 分钟阅读 · 最后更新 2026-08-27
SideBoo 为什么需要你自己的模型服务
SideBoo 有两个能力要调用大模型。命令面板里的「问 AI」，可以把打开的标签页按主题分组、告诉你手头正在做的是哪件事，或者指出哪些标签页可以放心关掉；「总结此网页」则读一遍你正在看的这篇，把要点还给你。
SideBoo 不运行自己的推理服务，也不代管任何模型额度。你绑定哪家服务商，请求就直接从你的浏览器发往那家服务商，中间不经过 SideBoo 的任何服务器。这也是为什么在免费版里 AI 功能就能完整使用：算力的账单在你自己那边。
开始之前
你需要准备：
- 一个受支持服务商的账号，并且已经完成充值或绑定了付款方式；
- 一个具备对话（chat completions）权限的 API Key；
- SideBoo 0.0.3 或更高版本——在 chrome://extensions 里可以看到当前版本号。AI 功能是 0.0.3 这个首个公开版本带上来的，所以从 Chrome 应用商店装的任何一个版本都有。
支持的服务商
内置了八家预设：OpenAI、Claude、DeepSeek、Moonshot Kimi、智谱 GLM、通义千问、OpenRouter 和 Google Gemini。选中一家，它的接口地址和「获取密钥」链接就自动填好，你要粘的只有 Key。其中两家——Claude 和 OpenAI——第一次打开 AI 设置时就已经在列表里了，剩下六家自己添加。
其它任何实现了 /v1/chat/completions 的服务，都走同一个弹窗底部那张虚线卡片「自定义 OpenAI 兼容服务」。本地模型、公司内网网关、聚合路由都从那里进来——具体见《Ollama、LM Studio 与任意 OpenAI 兼容端点》。
每家预设的接口地址、密钥申请入口和可用模型名，见《自带 API Key 接入 Claude、OpenAI、DeepSeek》。
第一步：拿到 API Key
每家服务商都在自己的开发者控制台里签发 Key，而且几乎没有一家会把 Key 再给你看第二遍。所以这一步其实是两个习惯：建一个只归 SideBoo 用的 Key，以及在弹窗关掉之前把它复制走。
- 打开服务商的控制台 OpenAI 在 platform.openai.com/api-keys，Claude 在 platform.claude.com/settings/keys，DeepSeek 在 platform.deepseek.com/api_keys。在 SideBoo 里，预设服务旁的「获取密钥」按钮会直接帮你跳到对应那一个。
- 新建一个 Key 建议单独为 SideBoo 建一个，命名成 “SideBoo”。这样以后想停用它，不会影响你其它项目在用的 Key。
- 立刻复制保存 绝大多数服务商只在创建时完整显示一次 Key，关掉弹窗就再也看不到了。
第二步：在 SideBoo 里绑定
- 打开设置 按 ⌘K（Windows / Linux 是 Ctrl+Shift+K，可在 Chrome 扩展快捷键中修改）唤出命令面板，输入「设置」并回车；也可以右键工具栏上的 SideBoo 图标选择「选项」。
- 添加服务商 在设置页左侧选「AI 助手」，点「添加提供商」，在弹窗里选中那家的卡片，再点「继续」。这里没有 AI 总开关：没配服务商之前，不会有任何东西去调模型。
- 粘贴 Key 粘进「API Key」这一栏。预设的「API 地址」已经填好了——万一改坏了，字段上方的「恢复默认」能还原。
- 点「测试服务」 SideBoo 会先让你确认一次数据外发，然后真的去调这个接口。成功会显示「连接正常 · 发现 N 个可用模型 · 耗时 xx ms」，同时把这家的模型清单一并拉回来。
- 勾选模型，再设默认 勾选过的模型才会出现在页面顶部的「默认模型」下拉里，以及「问 AI」内部的模型切换里。勾两三个通常就够了。
列表里每家服务都带一个状态徽章，所以光看列表就知道还差什么：需设置（还没填 Key）、待选模型（Key 有了但一个都没勾）、未填写地址，以及已就绪。
SideBoo 会把什么发给模型
只发这次操作需要的内容，而且只在你触发时发。第一次向一家新服务发请求之前，SideBoo 会用一个确认框把这份清单摊开给你看，而那个清单就是全部：
| 操作 | 发送的内容 |
|---|---|
| 问 AI | 你输入的问题，以及你打开的那些标签页的标题和网址。 |
| 总结此网页 | 你当前这一页的可读正文。 |
| 任何一次请求 | 你的 API Key，只用于向这家服务鉴权。 |
清单以外的东西不会离开浏览器：表单输入、cookie、登录凭据，都不会。
API Key 只写进 chrome.storage.local，不写别处。它属于你这台设备上的这个浏览器配置文件，也不参与 Chrome 账号同步。
费用大概是多少
在「问 AI」里问一句话，发出去的是你的问题加上每个标签页约一行文字，所以哪怕窗口开得再离谱，量级也就是几千个输入 token。贵的是网页摘要：它会把整篇正文送进去。按 2026 年中的价格，用预设里那些小模型，两者都在千分之几美元一次的量级。
想少花钱，就把「默认模型」指向服务商的轻量款——gpt-4o-mini、glm-4-flash、qwen-turbo 拿来做摘要都够用，价格却只有旗舰模型的零头。
接下来
如果你用的不是这八家预设，而是本地模型、公司内网网关或聚合路由，接着读《Ollama、LM Studio 与任意 OpenAI 兼容端点》——那篇覆盖接口地址怎么填、几乎人人都会撞上的 Ollama 403，以及其它所有你可能遇到的报错。