自带 AI 密钥
AI 功能基于一条原则：你自带提供商密钥，且你的密钥保留在服务端。你永远不会被锁定在单一模型中，也永远不会为应用在提供商的定价之上支付加价。
工作原理
你为已使用的提供商连接一个 API 密钥，包括 OpenAI、Anthropic、Google、Qwen、DeepSeek、Kimi、GLM，或自定义的兼容 OpenAI 的端点（用于聊天），以及 BytePlus 和 fal.ai（用于图像和视频）。当你在工作区中使用 AI Studio 时，应用会代表你从服务器调用该提供商，因此你的密钥永远不会到达页面。编辑器内助手 的工作方式不同：它将你的密钥保留在浏览器中，并直接从那里调用提供商。无论哪种方式，你都会根据实际使用量，按照该提供商的自身费率直接向其付费，并且你可以随时切换提供商。
| 步骤 | 详情 |
|---|---|
| 连接 | 在 AI 设置 中添加提供商密钥 |
| 测试 | 确认密钥有效后再依赖它 |
| 使用 | 聊天、生成图片和视频 |
| 切换 | 随时根据任务切换提供商，每个密钥记住自己的模型和设置 |
你的密钥受到保护
将提供商密钥视为密码
在 AI Studio 中，你的 API 密钥在静态时加密，且永远不会返回给浏览器，所有提供商调用都通过服务器进行，因此你的密钥不会暴露给页面或其他用户。有两个例外：自定义端点没有内置的服务器代理，因此这些请求直接从你的浏览器发送到你提供的地址；另外编辑器内助手 将你的密钥保留在浏览器中，并直接调用提供商，而不是通过服务器。请将这两点视为仅在受信任的设备上连接密钥的理由。
哪些功能需要密钥
| 功能 | 密钥 |
|---|---|
| 聊天、图像和视频生成 | 你的 AI 提供商密钥 |
| 技能和技能包 | 依附于当前激活的提供商密钥，无需单独的密钥 |
| 素材搜索 | 你自己的素材提供商密钥，独立于你的 AI 密钥 |
你可以在 AI 设置 中连接提供商和密钥。完整设置请参见 AI Studio 和 提供商与模型矩阵 以了解各自覆盖范围。
获取密钥
每个提供商从其自己的开发者控制台或平台站点颁发密钥，完全在应用之外；你直接在那里注册并将密钥复制到 AI 设置 中。大多数提供商在需要在其侧添加账单之前，提供免费或试用层级供你起步。
分步指南：连接你的第一个提供商密钥
- 从聊天提供商（OpenAI、Anthropic、Google、Qwen、DeepSeek、Kimi 或 GLM 均可）的网站获取 API 密钥，或指向你已运行的任何兼容 OpenAI 的端点。
- 从你的账户菜单中打开 AI 设置，并在该提供商下添加密钥。
- 在依赖密钥之前，使用密钥旁边的 测试连接 操作。这会完全在服务器上使用你的密钥向提供商发起一次小型、廉价的调用，这样你可以立即发现密钥是否正确，而不是在生成过程中才发现。少数仅用于图像或视频的提供商没有轻量级端点可供测试；对于这些，成功保存即可视为确认。
- 打开 AI Studio 或编辑器内助手并开始聊天，它会使用你上次为该对话选择的提供商和模型。
- 如果你还需要图像或视频生成，请单独为图像和视频提供商添加一个密钥（与聊天提供商分开）；它们的连接方式相同，但账单和配置各自独立。
常见任务
在任务中切换提供商。 随时从聊天编辑器更改当前使用的提供商和模型；每个提供商保持自己上次使用的模型和设置，因此切换回去时会直接恢复你上次使用该提供商时的状态。
指向自托管或本地模型。 将其作为自定义端点添加，提供基础 URL 和密钥。如果该端点是本地地址而非公开的 https 地址，则请求会直接从你的浏览器发送到该端点，而不是通过服务器——这对于运行在你自己机器上的情况是预期的。只能通过公共主机的 https 访问的自定义端点可能目前无法通过服务器代理工作；如果托管的自定义端点无法连接，很可能就是这个原因。请尽可能使用主列表中的聊天提供商。
为不同类型的生成使用不同的密钥。 聊天、图像和视频各自读取其连接的提供商；不要求三者使用同一家公司，可以根据每个方面的最强或最便宜来选择。
在生成视频前预览成本。 视频生成流程会在你提交运行之前，根据提供商的每秒或每模型费率以及你选择的时长，显示估算成本。参见 生成视频。
故障排除
- 刚添加的密钥显示无效。 请仔细检查你复制了整个密钥，没有尾随空格，并且在提供商的仪表板上该密钥处于激活状态，而不仅仅是已创建。在假设应用有问题之前，使用测试连接操作来确认。
- 生成中途因提供商错误而失败。 这几乎总是提供商自身的问题——速率限制、密钥过期或在其侧计费不足，应用无法绕过。请查看该提供商的仪表板以了解使用情况和计费状态。
- 你期望看到的模型未提供。 可用模型因提供商而异，视觉（图像理解）支持仅限于提供商内的特定模型。请查看 提供商与模型矩阵 以了解每个提供商当前暴露的模型。
- 通过公共主机的 https 访问的自定义端点无响应。 服务器端代理出于安全原因仅转发到固定的已知提供商列表；任意公共 https 端点不会自动包含在该列表中。本地非 https 端点是支持的自定义端点情况，它会直接从你的浏览器连接。
为什么要自带密钥
托管式密钥意味着应用会吸收你生成的每一个 token、图像和视频秒数并加价，同时将你绑定到平台选择提供的模型。自带密钥意味着你的 AI 成本会根据你的实际使用量，以你的提供商的实际价格扩展，并且你可以在某个提供商变得有用时立即添加，而无需等待平台添加。
托管式 AI
计划提供托管选项，即平台在你无需自带密钥的情况下提供 AI。目前，AI 完全基于你自己的密钥运行。参见 路线图。