指南 · Beta

自带密钥

在你自己的 OpenAI 或 Anthropic 账户——或自托管的兼容 OpenAI 的服务器——上运行 Sonny 的 AI，AI 对话不限量。一次性 $249 解锁，无需额外订阅。下面介绍你能获得什么以及如何设置。

想了解完整介绍和费用对比？请参阅自带密钥概览。

解锁后你将获得

AI 对话不限量
每月对话额度不复存在。你的服务商按所选模型实际使用的 token 向你计费。
你的服务商，你的模型
连接 OpenAI、Anthropic（Claude），或任何兼容 OpenAI 的端点——包括自托管的 Ollama 或 vLLM 服务器。可以从精选模型中选择，或输入任意模型 ID。
掌控 AI 处理的地点
每一条面向客户的回复都在你的账户上、依据你与服务商的协议生成。非常适合自定义服务器环境和有数据驻留要求的场景。
密钥始终保密
你的 API 密钥会加密存储，且不会再次显示——只会显示类似“sk-a…4f2a”的提示，让你知道连接的是哪个密钥。
包含所有 AI 功能
自动回复、AI 回复草稿和润色都通过你的密钥运行。行为、置信度阈值和工作时间安排都与之前完全一样。
知识库依然全托管
你的知识来源仍由 Sonny 管理，不另收费。面向客户的回答由你连接的服务商生成。

设置步骤

  1. 01

    解锁自带密钥

    打开 AI Copilot，找到 AI 引擎卡片。在自带密钥（BYOK）下选择以 $249 解锁。每个工作区购买一次，且只有工作区所有者可以购买。

  2. 02

    设置你的密钥

    选择设置你的密钥，打开连接你自己的 AI。在服务商下选择 OpenAI、Anthropic (Claude) 或 OpenAI-compatible（兼容 OpenAI）。填写 API 密钥并选择模型。兼容 OpenAI 的服务器还需要填写最终可公开访问的 HTTPS 端点 URL；如果服务器使用 /v1 路径，请一并填写。如果你的代理需要，还可以添加 Basic Auth 或自定义访问请求头。

  3. 03

    测试连接

    选择测试连接。连通性检查 Sonny 能否访问服务商并通过认证。工具调用检查模型能否搜索知识并转交给同事。两项都通过后才能启用连接。

  4. 04

    保存并启用

    选择保存并启用。AI Copilot 页面会显示使用你的密钥运行。之后可以通过管理连接更改服务商、凭据或模型。

关于费用

你的具体费用取决于服务商、模型和 token 用量。请查看服务商当前的价格，然后在其用量仪表板中追踪对话的实际花费。

须知

我的自托管端点必须使用 HTTPS 吗？
是的。对于自托管服务商，Sonny 只接受公开的 https:// URL。如果你之前连接的是 http:// 端点，该连接已被关闭，你会在 AI Copilot 设置中看到提示：请将服务器置于 HTTPS 代理之后，然后重新输入 URL 以重新启用。
我能保护公开的 Ollama 服务器吗？
能。Ollama 的本地 API 本身不会认证请求，因此请将其置于 HTTPS 反向代理之后，并在 Sonny 中填写该端点的 HTTP Basic Auth 凭据。你还可以为 Cloudflare Access 等网关添加最多 10 个只写的自定义请求头。当代理负责认证时，API 密钥可以留空——Basic Auth 会取代 Bearer API 密钥认证，因此占位密钥永远不会被发送。如果你的网关两者都需要，请将其 API 密钥配置在另一个自定义请求头中。凭据和请求头的值都会加密，且绝不会返回到你的浏览器。
如果我的密钥失效了会怎样？
客户绝不会被晾在一边。如果服务商拒绝了请求——密钥过期、触发频率限制、服务器宕机——自动回复会立即把这些对话转给你的团队，工作区所有者也会收到附带错误信息的通知。修复密钥（或切回 Sonny AI）后，一切照常恢复。
可以切回 Sonny AI 吗？
随时可以。卡片上有一个开关——关闭后 Sonny AI 会立即接管（需有生效的 AI 套餐）。你的密钥和设置都会保留，一键即可切换回来。你甚至可以同时保留 AI 套餐和 BYOK；启用的那一个负责回复。
应该使用哪些模型？
请使用快速且支持工具调用的模型，例如 Claude Haiku 级别或 OpenAI mini 级别的模型。较小的自托管模型也能用，但回答质量会较低，升级处理也不够可靠；内置的工具调用测试会告诉你某个模型是否胜任。
知识库页面还有上限吗？
有——BYOK 包含 5,000 个页面的知识上限，因为 Sonny 会继续独立于服务商用量来管理你的知识来源。如果你同时拥有上限更高的 AI 套餐，则以更高的上限为准。
我的 API 密钥安全吗？
你的凭据会加密存储，保存后不会再次显示，并且只在 Sonny 向你配置的服务商发送请求时使用。自托管端点 URL 仅限于你配置的公开 HTTPS 端点。

相关文档

看看 Sonny 能帮你做什么