AI 模型与自有密钥
面板中的 AI 在多处发挥作用：商品与菜品描述、回复客人、通话分析、教学材料整理、各板块助手。默认情况下，每项任务的模型由我们选择——对大多数人来说这已经足够。
“AI 模型（LLM）”板块适合希望自行决定的人：由哪个服务负责账户的助手功能，以及它使用哪个模型。如果你已经与提供商签有合同，可以接入自有密钥，调用将通过它进行。
打开方式：扩展商店中的**“AI 模型（LLM）”卡片（“账户”类别）→ admin.cenaly.com/ai-models。该板块在菜单中没有自己的入口——这不是错误，入口只有一个，就在商店里。该板块仅账户所有者**可访问。
这个板块有什么用#
| 场景 | 该怎么做 |
|---|---|
| “让它自动运行就好” | 什么都不用做：可以不打开该板块，平台会自行按任务选择模型 |
| “希望由特定模型来回答” | 接入现成服务并将其设为偏好 |
| “我们与提供商有合同／有自己的推理服务” | 添加自定义连接，使用自己的地址和密钥 |
| “需要了解 AI 积分花在哪里” | 查看订阅页面上的余额卡片 |
启用需要什么#
| 项目 | 用途 |
|---|---|
| 你是账户所有者 | 该板块仅限所有者，且由服务器校验，而不只是界面 |
| 扩展商店中的卡片 | 这是进入该板块的唯一入口；接入卡片本身不单独收费 |
| 自有密钥需要——兼容 OpenAI 的端点 | 需要地址（base URL 含版本号，仅限 https）、API 密钥和模型 id |
| AI 余额——用于现成服务 | 它们通过我们的基础设施运行，按实际使用量以 AI 积分计费 |
第 1 步。接入现成 AI 服务#
页面第一个区块是**“Cenaly AI 服务”**：ChatGPT（OpenAI）、Gemini（Google）、Grok（xAI）和 DeepSeek。一键接入：
- 在所需服务旁点击**“接入”**——无需 API 密钥，请求通过我们的基础设施发出。
- 已接入的服务会出现**“模型”**一行——从该服务的列表中选择具体模型（每个服务的列表各不相同，且会不时更新）。
- 不需要的服务可通过**“断开”**按钮关闭。
付费使用账户的 AI 积分，与任何其他 AI 功能一样：不会出现“接入 ChatGPT”的单独账单，你只为实际调用付费。
第 2 步。接入自有密钥#
第二个区块是**“自定义 LLM”**。它适合已有模型访问权限的人：与提供商签有合同、有企业网关，或部署了带兼容 OpenAI API 的自有模型。
- 点击**“添加自定义 LLM”**并填写：名称（便于你识别）、Base URL API——含版本号的地址，例如
https://api.example.com/v1（仅限https）、API 密钥、模型——该提供商处的模型 id。 - 点击**“检查连接”**——会发出测试请求，你将看到带延迟测量的“连接正常”，或失败原因。检查在保存前和已保存的记录上均可使用。
- 点击**“添加”——连接会出现在列表中。可通过开关临时停用或删除**（需确认：删除记录的同时也会删除已保存的密钥）。
密钥如何存储：它保存在服务器上，不会返回浏览器——界面中只显示“API 密钥已保存”的标记和掩码。可以替换密钥，但无法从面板中读取它。
费用方面：通过你的密钥进行的调用不扣除 AI 积分——你直接向自己的提供商付费。但如果你的端点没有响应，调用不会失败：它会走平台常规队列——而这次调用就会按积分计费。如果在预料之外的地方看到消耗，请检查自己端点的可用性。
连接可以有多个（最多十个）——例如为不同实验使用不同模型；只有开关打开的那些才会工作。
第 3 步。选择偏好模型#
第三个区块是**“偏好模型”**，这是针对整个账户的切换开关：
- “默认（按任务推荐）”——平台自行选择模型，按每项功能分别选择。这是初始状态；
- 具体服务或自定义连接——助手功能将优先使用它。
选择偏好后的尝试顺序：先调用你的自定义端点（如果偏好的是它），然后是按所选模型进行的平台调用，最后是常规备用路径——以免功能因某个提供商不可用而“停摆”。
⚠️ 该选择并非在所有 AI 功能中生效——详情见“限制”。
在哪里查看消耗#
AI 消耗位于订阅页面，有两张卡片：“LLM 积分”——AI 任务余额，以及**“AI 支出”**——按功能统计的月度支出、月底账单预测和月度上限。按行可以看到具体是哪项功能在消耗：描述、通话、翻译、培训。
通过你自己的密钥进行的调用不会出现在那里——这类调用不消耗我们的余额。
限制#
- 选择在
cenaly.ru上不生效。 在俄罗斯环境中，AI 功能基于 YandexGPT 运行，本节的设置在那里不会被读取：页面可以打开并保存，但无人应用。这是数据处理要求的结果，而非被遗忘的设置。 - 选择对带工具的调用不生效。 部分功能采用“模型 + 工具”的结构——访客聊天 AI 机器人、面板副驾驶、邮件中的写信助手。它们基于各自的模型运行，与这里的选择无关。
- 本节仅限所有者。 员工不会在菜单中看到它，通过直接链接会看到带“重试”按钮的加载错误页面，而不是礼貌的“无访问权限”——我们知道，正在修复。
- 自定义密钥既无有效期，也无自动轮换。 在服务商处更换密钥后，请在此处也更换，否则调用将开始走备用路径（并消耗积分）。
- 仅支持 OpenAI 兼容 API，且仅支持
https。 端点需连同路径版本一起填写；不支持任意协议和自定义响应格式。 - 我们不知道您服务商的模型列表——模型 id 需手动输入，来自服务商文档。
- 现成服务有四个。 ChatGPT、Gemini、Grok、DeepSeek；其余通过自定义连接。
故障排除#
| 症状 | 请检查 |
|---|---|
| “检查连接”返回错误 | 地址必须完整，包含版本（…/v1）且使用 https；密钥有效；服务商已开放外部地址访问 |
| 连接正常，但回答“和以前一样” | 该功能可能属于绕过选择的那类（聊天机器人、副驾驶、邮件写信助手）；或者账户运行在 cenaly.ru 环境中 |
| 已连接自己的密钥，但仍在消耗积分 | 您的端点无响应，调用走了备用路径。用按钮检查连接，并查看“AI 支出”中的记录 |
| 字段中的密钥显示为星号 | 这是设计如此：密钥存储在服务器上，不会返回。需要更换时，输入新密钥 |
| 员工看到“无法加载 LLM 设置” | 本节仅对账户所有者开放 |
| 菜单中找不到该页面 | 菜单中确实没有：只能从扩展商店中的“AI 模型（LLM）”卡片进入 |
按症状的通用排查——故障排除；如果都无效，请写信给我们——如何获取帮助。
常见问题#
到底需要进入本节吗？#
不需要。没有它一切照常运行：平台会为每项任务自动选择合适的模型。只有当您想自行选择模型或连接自己的密钥时，才需要本节。
使用 AI 需要自己的 OpenAI 密钥吗？#
不需要。现成服务一键连接，通过我们的基础设施运行，费用以账户的 AI 积分支付。自己的密钥是替代方案，而非必需条件。
自己的密钥更便宜吗？#
取决于您与服务商的合同。从技术上讲，这是“绕过我们的账单”：此类调用不扣除 AI 积分，您直接向服务商付费。
谁能看到我的 API 密钥？#
界面上任何人都看不到：密钥写入服务器后不会返回浏览器——您只会看到已保存的标记。本节仅对账户所有者开放。
可以为不同功能选择不同模型吗？#
不可以，每个账户只能有一个偏好。为不同任务使用不同模型，正是平台自动选择的“默认”模式。
为什么在 cenaly.ru 上选择不生效？#
俄罗斯环境基于 YandexGPT 运行：数据不会离开该环境，因此外部服务商和自己的端点在那里无法连接。
如果我的端点暂时不可用会怎样？#
功能不会中断：调用会走平台常规队列——并按 AI 积分计费。请求不会无声丢失。
“AI 模型”卡片本身收费吗？#
连接卡片没有单独费用——您只需为通过我们基础设施实际使用模型付费。