注册模型与团队授权

Clouisle 的模型分两级：平台管理员先在管理后台 > 模型登记全局模型（供应商、模型 ID、凭据、能力、价格），再把模型授权给团队并设置配额。团队看到的模型页、Agent 与工作流里的模型选择器，只列出本团队已授权的模型。

登记全局模型

进入管理后台 > 模型，点击添加模型。表单分基本信息、参数设置、高级配置三块；填完先点测试连接，通过后再保存。保存成功后列表出现该模型，默认状态为已启用。

基本信息

参数设置

• 上下文长度与最大输出长度只用于展示和容量判断，不会强制截断；实际输出上限仍可被 Agent 设置或单次调用覆盖。
• 输入价格与输出价格按「美元 / 百万 Token」记录，只用于展示，不参与计费或配额计算。
• 推理参数（频率惩罚、存在惩罚、默认最大 Token 数）留空即使用供应商默认值。
• 输入模态与输出模态声明模型能接受、能生成的内容类型（文本、图像、音频、视频、文件）。勾选图像输入后，对话里才允许传图；输出模态只是声明，不会自动开启图片或视频生成。
• 模型能力三个开关见下文模型能力。

高级配置

按供应商与模型类型出现不同分区：思考 / 推理（启用思考、思考预算、推理强度）、图像生成设置、视频生成设置、音频设置、Azure 配置（API 版本、部署名称），以及额外请求体、默认参数扩展、配置扩展三个 JSON 输入框，用于补充供应商专属参数。常见组合：

精确字段名、取值范围与默认值见模型定义字段。

自动发现可用模型

新建模型时，填好供应商、API 地址与 API Key（Ollama 等本地供应商不需要 Key）后，表单会自动向供应商拉取可用模型列表：模型 ID 输入框变成可搜索的下拉，展开就能看到供应商返回的模型（显示为「名称 (ID)」）。选中后，模型名称、上下文长度、最大输出长度、输入与输出模态、能力开关都会自动回填，省去手写模型 ID。输入框下方会显示拉取中、成功或失败状态。

• 只在新增时自动拉取；编辑已有模型时不会重新拉取。
• 供应商没有模型列表接口时（如 Azure OpenAI、Runway、Pika、Luma、Kling、Stability AI、Midjourney）不会出现列表，手工填写模型 ID 即可。
• 拉取失败只影响便利性：手工填对模型 ID 仍可正常保存和使用。
• 拉取所用凭据只用于本次请求，不会因此被保存。

支持范围、地址规则与失败原因见远程模型发现。

凭据与请求地址

• API Key 加密保存。保存后任何页面都只显示「API Key 已配置」，不再显示明文；轮换时在编辑表单填入新值，留空表示保持不变。
• Key 格式有约定：OpenAI 系需 sk- 开头，Anthropic 需 sk-ant- 开头；明显不符时测试连接会直接提示格式错误。Ollama 是唯一不需要 Key 的供应商。
• 实际请求地址按「模型 API 地址 → 该模型类型的默认地址 → 供应商默认地址」逐级回落，且必须命中端点白名单。

模型能力

三个能力开关决定 Agent 与工作流能不能用上模型的特定行为：

给 Agent 启用工具前，先确认所选对话模型真的支持函数调用：新建模型时从模型 ID 下拉读取供应商声明，再手工校正。

测试连接

编辑弹窗里的测试连接会用当前表单内容向上游发一次最小请求，结果显示成功或失败，并给出延迟：

不同模型类型的测试动作：

启用、禁用与默认模型

在模型列表的行操作里可以直接启用 / 禁用，也可以在编辑弹窗里改状态与设为该类型的默认模型。

• 禁用是唯一的停用方式：模型从所有选择器里消失，但配置与团队授权都保留，重新启用即恢复。
• 默认模型按类型唯一：点设为默认会清除同类型其他模型的默认标记。知识库的嵌入模型、Agent 未指定模型时的兜底都依赖它。
• 列表支持按状态筛选，也可以批量删除。

授权模型给团队

只有超级管理员可以授权。步骤：

1. 进入管理后台 > 团队，打开目标团队。
2. 切到模型授权标签页，点击授权模型。
3. 在下拉里勾选一个或多个全局已启用的模型（已授权的不会重复出现），可一次授权多个。
4. 对每个模型填写每日 / 每月 Token 限额与请求限额，以及优先级；留空表示无限制。
5. 点击授权保存。

授权成功后，该团队成员在模型页即可看到这个模型。

• 一个团队对同一模型只有一条授权，重复授权会被拒绝。
• 已授权的模型可在编辑授权配置里改配额与优先级，或撤销授权。
• 团队管理员可以查看已授权模型与用量，但授权、改配额、撤销只有超级管理员能完成。

团队里能看到什么

• 团队的模型页列出全部已授权模型，包括被全局禁用的，可用状态筛选区分。
• Agent、工作流等处的模型选择器只列出「已授权且已启用」的模型。

配额与用量

四项限额都可以留空（无限制）；0 是合法值，等于立刻触顶。

判定方式不同，配置时注意：

• Token 限额在「已用 + 本次预估」超过限额时才拒绝，恰好等于限额不会立刻失败。
• 请求次数限额在「已用 ≥ 限额」时拒绝：第 N 次请求（N 等于限额）仍可成功，第 N + 1 次被拒。
• 用量按站点时区重置：每日 0 点、每月 1 日 0 点之后，下一次检查配额时归零。
• 触顶时对话会提示「模型配额已用尽」，需要调大限额或等下次重置。

授权列表里的进度条只按 Token 限额计算；请求次数是否超额，需要自己对比已用请求数与每日 / 每月请求限额。

优先级

优先级默认 0，只影响同类型模型在选择器里的排序，不改变可用性：数值越大越靠前。修改配额时会在同一个编辑授权配置弹窗里一起改。

修改、撤销与删除

常见问题

测试连接失败

1. 检查白名单：自定义 API 地址的「协议 + 主机 + 端口」是否已在站点设置 > 安全 > 模型端点白名单里；非标准端口（如 :11434）也会参与比对。
2. 检查 Key 格式：OpenAI 系需 sk- 前缀，Anthropic 需 sk-ant- 前缀；确认 Key 未过期且有目标模型权限。
3. 检查供应商与类型是否匹配：如 Anthropic + 嵌入、Stability + 文生视频，保存时可能通过，调用时才报不支持。
4. 检查网络：默认 15 秒超时、不跟随重定向；内网地址确认可达。
5. 检查上游状态：供应商限流或故障也会表现为测试失败，但限流通常仍提示连接成功。

提示模型配额已用尽

1. 打开管理后台 > 团队 > 目标团队 > 模型授权，看哪个限额触顶。
2. 调大限额、换用未触顶的同类型模型，或等次日 / 次月重置。
3. 若怀疑误判，检查是否有单次超大请求：Token 限额按「已用 + 预估」判断。

响应缓慢或超时

1. 核对上下文长度与最大输出长度，过大的输出上限会明显拉长响应。
2. 降低 Agent 的最大 Token 数、打开流式输出，或改用更快的模型。
3. 视频类模型出片慢于测试等待时间时，会在测试阶段报超时。

相关页面

• 供应商、模型类型与模型发现 — 23 个供应商、默认地址与发现规则
• 模型 — 两级结构与配额概念
• 团队与成员 — 成员角色、模型授权与团队所有权
• 模型 API — 以程序方式注册、测试与发现模型
• 团队模型授权 API — 授权、配额与用量接口