模型目录

模型目录维护企业可以提供的模型。主模型用于成员日常选择；专项模型用于视觉理解、语音或多媒体任务。模型连接配置完成后，还需检查模型策略组是否向目标成员开放。

仅开通企业 BYOK（自带模型密钥）功能的客户可添加自定义模型。未开通时，模型目录提供官方模型，不能添加企业自定义模型。千问办公积分与外部模型服务费用应分别核对；外部服务的用量和费用请在对应服务平台查看。

查看与配置主模型

1. 进入 AI 管理 → 模型管理 → 模型目录，选择「主模型」。
2. 查找模型，检查来源、上下文尺寸上限、说明和启用状态。官方主模型由平台提供，部分状态操作不可更改。
3. 点击模型的【配置】，维护允许修改的展示名称、说明和上下文上限。
4. 保存后检查列表显示，再到客户端查看该模型的名称和说明。

添加企业自定义主模型

适用条件：企业已开通 BYOK 功能，且当前管理员具有模型管理权限。

开始前向模型服务提供方取得完整接口地址、API Key、模型 Key 和支持能力。API Key 是调用密钥；服务端模型 Key 是接口请求中识别模型的名称，不等同于成员看到的展示名称。

1. 在「主模型」点击【新增自定义模型】，进入配置页。
2. 填写「完整 Endpoint」，应是可以直接接收 Chat Completions 请求的完整地址，例如 https://api.example.com/v1/chat/completions。只填写网站首页或服务基础地址可能不能完成请求。
3. 填写 API Key、企业展示名称和服务端模型 Key，选择服务实际支持的上下文上限。
4. 按模型能力设置推理、视觉理解等选项，不要仅为显示入口而勾选服务不支持的能力。
5. 如启用向模型传入第三方用户 ID，先确认企业确实需要向该服务传递此标识。
6. 点击【测试并保存】，修正连接或凭据错误后再次测试。保存成功后确认启用状态和开放策略。

私网 HTTP(S)、IP 和自定义端口可按服务实际地址填写，但要确保调用链路能访问。新建模型测试并保存后处于未启用状态，需要回到列表手动开启。

注意： 已启用的自定义模型只能修改展示资料。修改 Endpoint、API Key、上游模型名称或重新测试连接前，须先停用模型。

修改 Endpoint 时，按变化范围处理凭据：

• 协议、主机或端口改变：必须重新填写 API Key。
• 仅修改同一协议、主机和端口下的路径：可以保留已有凭据。

界面掩码不能作为真实密钥提交。

配置专项模型

1. 切换到「专项模型」，选择视觉理解、语音输入、语音润色、图像生成、视频生成或音乐生成分组。

查看当前生效的官方或企业模型。仅已开通企业 BYOK 功能的客户可添加企业自定义专项模型；需要接入时点击【添加模型】，按该分组要求填写配置并测试。

2. 切换生效模型后，用相应任务验证，例如上传一张图片测试视觉理解，不能只验证普通文本问答。

更新凭据或移除模型

凭据更换后重新测试并保存，再检查实际调用。删除自定义主模型会同时清理策略组中的相关引用；操作前确认成员有其他可用模型。当前生效或被限制删除的专项模型，先按页面提示切换到可用替代项。

客户端看不到模型

依次检查模型本身是否启用、用户命中的策略是否允许，以及是否存在黑名单限制。连接测试通过只能说明测试范围内的配置可用，不能证明每个成员都有使用权限。

返回：模型管理-概述