数据结构

AsyncRecognitionTaskInfo

音频流异步识别任务信息

被如下接口引用：DescribeAsyncRecognitionTasks。

名称	类型	描述
TaskId	Integer	任务ID 示例值：12**135
Url	String	音频流Url 示例值：https://www.audio.com/audio.wav

AsyncRecognitionTasks

音频流异步识别任务列表

被如下接口引用：DescribeAsyncRecognitionTasks。

名称	类型	描述
Tasks	Array of AsyncRecognitionTaskInfo	任务列表 注意：此字段可能返回 null，表示取不到有效值。

HotWord

热词的词和权重

被如下接口引用：CreateAsrVocab, GetAsrVocab, GetAsrVocabList, UpdateAsrVocab。

名称	类型	必选	描述
Word	String	是	热词 注意：此字段可能返回 null，表示取不到有效值。 示例值：秘制
Weight	Integer	是	权重 注意：此字段可能返回 null，表示取不到有效值。 示例值：10

KeyWordLib

关键词表信息

被如下接口引用：GetAsrKeyWordLibList。

名称	类型	必选	描述
KeyWordLibId	String	否	关键词表ID 注意：此字段可能返回 null，表示取不到有效值。 示例值：aa6f402f263f**6fc81fbecfd0sd
Name	String	否	关键词表名称 注意：此字段可能返回 null，表示取不到有效值。 示例值：测试词表
KeyWordList	Array of String	否	关键词列表 注意：此字段可能返回 null，表示取不到有效值。 示例值：["a","b"]
CreateTime	Timestamp ISO8601	否	创建时间 注意：此字段可能返回 null，表示取不到有效值。 示例值：2024-01-01T12:00:00
UpdateTime	Timestamp ISO8601	否	更新时间 注意：此字段可能返回 null，表示取不到有效值。 示例值：2024-01-01T12:00:00

KeyWordLibIdData

关键词ID

被如下接口引用：CreateAsrKeyWordLib, UpdateAsrKeyWordLib。

名称	类型	必选	描述
KeyWordLibId	String	否	关键词ID 注意：此字段可能返回 null，表示取不到有效值。 示例值：dsadsdadas**adada

KeyWordLibListData

查询列表返回数据

被如下接口引用：GetAsrKeyWordLibList。

名称	类型	描述
KeyWordLibList	Array of KeyWordLib	关键词表列表 注意：此字段可能返回 null，表示取不到有效值。
TotalCount	Integer	关键词列表总数 注意：此字段可能返回 null，表示取不到有效值。 示例值：1

KeyWordResult

关键字识别结果

被如下接口引用：DescribeTaskStatus。

名称	类型	描述
KeyWordLibID	String	关键词库ID 注意：此字段可能返回 null，表示取不到有效值。 示例值：abcdedfh
KeyWordLibName	String	关键词库名称 注意：此字段可能返回 null，表示取不到有效值。 示例值：测试词库
KeyWords	Array of String	匹配到的关键词 注意：此字段可能返回 null，表示取不到有效值。 示例值：["冰淇淋","月亮","六便士"]

Model

自学习模型信息

被如下接口引用：GetCustomizationList, GetModelInfo。

名称	类型	描述
ModelName	String	模型名称 示例值：通用模型
DictName	String	模型文件名称 示例值：model.txt
ModelId	String	模型Id 示例值：dassxas*daadsda
ModelType	String	模型类型，“8k”或者”16k“ 示例值：8k
ServiceType	String	服务类型 示例值：0
ModelState	Integer	模型状态： -2：模型训练失败； -1：已下线； 0：训练中； 1：已上线； 3：上线中； 4：下线中； 示例值：0
AtUpdated	String	最后更新时间 示例值： 2024-01-01T12:00:00

SentenceDetail

单句的详细识别结果，包含单个词的时间偏移，一般用于生成字幕的场景。

被如下接口引用：DescribeTaskStatus。

名称	类型	描述
FinalSentence	String	单句最终识别结果 注意：此字段可能返回 null，表示取不到有效值。 示例值：你好，今天很开心
SliceSentence	String	单句中间识别结果，使用空格拆分为多个词 注意：此字段可能返回 null，表示取不到有效值。 示例值：你好 今天 很 开心
WrittenText	String	口语转书面语结果，开启改功能才有值 注意：此字段可能返回 null，表示取不到有效值。 示例值：你好，今天很开心。
StartMs	Integer	单句开始时间（毫秒） 注意：此字段可能返回 null，表示取不到有效值。 示例值：0
EndMs	Integer	单句结束时间（毫秒） 注意：此字段可能返回 null，表示取不到有效值。 示例值：2000
WordsNum	Integer	单句中词个数 注意：此字段可能返回 null，表示取不到有效值。 示例值：4
Words	Array of SentenceWords	单句中词详情 注意：此字段可能返回 null，表示取不到有效值。 示例值：[{"OffsetStartMs": 120}]
SpeechSpeed	Float	单句语速，单位：字数/秒 注意：此字段可能返回 null，表示取不到有效值。 示例值：5.9
SpeakerId	Integer	声道或说话人 Id（请求中如果设置了 speaker_diarization或者ChannelNum为双声道，可区分说话人或声道） 单声道话者分离时不同的值代表不同的说话人； 8k双声道话者分离时speakerId的值为0代表左声道，值为1代表右声道。 注意：此字段可能返回 null，表示取不到有效值。 示例值：0
EmotionalEnergy	Float	情绪能量值，取值为音量分贝值/10。取值范围：[1,10]。值越高情绪越强烈。 注意：此字段可能返回 null，表示取不到有效值。 示例值：1
SilenceTime	Integer	本句与上一句之间的静音时长 注意：此字段可能返回 null，表示取不到有效值。 示例值：0
EmotionType	Array of String	情绪类型（可能为空，有2种情况 1、没有对应资源包；2、情绪跟语音效果相关，如果情绪不够强烈时可能无法识别） 注意：此字段可能返回 null，表示取不到有效值。 示例值：happy
KeyWordResults	Array of KeyWordResult	关键词识别结果列表 注意：此字段可能返回 null，表示取不到有效值。 示例值：[ { "KeyWordLibID": "ec9g31d", "KeyWordLibName": "测试词库", "KeyWords": ["冰淇淋","月亮","六便士"] } ]

SentenceWord

一句话识别返回的词时间戳

被如下接口引用：SentenceRecognition。

名称	类型	描述
Word	String	词结果 示例值：腾讯云
StartTime	Integer	词在音频中的开始时间 示例值：0
EndTime	Integer	词在音频中的结束时间 示例值：1024

SentenceWords

识别结果中词文本，以及对应时间偏移

被如下接口引用：DescribeTaskStatus。

名称	类型	描述
Word	String	词文本 注意：此字段可能返回 null，表示取不到有效值。 示例值：晴天
OffsetStartMs	Integer	在句子中的开始时间偏移量 注意：此字段可能返回 null，表示取不到有效值。 示例值：200
OffsetEndMs	Integer	在句子中的结束时间偏移量 注意：此字段可能返回 null，表示取不到有效值。 示例值：400

Task

录音文件识别、实时语音异步识别请求的返回数据

被如下接口引用：CreateAsyncRecognitionTask, CreateRecTask。

名称	类型	描述
TaskId	Integer	任务ID，可通过此ID在轮询接口获取识别状态与结果。TaskId数据类型为uint64。 注意：TaskId有效期为24小时，不同日期可能出现重复TaskId，请不要依赖TaskId作为您业务系统里的唯一ID。 示例值：400000000

TaskStatus

获取录音识别结果的返回参数

被如下接口引用：DescribeTaskStatus。

名称	类型	描述
TaskId	Integer	任务标识。注意：TaskId数据类型为uint64。 示例值：1002301
Status	Integer	任务状态码，0：任务等待，1：任务执行中，2：任务成功，3：任务失败。 示例值：0
StatusStr	String	任务状态，waiting：任务等待，doing：任务执行中，success：任务成功，failed：任务失败。 示例值：waiting
Result	String	识别结果。 示例值：今天天气真好
ErrorMsg	String	失败原因说明。 示例值：Failed to download audio file!
ResultDetail	Array of SentenceDetail	识别结果详情，包含每个句子中的词时间偏移，一般用于生成字幕的场景。(录音识别请求中ResTextFormat=1时该字段不为空) 注意：此字段可能返回 null，表示取不到有效值。
AudioDuration	Float	音频时长(秒)。 注意：此字段可能返回 null，表示取不到有效值。 示例值：1.2

UsageByDateInfo

用户用量信息

被如下接口引用：GetUsageByDate。

名称	类型	必选	描述
BizName	String	否	业务类型名称 注意：此字段可能返回 null，表示取不到有效值。 示例值：1
Count	Integer	否	识别次数 单位：次 注意：此字段可能返回 null，表示取不到有效值。 示例值：1
Duration	Integer	否	识别时长 单位：秒 注意：此字段可能返回 null，表示取不到有效值。 示例值：1

UsageByDateInfoData

用户用量信息

被如下接口引用：GetUsageByDate。

名称	类型	必选	描述
UsageByDateInfoList	Array of UsageByDateInfo	否	用量信息列表 注意：此字段可能返回 null，表示取不到有效值。

VerifyTop

声纹组对比结果top数据

被如下接口引用：VoicePrintGroupVerify。

名称	类型	必选	描述
Score	String	否	相似度打分 注意：此字段可能返回 null，表示取不到有效值。 示例值：0.70
VoicePrintId	String	否	说话人id 注意：此字段可能返回 null，表示取不到有效值。 示例值：dsadcsds-dsads-dsadasd
SpeakerId	String	否	说话人昵称 注意：此字段可能返回 null，表示取不到有效值。 示例值：小明

VerifyTopResult

说话人验证1:N返回结果

被如下接口引用：VoicePrintGroupVerify。

名称	类型	必选	描述
VerifyTops	Array of VerifyTop	否	对比打分结果，按照打分降序排列返回 注意：此字段可能返回 null，表示取不到有效值。

Vocab

词表内容

被如下接口引用：GetAsrVocabList。

名称	类型	描述
Name	String	热词表名称 示例值：通用热词
Description	String	热词表描述 示例值：适用通用场景
VocabId	String	热词表ID 示例值：xsddsffa****dsafgdf
WordWeights	Array of HotWord	词权重列表
CreateTime	Timestamp ISO8601	词表创建时间 示例值：2024-01-01T12:00:00
UpdateTime	Timestamp ISO8601	词表更新时间 示例值：2024-01-01T12:00:00
State	Integer	热词表状态，1为默认状态即在识别时默认加载该热词表进行识别，0为初始状态 示例值：0
TagInfos	Array of String	标签数组 注意：此字段可能返回 null，表示取不到有效值。 示例值：xxxxxxx****xxxx

VoicePrintBaseData

说话人基础数据，包括说话人id和说话人昵称

被如下接口引用：VoicePrintCount, VoicePrintDelete, VoicePrintEnroll, VoicePrintUpdate。

名称	类型	描述
VoicePrintId	String	说话人id 注意：此字段可能返回 null，表示取不到有效值。 示例值：xasdfgfgf****gvdffdsf
SpeakerNick	String	说话人昵称 注意：此字段可能返回 null，表示取不到有效值。 示例值：腾讯云

VoicePrintCompareData

音频声纹比对结果，包含比对分数

被如下接口引用：VoicePrintCompare。

名称	类型	描述
Score	String	匹配度 取值范围(0.0 - 100.0) 注意：此字段可能返回 null，表示取不到有效值。 示例值：100.0
Decision	Integer	验证结果 0: 未通过 1: 通过 注意：此字段可能返回 null，表示取不到有效值。 示例值：0

VoicePrintCountData

统计返回说话人注册数量

被如下接口引用：VoicePrintCount。

名称	类型	描述
Total	Integer	总数 注意：此字段可能返回 null，表示取不到有效值。 示例值：0
VoicePrintList	Array of VoicePrintBaseData	说话人id列表 注意：此字段可能返回 null，表示取不到有效值。

VoicePrintVerifyData

说话人验证数据

被如下接口引用：VoicePrintVerify。

名称	类型	描述
VoicePrintId	String	说话人id 注意：此字段可能返回 null，表示取不到有效值。
Score	String	匹配度 取值范围(0.0 - 100.0) 注意：此字段可能返回 null，表示取不到有效值。
Decision	Integer	验证结果 0: 未通过 1: 通过 注意：此字段可能返回 null，表示取不到有效值。