界面模式

ZAI 分为“开放平台”和“管理面板”两种界面模式，两者提供的功能不同。

开放平台

面向普通用户的界面。用户可以在这里测试大模型、获取 API 密钥，查看用量与使用日志，以及查看可用模型和应用集成信息。

在开放平台界面，点击页面右上角个人头像，打开个人菜单，点击“管理面板”即可进入管理面板界面。

管理面板

面向管理员的界面。管理员可以在这里管理 ZAI 服务，包括模型配置、集成管理、价格规则管理等。

在管理面板界面，点击页面左下角的“开放平台”按钮，即可进入开放平台界面。

用户管理

用户管理用于维护 ZAI 服务的用户，包括添加、编辑、禁用等。先进入“管理面板”，点击页面左侧的“用户管理”即可进入用户列表。

在用户列表可以查看所有用户信息，并可添加新用户、编辑已有用户信息，以及查看对应用户的使用日志。

模型配置

ZAI 自身不内置大模型，需要通过渠道接入第三方或本地模型。支持 OpenAI、Azure、DeepSeek 等在线接口，也支持 Ollama 本地模型接入。模型配置包含两部分：渠道管理与模型管理。

渠道管理

渠道管理是配置大模型接入的渠道，包括 OpenAI、Azure、DeepSeek 等在线模型接口，也支持 Ollama 本地模型接入。渠道管理需要先进入“管理面板页面”，点击页面左侧的“渠道管理”按钮，即可进入渠道列表界面。

渠道列表

渠道列表展示所有渠道信息，并可添加新渠道、编辑已有渠道信息，以及查看对应渠道的使用日志。

添加渠道

点击渠道列表右上方的“添加渠道”按钮，进入添加渠道页面，填写渠道信息后点击提交即可添加渠道。添加渠道信息时无须填写模型信息。

编辑渠道

点击渠道列表中对应渠道的“编辑”按钮，进入编辑页面，填写渠道信息后提交即可。

由于渠道会产生计费与日志，暂不支持删除渠道，但可在编辑界面将其禁用。禁用后，该渠道将无法使用。

查看渠道使用日志

点击渠道列表上对应渠道的“查看使用日志”按钮，即可查看该渠道的使用日志。

模型管理

模型管理用于维护 ZAI 服务可提供的模型，包括添加、编辑、删除等。进入“管理面板”，点击页面左侧的“模型管理”即可进入模型列表。

模型列表

在模型列表可以查看所有模型信息，并可添加新模型、编辑已有模型信息，以及查看对应模型的使用日志。

添加模型

点击模型列表右上方的“添加模型”按钮，填写模型名称后提交即可创建模型。

添加模型后，需要编辑模型进一步完善模型信息才可进行使用。

编辑模型

点击模型列表中对应模型的“编辑”按钮，进入编辑页面，完善模型信息后提交即可。请先确保已添加对应渠道。（ 注意这里模型映射要手动填写实际使用的模型名）

编辑模型时需要确定如下信息：

• 用户组：该模型向哪些用户组开放；
• 渠道：该模型通过哪些渠道提供。至少需要配置一个渠道，并设置该模型在对应渠道中的模型映射与优先级；
• 价格规则：该模型的能力、计费单位、价格与利润率。

删除模型

点击模型列表中对应模型的“删除”按钮，即可删除该模型。

查看模型使用日志

点击模型列表上对应模型的“查看使用日志”按钮，即可查看该模型的使用日志。

价格规则管理

在模型管理中，如未为模型配置价格规则，可在“价格规则”页面集中设置所有模型的计费规则。点击页面左侧的“价格规则”进入配置界面。

在这里可以对所有模型进行价格规则配置，包括计费单位、价格和利润率。

集成管理

完成渠道与模型配置后，若需要在其他应用中使用，则需进行集成并获取令牌以调用 API。进入“开放平台”，点击页面左侧的“集成”即可进入集成列表。

在集成列表可查看所有集成信息，并可添加新集成、编辑已有集成。

添加集成

点击集成列表右上方的“添加集成”按钮，进入创建页面，填写信息后提交即可完成创建。

添加集成需要确认如下信息：

• 集成 ID：用于唯一标识集成，在其他应用中调用时需要提供；
• 集成名称：用于人类可读的标识；
• 哈希令牌：用于调用普通 API 的令牌，可自定义或自动生成；
• 管理员令牌：用于调用管理 API 的令牌，可自定义或自动生成；
• 默认对话模型；
• 默认向量模型。

编辑集成

点击集成列表中对应集成的“编辑”按钮，进入编辑页面，完善信息后提交即可。

编辑集成所需填写的信息与创建时一致。

目前不支持删除集成，但可以在编辑界面将该集成禁用。禁用后，将无法使用其令牌调用相关 API。

API Keys

这里的key在添加集成后会自动生成，无需手动创建key。

使用 API

要使用 ZAI 服务，需要通过 API 调用。点击“开放平台”界面左下角的“文档”按钮，即可进入 API 文档。目前 ZAI 提供两类 API，可按需选用：

• 智能引擎 API：用于应用集成的 AI 聊天、知识库等有状态功能。支持流式响应、多模型切换和高级对话管理等；
• 聚合接口 API：使用与 OpenAI 兼容的 API 统一调用来自多渠道的 AI 模型，便于快速集成。

在禅道中使用

部署好 ZAI 服务后，在“管理面板”中进入“集成管理”，点击右上方“添加集成”，填写禅道集成信息后提交即可创建。

添加集成后，请妥善保存集成 ID、哈希令牌与管理员令牌，禅道 AI 功能配置时将使用。