模型目录

模型目录维护企业可以提供的模型。主模型用于成员日常选择；专项模型用于视觉理解、语音或多媒体任务。模型连接配置完成后，还需检查模型策略组是否向目标成员开放。 仅开通企业 BYOK（自带模型密钥）功能的客户可添加自定义模型。未开通时，模型目录提供官方模型，不能添加企业自定义模型。千问办公积分与外部模型服务费用应分别核对；外部服务的用量和费用请在对应服务平台查看。 ⚠️ BYOK 适用说明：BYOK（Bring Your Own Key，自带模型密钥）自定义模型能力仅限已开通 BYOK 权益的客户使用。如需开通，请咨询销售。BYOK 模型不适用千问办公-旗舰版的用量统计与限额管理；相关统计数据和限额规则不包含 BYOK 模型。用量和费用请在对应模型服务平台核对。

​

查看与配置主模型

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

管理后台：查看主模型及其来源和启用状态。

​

调整主模型顺序

1. 在「主模型」中清空搜索条件，并将来源筛选恢复为全部。
2. 拖动模型名称左侧的排序手柄，调整官方模型与自定义主模型的顺序。也可聚焦手柄后使用方向键或 Home、End；按 Esc 取消拖动。
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。
• 仅修改同一协议、主机和端口下的路径：可以保留已有凭据。

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

管理后台：已开通 BYOK 权益后填写自定义模型连接信息。

​

配置专项模型

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

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

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

管理后台：按能力类别查看和添加专项模型。

​

更新凭据或移除模型

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

​

客户端看不到模型

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