连接服务商

AI Studio 运行在你自己的服务商密钥之上，从 Settings、AI Settings 的 Provider & Model 标签页连接。在聊天或生成之前，至少要连接一个服务商。这背后的理念参见自带 AI 密钥。

快速概览

1. 打开 Settings、AI Settings，选择一个服务商标签页。
2. 粘贴你的 API key。
3. 从该服务商的列表中选定一个模型。
4. 设定一个推理投入等级，可选地再设置系统提示词、温度和最大 token 数。
5. 测试连接，然后为聊天启用该服务商。

设置流程

对每个服务商而言，步骤都是相同的三个字段，外加可选的高级设置。

步骤	说明
API key	一个密码掩码字段。保存后，只以一段简短提示显示，绝不显示完整值
模型	该服务商可用模型的下拉列表
推理投入	一组服务商专属的等级，仅对具备聊天能力的服务商显示
测试	发出一个小请求，在你依赖它之前确认密钥可用
用于聊天	一个开关，把它设为聊天当前使用的服务商

推理投入的选项因服务商而异，例如 Default、Low、Medium、High，在支持更深入推理的服务商上有时还有 Extra High 或 Max；不具备这一能力的服务商会完全跳过这个控件。该值会自动应用到该服务商的每一次聊天请求，输入框里没有逐条消息的开关。

设置界面速览

Provider & Model 标签页左侧列出每一个服务商。一个盾牌图标标记出已经保存了密钥的每个服务商，而当前为聊天供能的那个会被标为 Active。顶部有一条摘要栏，随时告诉你聊天此刻正在使用哪个服务商和模型，以及是否已连接密钥，让你无需打开面板就能确认自己的配置。

在该列表中点击一个服务商，即可在右侧打开它的面板，其布局为三个带编号的步骤：

1. API Key，一个掩码字段。保存后，它会收起为一个 Change 按钮和一个删除（垃圾桶）控件，此后不再显示完整密钥。
2. Model，该服务商模型的下拉列表，其中合理的默认项标为 recommended。
3. Try it，即 Test connection 按钮。

如果该服务商支持可调推理，一个小的行内 Reasoning 下拉框会位于第 2 步和第 3 步之间。在这三步下方，一个 Advanced (optional) 折叠面板收纳了更细的设置。为聊天启用某个服务商靠的是 Use for chat 开关：当某个服务商正处于当前启用状态时，你无法直接把它关掉，而是启用另一个服务商，后者会自动接过 Active 标记。

高级选项

一个可选的、默认折叠的部分提供了更细的控制。

设置	范围	备注
系统提示词	自由文本	叠加在每条回复之下的自定义指令
温度	0 到 1.5	随着你拖动滑块，标注为 Precise、Balanced 或 Creative
最大 token 数	256 到 16384	默认 2048。限制单条回复的最大长度

每个高级字段在你点击离开的那一刻（失焦时）会各自保存，并弹出一个小的确认提示，因此这三项没有单独的保存按钮。连接之后，你的密钥以掩码形式显示，你可以随时更改或删除它。你想连接多少个服务商都可以，每一个都独立保留自己的密钥、模型和推理投入，所以切换当前启用的服务商时无需重新配置任何东西。

各服务商的推理投入等级

具体的等级集合因服务商而异，有些比另一些走得更远。

服务商	等级
OpenAI	Default、Off、Low、Medium、High、Extra High
Anthropic Claude	Default、Low、Medium、High、Extra High、Max
DeepSeek	Default、Off、High、Max（没有 Low 或 Medium 档）
Qwen	Default（关闭，推荐）、Low、Medium、High
Kimi	Default、Off、On（简单的开或关，没有分级档位）
GLM	Default、Off、On；一个更高端的 GLM 模型还会在基本的开关之上额外解锁 Low、High 和 Max
Google Gemini	Default、Minimal、Low、Medium、High

一个完全没有推理控件的服务商，比如不支持可调投入的那种，会直接跳过这个字段。

分步操作

界面对每个服务商都长得一样，所以做过一次之后，其余的都很快。下面这些演练用到了精确的点击位置。

连接一个 OpenAI 密钥并准备好聊天

1. 打开 Settings、AI Settings，停留在 Provider & Model 标签页。
2. 在左侧的服务商列表中，点击 OpenAI。它的面板会在右侧打开。
3. 在 Step 1、API Key 下，把你的密钥粘贴到掩码字段里。如果你还没有密钥，用服务商名称旁边的小型外部链接打开 OpenAI 自己的开发者控制台，在它的 API keys 页面创建一个密钥，然后回来粘贴。点击 Save。
4. 在 Step 2、Model 下，从下拉框中选择一个模型，或保留已经标为 recommended 的那个。
5. 如果第 2 步和第 3 步之间出现了 Reasoning 下拉框，选择一个等级或让它保持在 Default。
6. 在 Step 3、Try it 下，点击 Test connection 并等待消息 "Connection successful, key is valid."。
7. 如果 OpenAI 还没被标为 Active，就打开 Use for chat 开关。这会把它设为聊天使用的服务商。
8. 可选：打开 Advanced (optional) 折叠面板，添加 Assistant instructions（系统提示词），微调 Creativity（温度），或限制 Max reply length。这些字段都会在你点击离开时各自保存，因此不需要再按别的按钮。

设置一个仅供视频的服务商，比如 fal.ai

1. 打开 Settings、AI Settings、Provider & Model 标签页，在左侧列表中点击 fal.ai。
2. 把你的 fal.ai 密钥（格式为一个 key id 和一个 secret 用冒号连接）粘贴到 API Key 字段并点击 Save。你可以从 fal.ai 仪表盘的 Keys 页面获取它，该页面可通过服务商名称旁的外部链接进入。
3. 注意这里没有模型下拉框，也没有 Use for chat 开关。fal.ai 是一个生成引擎，所以它的卡片改为显示一个 Video engine 徽标，并说明真正的模型稍后在生成时才选择。
4. 点击 Test 会返回 "Key saved (this provider has no live test)"，而不是真正去校验它，因为这个服务商没有可供廉价探测的端点。这是预期行为，不是错误。
5. 生成时再选模型：在输入框的 Video 模式里（Seedance 2.0、Seedance 2.0 Fast、Veo 3.1、Veo 3.1 Fast 或 Kling 2.6），或在 Marketing Studio 里。该模式的控件参见生成视频。BytePlus 以同样的方式工作，带有一个 Video + image engine 徽标，同样在生成时选择模型。

切换当前的聊天服务商，同时不丢失你其他的密钥

1. 打开 Settings、AI Settings、Provider & Model 标签页。
2. 在左侧列表中，点击另一个已经保存了密钥的服务商，它由一个盾牌图标标示。
3. 打开它的 Use for chat 开关。它会立即成为 Active 聊天服务商，而之前那个会自动失去 Active 标记（你从不需要手动把旧的关掉）。

其他每一个服务商都会保留它保存的密钥、所选模型和推理等级，所以之后切回来无需重新配置。改变当前启用的服务商，不会丢失你连接过的任何东西。

连接一个自托管或自定义的 OpenAI 兼容端点

1. 打开 Settings、AI Settings、Provider & Model 标签页，在列表中点击 Custom Endpoint。
2. 输入一个 Base URL 和一个 Model Name，而不是从固定的模型下拉框中挑选。
3. 这里没有实时的 Test connection：按钮区域改为显示 "No test for a custom provider, try it in chat"。在聊天里发一条消息来确认它可用。
4. 打开 Use for chat 把它设为当前启用。

自定义端点是唯一一个密钥不在服务器上加密、也不经代理的服务商，因为没有固定的主机可供路由。它的密钥留在你的浏览器里，请求直接从浏览器发往你输入的 Base URL，所以只使用你信任的端点。这与下方自定义端点所述的行为一致。

你的密钥是安全的

密钥存储在服务器端

你的密钥在服务器上以静态加密方式存储，绝不会回传给浏览器。每一次服务商调用都由服务器代你发出，所以页面本身从不持有你真正的密钥，只有一个占位符代替它。

并非每个服务商都能实时测试

Test Connection 会为大多数服务商发出一个真实请求。少数仅供视频的服务商没有暴露适合实时测试的端点，所以在那里保存密钥只是确认它被存下来了，而非确认它可用。

有哪些服务商

不同的服务商支持不同的能力：有些只能用于聊天，有些只能生成图片或视频，还有少数两者都能做。按模式划分的完整分解，参见服务商与模型对照表。

自定义端点

如果你的服务商讲的是 OpenAI 兼容的 chat completions 格式，把它作为 Custom Endpoint 连接：提供一个 Base URL 和一个 Model Name，而不是从固定列表中挑选。这是使用自托管模型或较冷门服务商的方式。

自定义端点会跳过服务器代理

具名服务商都由服务器调用，所以你的浏览器从不直接与它们通信。自定义端点是唯一的例外：由于对一个任意 URL 没有内置的代理路由，发往它的请求会直接从你的浏览器发往你提供的地址，而它的密钥留在浏览器里，不会在服务器端加密。

更改或移除一个密钥

随时回到同一个服务商标签页，把新密钥粘贴覆盖旧的，或彻底删除它。删除一个密钥不会删除你已经用它生成的模型或对话，它只是让该服务商在你再次添加密钥之前无法使用。如果你删除的服务商正是当前的聊天服务商，请在回去聊天之前，先启用另一个已连接的服务商。

如果密钥不起作用

一次失败的 Test Connection 几乎总是意味着以下几种情况之一：密钥输错了或带有尾随空格，密钥属于同一家公司的另一款产品，或者密钥背后的账户在服务商那边还没有配置好配额或账单。服务商返回的错误消息会原样显示，所以在断定是应用的问题之前，先查看它。

故障排查

换新浏览器或设备后推理投入被重置

与你的 API key 不同，密钥经过加密并存储在服务器上，所以它会跟着你到任何你登录的设备；而你为每个服务商选择的推理投入等级只保存在当前浏览器的本地存储里。它不会带到另一个浏览器、另一台电脑或一个隐私窗口，在那些地方它会重新从 Default 开始。如果换了机器后你的回复忽然感觉变浅了，就在那里重新选择推理等级。你的密钥、模型和高级设置不受影响，只有推理等级是浏览器本地的。

每条 Test connection 消息的含义

Test connection 会把一个原始的服务商错误映射为一句简短、直白的消息，并按每账户每分钟 10 次进行限流。

消息	含义
Connection successful, key is valid.	密钥可用，服务商已应答。
Key saved (this provider has no live test)	fal.ai 和 BytePlus 没有可供廉价探测的端点，所以只能确认密钥被保存了。
No test for a custom provider, try it in chat	自定义端点没有测试动作；发一条聊天消息来检查它。
Key is invalid, you may have copied it incompletely	服务商拒绝了该密钥（一个 401 或 403 类型的错误）。请完整地重新复制。
Provider is busy (429), try again shortly	服务商返回了限流（429）。稍等片刻再重试。
Could not reach the provider (network/CORS)	一次网络或 CORS 故障导致请求没能送达。
Save your key first.	还没有保存可供测试的密钥。
Too many tests, try again in a minute.	你在一分钟内超过了 10 次测试；稍作暂停再试。

删除密钥不会移除你创作的内容

移除一个服务商的密钥，只会停止对它发出新请求。你生成的图片和片段图库，以及你已经进行过的对话，都会原样保留。确切步骤参见上文更改或移除一个密钥。

相关内容

• 自带 AI 密钥
• 服务商与模型对照表
• 使用 AI 聊天
• AI 聊天助手，同一套设置在编辑器内的版本