AIUI文档中心
AIUI文档导览
1. AIUI平台服务
1.1 AIUI平台介绍
1.2 AIUI应用介绍
1.3 AIUI服务链路介绍
1.4 AIUI平台能力概述
1.5 快速体验
2. AIUI应用配置
2.1 应用发布
2.2 语义精简协议介绍
2.3 基础配置
2.4 语义模型配置
2.5 回复角色配置
2.6 语音识别配置
2.7 结构化语义配置
2.8 星火大模型配置
2.9 语音合成配置
2.10 应用后处理配置
2.11 三方大模型配置
2.12 流畅全双工交互配置
2.13 表情标签配置
2.14 长时记忆配置
2.15 声纹识别配置
3. AIUI SDK开发
3.1 AIUI SDK接入流程
3.2 AIUI SDK基础信息
3.2.1 SDK接口说明
3.2.2 参数配置说明
3.2.3 消息事件说明
3.2.4 SDK状态说明
3.2.5 数据发送方式
3.2.6 回调解析说明
3.2.7 交互结果协议说明
3.3 AIUI SDK基础能力
3.3.1 流式识别
3.3.2 离线识别
3.3.3 语音唤醒
3.3.4 语音合成
3.3.5 用户个性化
3.3.6 自定义参数
3.4 传统语义链路接入
3.4.1 链路配置说明
3.4.2 个性化数据使用
3.5 通用大模型链路接入
3.5.1 链路配置说明
3.5.2 个性化数据使用
3.5.3 超拟人合成
3.5.4 声音复刻
3.6 极速超拟人链路接入
3.6.1 链路配置说明
3.6.2 个性化数据使用
3.6.3 流式合成
3.6.4 声音复刻
3.6.5 RTOS系统SDK接入
3.7 错误码列表
3.8 发音人列表
4. AIUI API开发
4.1 传统语义链路
4.1.1 交互API
4.1.2 用户个性化API
4.1.3 合成能力使用
4.2 通用大模型链路
4.2.1 服务鉴权
4.2.2 交互API
4.2.3 用户个性化API
4.2.4 声音复刻API
4.2.5 合成能力使用
4.3 极速超拟人链路
4.3.1 服务鉴权
4.3.2 交互API
4.3.3 用户个性化API
4.3.4 声音复刻API
4.3.5 合成能力使用
4.3.6 声纹管理API
5. 自定义业务
技能工作室概述
名词解析
技能
意图和语料
实体
动态实体
模糊匹配
填槽对话
技能设计规范
语音技能设计规范
开放技能接入审核规范
开放技能图标图片规范
技能开发
创建技能和意图
意图配置
技能测试
技能发布
技能后处理
技能导入导出
云函数APIv2.1
云函数APIv2.0
智能体开发
智能体对接
问答库开发
语句问答
关键词问答
文档问答
设备人设开发
技能协议
语义协议:重要字段和通用字段
技能后处理协议:标准请求
技能后处理协议:请求校验
技能后处理协议:Request_v2.1协议
技能后处理协议:Response_v2.1协议
技能资源限制
6. 硬件模组
RK3328 降噪板
RK3328降噪板白皮书
RK3328降噪板使用手册
RK3328降噪板规格书
RK3328降噪板协议手册
RK3328 AIUI评估板开发套件
RK3328评估板白皮书
RK3328评估板使用手册
RK3328评估板规格书
RK3328评估板开发手册
RK3588s 极简通用多模态开发套件
RK3588s 极简多模态套件白皮书
RK3588s 极简多模态套件使用手册
RK3588 AIUI多模态开发套件
RK3588一体机多模态产品规格书
RK3588多模态套件使用手册
视频传输协议
识别语义传输协议
音频传输协议
AIUI类型消息事件
ZG803 离线语音识别套件
ZG803 产品白皮书
USB声卡套件
USB声卡产品白皮书
USB声卡使用指南
AC7911B AIUI语音开发套件
AC7911B-产品白皮书
AC7911B-快速体验指南
AIUI评估板接入
集成方式
软件包说明
AIUIServiceKitSDK
串口SDK
评估板参数配置
调试升级
7. 常见问题处理
7.1 AIUI常见问题
7.2 评估板常见问题
7.3 动态实体常见问题
8. 联系方式
9. 服务条款
AIUI开放平台服务协议
AIUI开放平台隐私政策
小飞在家用户协议
小飞在家隐私政策
小飞在家开源软件使用许可
讯飞账号隐私政策
讯飞账号用户协议
讯飞带屏音箱用户协议
讯飞带屏音箱隐私政策
AIUI SDK隐私政策
AIUI SDK合规使用说明
本文档使用 MrDoc 发布
-
+
首页
4.3.6 声纹管理API
## 1. 服务介绍 <div style="display: flex; align-items: flex-start; gap: 16px; padding: 16px; background: #fff5f6; border-radius: 5px; border-left: 4px solid #e83e8c; box-shadow: 0 4px 12px rgba(255, 215, 0, 0.08); margin-bottom: 16px; transition: transform 0.2s ease, box-shadow 0.2s ease;"> <div> <div style="font-weight: 600; margin-bottom: 4px;">温馨提示</div> <div style="font-size: 14px; line-height: 1.5;">1、本服务使用前需先联系讯飞商务获取授权或发送邮件到 aiui_support@iflytek.com 提交申请。</div> <div style="font-size: 14px; line-height: 1.5;">2、每个设备(SN)默认限制最多添加10个成员,每个成员最多可以注册3个声纹。</div> </div> </div> 本服务文档主要介绍声纹识别相关服务接口,主要接口如下: **成员控制相关接口** - 成员添加 - 成员查询 - 成员编辑 - 成员删除 **声纹相关接口** - 声纹注册 - 声纹查询 - 声纹更新 - 声纹删除 - 声纹检索 ## 2. 接口说明 ### 请求地址 > http[s]://aiui.xf-yun.com ### 接口鉴权 具体鉴权参数构建见[鉴权文档](https://aiui-doc.xf-yun.com/project-1/doc-404/ "大模型API服务鉴权")说明。 <div style="display: flex; align-items: center; background-color: #fff3cd; border-left: 6px solid #ffc107; border-radius: 4px; padding: 12px 16px; gap: 8px;"> <div style="width: 30px; height: 30px; flex-shrink: 0;"> <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"> <path d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/> </svg> </div> <div style="flex: 1; line-height: 1.6;"> <h3 style="margin: 0 0 6px 0; font-weight: 600;">注意:</h3> <p style="margin: 0; font-size: 0.95rem;">鉴权的时间戳有时效性,建议每次请求鉴权时都实时的获取最新时间戳,生成鉴权参数</p> </div> </div> <div id="功能接口"> </div> ## 3. 功能接口 ### 3.1. 成员添加 成员与设备(sn)绑定,每个设备最多可以添加10个成员。当前成员包含属性:年龄性别。 - METHOD: POST - PATH: /v3/aiint/members - Content-Type: application/json - 请求示例: ```json { "appid": "test", "sn": "test-sn", "member_id": "ifly-001", "name": "小飞", "age_sex": "child", "desc": "可爱的小飞飞" } ``` - `请求参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备(用户)唯一标识,长度不超过32位。对应急速交互API接口中的sn参数 | 是 | - | | member_id | string | 成员标识,不超过32位,用户自行保证appid, sn下唯一;不传默认生成32位uuid(纯小写) | 否 | ifly-001 | | name | string | 成员名称,不超过16个字符,不支持特殊符号,同一个sn下面的name不能重复 | 是 | 小飞 | | age_sex | string | 性别年龄:child 儿童、male 青年男、female 青年女、oldmale 老年男、oldfemale 老年女 | 否 | child | | desc | string | 描述,不超过32个字符,不支持特殊符号 | 否 | - | - `返回值`示例: ```json { "sid": "acm00680001@dx191bbe967b5c444992", "code": 0, "msg": "success", "data": null } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | object | 返回数据 | 否 | - | ### 3.2. 成员查询 全量返回指定设备下面的成员信息 - METHOD: GET - PATH: /v3/aiint/members?appid={appid}&sn={sn} - `请求参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备唯一标识,取值长度不超过32位 | 是 | test-sn | - `返回值`示例: ```json { "sid": "acm00680001@dx191bbe967b5c444992", "code": 0, "msg": "success", "data": [ { "appid": "test", "sn": "test-sn", "member_id": "ifly-001", "name": "小飞", "age_sex": "child", "desc": "可爱的小飞飞" } ] } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | []object | 返回数据 | 否 | - | | data[i].appid | string | 应用id | 是 | 5c8b403a | | data[i].sn | string | 设备唯一编号 | 是 | - | | data[i].member_id | string | 成员标识 | 是 | ifly-001 | | data[i].name | string | 成员名称 | 是 | - | | data[i].age_sex | string | 性别年龄:child 儿童、male 青年男、female 青年女、oldmale 老年男、oldfemale 老年女 | 否 | child | ### 3.3. 成员编辑 更新指定成员信息 - METHOD: PUT - PATH: /v3/aiint/members - Content-Type: application/json - 请求体示例: ```json { "appid": "test", "sn": "test-sn", "member_id": "ifly-001", "name": "小飞", "age_sex": "child", "desc": "可爱的小飞飞" } ``` - `请求参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备(用户)唯一标识,长度不超过32位。对应急速交互API接口中的sn参数 | 是 | - | | member_id | string | 成员标识,不超过32位,用户自行保证appid, sn下唯一;不传默认生成32位uuid(纯小写) | 否 | ifly-001 | | name | string | 成员名称,不超过16个字符,不支持特殊符号,同一个sn下面的name不能重复 | 是 | 小飞 | | age_sex | string | 性别年龄:child 儿童、male 青年男、female 青年女、oldmale 老年男、oldfemale 老年女 | 否 | child | | desc | string | 描述,不超过32个字符,不支持特殊符号 | 否 | - | - `返回值`示例: ```json { "sid": "acm00680001@dx191bbe967b5c444992", "code": 0, "msg": "success", "data": null } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | object | 返回数据 | 否 | - | ### 3.4. 成员删除 删除指定成员及其声纹数据 - METHOD: DELETE - PATH: /v3/aiint/members - Content-Type: application/json - 请求体示例: ```json { "appid": "test", "sn": "test-sn", "member_id": "ifly-001" } ``` - `请求参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备(用户)唯一标识,长度不超过32位。对应急速交互API接口中的sn参数 | 是 | - | | member_id | string | 成员标识,不超过32位,用户自行保证appid, sn下唯一;不传默认生成32位uuid(纯小写) | 是 | ifly-001 | - `返回值`示例: ```json { "sid": "acm00680001@dx191bbe967b5c444992", "code": 0, "msg": "success", "data": null } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | object | 返回数据 | 否 | - | ### 3.5. 声纹注册 第一次添加声纹时后台创建声纹库,没有传成员id时默认生成一个新的成员,根据声纹检测结果生成成员信息 - METHOD: POST - PATH: /v3/aiint/vpr/features - Content-Type: multipart/form-data - HTTP 请求示例: ```java POST /v3/aiint/vpr/features HTTP/1.1 Host: 127.0.0.1:9996 Content-Length: xxx Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="appid" 5c8b403a ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="sn" 12334454543dfsdfsf ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="data"; filename="/D:/文件/tts/2-正常音色文件-zzy.pcm" Content-Type: <Content-Type header here> (data) ------WebKitFormBoundary7MA4YWxkTrZu0gW-- ``` - `表单参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备(用户)唯一标识,长度不超过32位。对应急速交互API接口中的sn参数 | 是 | - | | member_id | string | 成员标识,不超过32位,用户自行保证appid, sn下唯一;不传默认生成32位uuid(纯小写) | 否 | ifly-001 | | data | file | 音频文件,只支持音频格式:pcm 16k 16bit 单通道,时常不少于1秒,不超过2分钟 | 是 | - | | feature_info | string | 描述,不超过32个字符,不支持特殊符号 | 否 | 小飞飞近场 | - `返回值`示例: ```json { "sid": "acm00010034@dx191749d8e5d0001562", "code": 0, "msg": "success", "data": { "feature_id": "fsdfwee234324", "member_id": "4b37ccbb6679c34389176ed5bc920196", "age_sex": "child" } } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | object | 返回数据 | 否 | - | | data.feature_id | string | 声纹特征id | 是 | fsdfwee234324 | | data.member_id | string | 成员id | 是 | 3 | | data.age_sex | string | 性别年龄:child 儿童、male 青年男、female 青年女、oldmale 老年男、oldfemale 老年女 | 否 | child | ### 3.6. 声纹查询 查询指定sn下的成员声纹信息 - METHOD: GET - PATH: /v3/aiint/vpr/features?appid={appid}&sn={sn}&member_id={member_id} - `请求参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备唯一标识,取值长度不超过32位 | 是 | test-sn | | member_id | string | 成员id标识 | 否 | ifly-001 | - `返回值`示例: ```json { "sid": "acm00680001@dx191bbe967b5c444992", "code": 0, "msg": "success", "data": [ { "appid": "5c8b403a", "sn": "test-sn", "member_id": "ifly-001", "name": "小飞", "age_sex": "child", "desc": "可爱的小飞飞", "features": [ { "feature_id": "w23ddfw3", "merge_cnt": 1, "feature_info": "近场" }, { "feature_id": "w23ddfw4", "merge_cnt": 1, "feature_info": "远场" } ] } ] } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | []object | 返回数据 | 否 | - | | data[i].appid | string | 应用id | 是 | 5c8b403a | | data[i].sn | string | 设备唯一编号 | 是 | - | | data[i].member_id | string | 成员标识 | 是 | ifly-001 | | data[i].name | string | 成员名称 | 是 | - | | data[i].age_sex | string | 性别年龄:child 儿童、male 青年男、female 青年女、oldmale 老年男、oldfemale 老年女 | 否 | child | | data[i].desc | string | 描述,不超过32个字符,不支持特殊符号 | 否 | - | | data[i].features | []object | 成员注册的声纹 | 否 | - | | data[i].features[j].feature_id | string | 声纹id | 是 | - | | data[i].features[j].merge_cnt | int | 声纹特征合并更新次数,初始值:1,调用更新声纹特征接口并且cover=false时加1 | 是 | - | | data[i].features[j].feature_info | string | 特征信息,不超过32个字符,不支持特殊符号 | 否 | - | ### 3.7. 声纹更新 更新指定id的声纹特征,可以选择直接覆盖或者与原有特征进行合并更新 - METHOD: PUT - PATH: /v3/aiint/vpr/features - Content-Type: multipart/form-data - HTTP 请求示例: ```java POST /v3/aiint/vpr/features HTTP/1.1 Host: 127.0.0.1:9996 Content-Length: xxx Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="appid" 5c8b403a ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="sn" 12334454543dfsdfsf ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="feature_id" njecjooy194 ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="cover" false ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="data"; filename="/D:/文件/tts/2-正常音色文件-zzy.pcm" Content-Type: <Content-Type header here> (data) ------WebKitFormBoundary7MA4YWxkTrZu0gW-- ``` - `表单参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备(用户)唯一标识,长度不超过32位。对应急速交互API接口中的sn参数 | 是 | - | | feature_id | string | 特征id,注册接口返回 | 是 | fsdfwee234324 | | cover | string | 是否覆盖原有特征:true 覆盖、false 与原有特征进行合并更新;默认:true | 否 | true | | data | file | 音频文件,只支持音频格式:pcm 16k 16bit 单通道,时常不少于1秒,不超过2分钟 | 是 | - | | feature_info | string | 描述,不超过32个字符,不支持特殊符号 | 否 | 小飞飞近场 | - `返回值`示例: ```json { "sid": "acm00010034@dx191749d8e5d0001562", "code": 0, "msg": "success", "data": { "feature_id": "fsdfwee234324", "merge_cnt": 2, "member_id": "fily-001", "age_sex": "child" } } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | object | 返回数据 | 否 | - | | data.feature_id | string | 声纹特征id | 是 | fsdfwee234324 | | data.merge_cnt | int | 声纹特征合并更新次数,创建的新声纹为1,调用更新声纹特征接口并且cover=false时加1 | 是 | 2 | | data.member_id | string | 成员id | 是 | 3 | | data.age_sex | string | 性别年龄:child 儿童、male 青年男、female 青年女、oldmale 老年男、oldfemale 老年女 | 否 | child | ### 3.8. 声纹删除 指定声纹id进行删除 - METHOD: DELETE - PATH: /v3/aiint/vpr/features - Content-Type: application/json - 请求体示例: ```json { "appid": "5c8b403a", "sn": "test-sn", "feature_id": "fsdfwee234324" } ``` - `请求参数`说明 | 参数名 | 类型 | 说明 | 必需 | 示例 | | ------ | ------ | ------- | ---- | ------ | | appid | string | 应用id | 是 | 5c8b403a | | sn | string | 设备(用户)唯一标识,长度不超过32位。对应急速交互API接口中的sn参数 | 是 | - | | feature_id | string | 声纹特征id | 是 | fsdfwee234324 | - `返回值`示例: ```json { "sid": "acm00010034@dx191749d8e5d0001562", "code": 0, "msg": "success", "data": { "feature_id": "fsdfwee234324", "member_id": "4b37ccbb6679c34389176ed5bc920196", "age_sex": "child" } } ``` - `返回值参数字段`说明: ### 3.9. 声纹检索 检索出指定设备声纹库中与当前上传的音频匹配的声纹信息,用于效果验证 - METHOD: POST - PATH: /v3/aiint/vpr/searchFea - Content-Type: multipart/form-data - HTTP 请求示例: ```java POST /v3/aiint/vpr/features HTTP/1.1 Host: 127.0.0.1:9996 Content-Length: xxx Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="appid" 5c8b403a ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="sn" 12334454543dfsdfsf ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="data"; filename="/D:/文件/tts/2-正常音色文件-zzy.pcm" Content-Type: <Content-Type header here> (data) ------WebKitFormBoundary7MA4YWxkTrZu0gW-- ``` - `返回值`示例: ```json { "sid": "acr005c0001@dx19a4333de9f0001992", "code": 0, "msg": "success", "data": [ { "member": { "appid": "test", "sn": "test-sn", "member_id": "ifly-001", "name": "小飞", "age_sex": "child", "desc": "可爱的小飞飞", }, "feature_id": "fhptu9n1kl4", "score": 1 "age": "youth", "gender": "male", } ] } ``` - `返回值参数字段`说明: | 参数名 | 类型 | 说明 | 必需 | 示例 | | ---------- | ----- | ------------- | ---- | ----------- | | sid | string | 请求标识 | 是 | - | | code | int | 状态码,0 成功,非0表示请求处理失败 | 是 | 0 | | msg | string | 描述 | 是 | - | | data | object | 返回数据 | 否 | - | | data[i].member | object | 匹配到的成员 | 是 | - | | data[i].member.appid | string | 应用id | 是 | 5c8b403a | | data[i].member.sn | string | 设备唯一编号 | 是 | - | | data[i].member.member_id | string | 成员标识 | 是 | ifly-001 | | data[i].member.name | string | 成员名称 | 是 | - | | data[i].member.age_sex | string | 性别年龄:child 儿童、male 青年男、female 青年女、oldmale 老年男、oldfemale 老年女 | 否 | child | | data[i].member.desc | string | 描述,不超过32个字符,不支持特殊符号 | 否 | - | | data[i].feature_id | string | 声纹特征id | 是 | fhptu9n1kl4 | | data[i].score | float | 相似度得分 0~1,精确到小 数点后两位 | 是 | 0.6 | | data[i].age | string | 年龄(仅参考):child 儿童、youth 年轻人、old 老年人、unknown (出错 时返回) | 是 | youth | | data[i].gender | string | 性别(仅参考):male 成年男、female 成年女、child儿童、unknown (出错 时返回) | 是 | male | ## 4. 链路使用 ### 4.1 功能开启 在AIUI极速交互类应用中,需要识别结果中包含声纹识别结果,除了先注册声纹外,还需要选择最新的 大模型识别引擎,并在AIUI应用下开启声纹能力。如下图: <div style="display: flex; align-items: flex-start; gap: 16px; padding: 16px; background: #fff5f6; border-radius: 5px; border-left: 4px solid #e83e8c; box-shadow: 0 4px 12px rgba(255, 215, 0, 0.08); margin-bottom: 16px; transition: transform 0.2s ease, box-shadow 0.2s ease;"> <div> <div style="font-weight: 600; margin-bottom: 4px;">温馨提示</div> <div style="font-size: 14px; line-height: 1.5;">AIUI语义模型配置下的个性化设置项,同声纹注册能力一样需要授权,通过授权后应用才会展示</div> </div> </div>   ### 4.2 结果解析 集成[AIUI极速交互协议API](https://aiui-doc.xf-yun.com/project-1/doc-584/) 进行音频对话请求,参数配置(appid、sn)与声纹注册信息一致后,在识别结束帧结果中,解析 extra 字段取值。相关示例结果如下: - 匹配到声纹结果 ```json { "payload": { "iat": { "compress": "raw", "format": "plain", "text": "{\"extra\":{\"feature_id\":\"99ijf7om8zs\",\"score\":0.51},\"text\":{\"sn\":1,\"ls\":true,\"bg\":0,\"ed\":0,\"rg\":null,\"vad\":null,\"voice\":null,\"pgs\":\"\",\"rst\":\"\",\"sign\":\"\",\"ws\":[{\"bg\":0,\"cw\":[{\"sc\":0,\"w\":\"今天是什么日子\",\"ph\":\"\",\"ng\":\"\",\"wb\":0,\"wc\":0,\"we\":0,\"wp\":\"\"}]}]}}", "encoding": "utf8", "seq": 1, "status": 2 } }, "header": { "code": 0, "message": "success", "stmid": "audio-1", "sid": "xgo000d9722@dx19b8cd02fb70001822", "status": 1 } } ``` - 未匹配到声纹结果 ```json { "payload": { "iat": { "compress": "raw", "format": "plain", "text": "{\"extra\":{},\"text\":{\"sn\":1,\"ls\":true,\"bg\":0,\"ed\":0,\"rg\":null,\"vad\":null,\"voice\":null,\"pgs\":\"\",\"rst\":\"\",\"sign\":\"\",\"ws\":[{\"bg\":0,\"cw\":[{\"sc\":0,\"w\":\"今天星期几\",\"ph\":\"\",\"ng\":\"\",\"wb\":0,\"wc\":0,\"we\":0,\"wp\":\"\"}]}]}}", "encoding": "utf8", "seq": 1, "status": 2 } }, "header": { "code": 0, "message": "success", "stmid": "audio-1", "sid": "xgo000e72f9@dx19b8ce808060001822", "status": 1 } } ```
admin
2026年1月6日 13:51
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码