License使用指南
概览
多模态大模型互动服务助力开发者快速构建终端设备与大模型实时音视频对话能力。终端使用多模态大模型互动服务时,需要先进行服务激活和鉴权操作。license资源类型下,license文件中的licenseKey是用户在激活时的有效凭证。
重点概念
服务激活: 终端设备激活多模态互动服务权限,设备激活后才能持续访问多模态互动服务。激活将消耗license激活次数
服务鉴权: 终端设备连接到多模态互动服务时,检查该设备能使用哪些服务资源,如音乐资源、TTS权限等。(设备能使用哪些资源,受license和app联合控制。音乐等资源需要在购买license资源时购买)
License资源: 多模态大模型互动服务的一种资源形态(后续还有时长类型、并发类型)。license资源模式下,用户通过license文件中的licenseKey来进行服务激活服务和服务鉴权,首次激活将消耗license资源中的激活次数
激活标识:多模态大模型互动后端通过 licenseKey + appId + deviceId 唯一标识一次激活。每次激活消耗一次license资源中的激活次数,激活后的设备在资源有效期内,能进行服务访问
license有效期: 用户购买资源时,购买的license资源有效期。只有license资源在效期内,用户才能进行设备激活
激活有效期: 设备激活后,能正常使用服务的有效时间。从设备激活时间开始,终端设备能使用的多模态大模型互动服务的有效时长。例:用户在2025年1月购买1年期的license资源,终端设备在2025年5月激活,终端设备的激活有效期为25年5月至26年5月
方案概述
交互概览
整体交互图如下所示,license在 “5、终端连接互动实例” 起作用。只有有效的licenseKey和AppId才能通过激活和鉴权
资源购买与绑定
资源购买:
多模态大模型互动服务需要购买资源后使用。其中,license是资源的一种形式,可以在用户控制台进行资源购买。购买过程中,需要确定如下相应配置
资源绑定:
考虑到一个用户会有多个app用于不同商品类别或者批次的场景,故设计了license资源绑定app机制。license资源购买后,需要进行app绑定(即给不同app分配特定激活次数。各App所分配的总激活次数不能超过购买的资源量;不同app间的激活次数不能混用,请提前对各个App的终端设备量做好预估)。App绑定通过用户控制台 “绑定应用” 操作。注意,只有“生效中”状态的资源才能进行App绑定和资源使用
资源使用
原理:
如交互概览图所示,在终端与大模型互动后端连接过程中,需要使用licenseKey来进行服务激活和鉴权。设备在第一次连接互动实例时,大模型互动后端会根据license有效期配置号设备的激活有效期。在激活有效期内,终端能正常访问大模型互动服务。终端设备每次连接都需要进行服务鉴权,确认终端能使用哪些服务能力(例如音乐、TTS等)。
多模态互动后端根据 licenseKey + appId + deviceId 唯一确认一次有效激活,并消耗对应license的激活次数。由于deviceId可读性较低,为了方便用户后续进行数据核对,还需要传递用户系统中的userId来标识终端设备。 注意:一个终端使用不同licenseId、或不同AppId连接两次大模型互动实例,会被认为是两次不同的激活,分别消耗两个license各一次激活次数
使用方式:
- RTOS SDK:调用RTOS SDK初始化接口时,设置参数 appid,license_key,userId(deviceId由SDK自动获取或生成),服务初始化过程中会进行服务激活和服务鉴权。SDK详情见RTOS SDK
- Android SDK:调用SDK初始化接口时,设置参数 appId,licenseKey,userId(deviceId由SDK自动获取或生成),服务初始化过程中会进行服务激活和服务鉴权。SDK详情见Android SDK
- iOS SDK:SDK初始化时,设置参数 appId,licenseKey,userId(deviceId由SDK自动获取或生成),服务初始化过程中会自动进行服务激活和服务鉴权。SDK详情见iOS SDK
- H5 SDK:客户端接收到服务端下发的 授权请求(消息格式为:[E]:[LIC]:[MUST]:)后,需发送激活消息给服务器。激活消息格式为:[E]:[LIC]:[ACTIVE]:{"devId":"DDD","uId":"YYY","licKey":"XXX"}。请求参数中的devId,uId,licKey需要按实际值传递。步骤详情见H5 SDK
- Websocket API:客户端接收到服务端下发的 授权请求(消息格式为:[E]:[LIC]:[MUST]:)后,需发送激活消息给服务器。激活消息格式为:[E]:[LIC]:[ACTIVE]:{"devId":"DDD","uId":"YYY","licKey":"XXX"}。请求参数中的devId,uId,licKey需要按实际值传递。步骤详情见Websocket Api
- 微信小程序 SDK:客户端接收到服务端下发的 授权请求(消息格式为:[E]:[LIC]:[MUST]:)后,需发送激活消息给服务器。激活消息格式为:[E]:[LIC]:[ACTIVE]:{"devId":"DDD","uId":"YYY","licKey":"XXX"}。请求参数中的devId,uId,licKey需要按实际值传递。步骤详情见微信小程序 SDK
- HarmonyOS NEXT SDK:调用SDK初始化接口时,设置参数 appId,licenseKey,userId(deviceId由SDK自动获取或生成),服务初始化过程中会进行服务激活和服务鉴权。SDK详情见HarmonyOS NEXT SDK
常见问题
- license文件如何管理?
答: license文件/licenseKey管理方式由客户自行决定。可以直接烧录至终端设备也可以在用户后台动态管理。注意,烧录在终端设备情况下,终端licenseKey不太容易变更,在激活次数不足情况下,建议优先通过原有license扩容机制增加激活次数(新购license无法维持新资源licenseKey不变)。 - 终端设备重装后是否影响license激活次数 答: 大模型互动后端通过 licenseKey + appId + deviceId 唯一确认一次有效激活。RTOS设备上,deviceId由互动sdk自动获取芯片出厂编号等信息设置;Andirod、IOS、linux环境下,deviceId由互动sdk自动生成。设备重装后,这3个信息不变情况下,不影响激活次数。如果出现变化情况下,可通过销售联系产研协商处理
- 是否能切换激活标识? 答: licenseKey与AppId标识不能切换,如需要将deviceId标识切换为userId请与销售联系