云服务
概述
云服务用于让私有部署环境调用 HAP SaaS 侧提供的服务能力。
目前仅支持 AI 模型服务。私有部署环境配置云服务密钥后，即可使用 SaaS 侧提供的 AI 模型。调用产生的费用从密钥所属 SaaS 组织的信用点中扣除，私有部署环境无需单独结算。
云服务适用于以下场景：
- 私有部署环境需要使用明道云提供的 AI 模型
- 企业需要在 SaaS 侧统一管理云服务密钥和信用点消耗
- 企业需要通过密钥和 IP 白名单控制私有部署环境的调用权限
云服务的使用流程概述：
- SaaS 组织管理员创建云服务密钥
- 私有部署管理员将密钥配置到私有部署环境
- 系统验证密钥并初始化 AI 模型服务
- 私有部署用户在相关功能中使用 AI 模型
- SaaS 侧完成模型调用和信用点扣费
云服务费用从创建密钥的 SaaS 组织中扣除。
SaaS 侧：管理云服务密钥
使用条件
SaaS 各版本均支持云服务密钥功能。
免费版组织需要先完成企业认证，认证后才能创建密钥。
创建密钥
操作步骤：进入【组织管理】>【集成】>【云服务】，点击【创建密钥】。
创建时需要配置以下内容：
- 密钥名称：必填，用于标识密钥的使用环境或用途
- 授权服务：当前仅支持 AI 模型服务，不支持修改
点击【创建】后，系统生成密钥并提供复制按钮。复制密钥后，将其提供给私有部署管理员进行配置。
请在创建后及时复制并妥善保管密钥。关闭页面后，无法再次查看完整密钥。
配置 IP 白名单
在密钥列表中，点击对应密钥的【IP 白名单】，设置允许使用该密钥的 IP 地址。
- 一个密钥可以设置多个 IP 地址，并支持后续修改
- 多个 IP 地址可以换行输入，也可以使用英文逗号分隔
- 配置后，只有来源 IP 在白名单中的请求才能使用该密钥调用云服务
查看和管理密钥
密钥列表中展示以下主 要信息：
| 字段 | 说明 |
|---|---|
| 密钥名称 | 密钥的自定义名称，支持修改 |
| 密钥 | 加密显示的密钥信息 |
| 授权服务 | 密钥可以调用的云服务，当前为 AI 模型服务 |
| 最近使用时间 | 密钥最近一次被使用的时间 |
| 信用点消耗 | 通过该密钥累计消耗的信用点 |
| 状态 | 禁用、启用状态 |
| 操作 | IP 白名单、编辑、启用、禁用和删除等操作 |
启用、禁用和删除密钥
一个 SaaS 组织可以创建多个云服务密钥。
- 启用：允许私有部署环境使用该密钥调用云服务
- 禁用：暂停该密钥的调用权限，后续可以重新启用
- 删除：删除密钥，删除后该密钥无法继续使用
禁用或删除密钥后，已经配置该密钥的私有部署环境将无法调用云服务。
私有侧：云服务接入
私有部署社区版和平台版不支持接入云服务。
配置密钥
配置步骤：
- 私有部署管理员点击头像，进入【平台管理】>【集成】>【云服务接入】
- 填入 SaaS 组织管理员提供的密钥
- 根据私有部署环境的网络情况配置代理服务
- 保存配置
配置时需要注意以下规则：
-
每个私有部署环境只能配置一个云服务密钥
-
所有云服务统一使用此处的代理服务配置，不需要在各功能中单独配置
-
密钥包含的服务发生变化后，需要在私有侧更新密钥，才能调用新增的服务
更新密钥
需要更换密钥或更新密钥包含的服务时，在【云服务接入】页面重新填写密钥并保存。
新密钥验证通过后，系统将使用新密钥调用云服务。
AI 模型初始化
云服务密钥验证成功后，系统会自动创建“明道云”供应商及当前支持的 AI 模型。
自动生成的厂商和模型具有以下规则：
- 不支持编辑或删除
- 默认排列在厂商和模型列表的最后
- 支持设置 为隐藏或显示
- 同步模型时，不会同步模型的排序
- 同步模型时，不会改变模型当前的隐藏或显示状态
使用 AI 模型服务
配置完成后，可以在支持选择 AI 模型的功能中使用明道云模型。
例如，在工作流的 AIGC 节点中选择 AI 模型：
用量与扣费
私有部署环境调用 AI 模型时，SaaS 侧按照实际 Token 用量计算费用，并从云服务密钥所属 SaaS 组织的信用点中扣除。
登录 HAP SaaS 平台，进入【组织管理】>【账务】，可以查看云服务产生的消费明细。
云服务产生的扣费类型显示为：云服务（AI 模型服务 - 密钥名称）。
通过密钥名称，可以识别不同密钥产生的信用点消耗。
出现以下情况时，云服务调用可能被拦截：
- SaaS 组织信用点余额不足
- 超出服务额度限制
- 密钥被禁用或删除
- 调用 IP 不在密钥的 IP 白名单中
- 请求触发云服务风控规则
这篇文档对你有帮助吗？