音频内容安全

文档中心音频内容安全 API 文档数据结构

数据结构

最近更新时间：2023-12-22 01:06:14

我的收藏

本页目录：

AudioResult

音频审核输出参数

被如下接口引用：DescribeTaskDetail。

名称	类型	描述
HitFlag	Integer	该字段用于返回审核内容是否命中审核模型；取值：0（未命中）、1（命中）。注意：此字段可能返回 null，表示取不到有效值。
Label	String	该字段用于返回检测结果所对应的恶意标签。返回值：Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义违规；以及其他令人反感、不安全或不适宜的内容类型。注意：此字段可能返回 null，表示取不到有效值。
Suggestion	String	该字段用于返回后续操作建议。当您获取到判定结果后，返回值表示具体的后续建议操作。返回值：Block：建议屏蔽，Review ：建议人工复审，Pass：建议通过注意：此字段可能返回 null，表示取不到有效值。
Score	Integer	该字段用于返回当前标签下的置信度，取值范围：0（置信度最低）-100（置信度最高），越高代表文本越有可能属于当前返回的标签；如：色情 99，则表明该文本非常有可能属于色情内容。注意：此字段可能返回 null，表示取不到有效值。
Text	String	该字段用于返回音频文件经ASR识别后的文本信息。最长可识别5小时的音频文件，若超出时长限制，接口将会报错。注意：此字段可能返回 null，表示取不到有效值。
Url	String	该字段用于返回音频片段存储的链接地址，该地址有效期为1天。注意：此字段可能返回 null，表示取不到有效值。
Duration	String	该字段用于返回音频文件的时长，单位为毫秒。
Extra	String	该字段用于返回额外附加信息，不同客户或Biztype下返回信息不同。
TextResults	Array of AudioResultDetailTextResult	该字段用于返回音频文件经ASR识别后产生的文本的详细审核结果。具体结果内容请参见AudioResultDetailLanguageResult数据结构的细节描述。
MoanResults	Array of AudioResultDetailMoanResult	该字段用于返回音频文件呻吟检测的详细审核结果。具体结果内容请参见AudioResultDetailMoanResult数据结构的细节描述。
LanguageResults	Array of AudioResultDetailLanguageResult	该字段用于返回音频小语种检测的详细审核结果。具体结果内容请参见AudioResultDetailLanguageResult数据结构的细节描述。
SubLabel	String	该字段用于返回当前标签（Lable）下的二级标签。注意：此字段可能返回 null，表示取不到有效值。
RecognitionResults	Array of RecognitionResult	识别类标签结果信息列表注意：此字段可能返回 null，表示取不到有效值。

AudioResultDetailLanguageResult

音频语言种类检测结果

被如下接口引用：CreateAudioModerationSyncTask, DescribeTaskDetail。

名称	类型	描述
Label	String	该字段用于返回对应的语言种类信息。注意：此字段可能返回 null，表示取不到有效值。
Score	Integer	该参数用于返回当前标签下的置信度，取值范围：0（置信度最低）-100（置信度最高），越高代表音频越有可能属于当前返回的语种标签；注意：此字段可能返回 null，表示取不到有效值。
StartTime	Float	该参数用于返回对应语种标签的片段在音频文件内的开始时间，单位为秒。注意：此字段可能返回 null，表示取不到有效值。
EndTime	Float	该参数用于返回对应语种标签的片段在音频文件内的结束时间，单位为秒。注意：此字段可能返回 null，表示取不到有效值。
SubLabelCode	String	内测中，敬请期待注意：此字段可能返回 null，表示取不到有效值。

AudioResultDetailMoanResult

音频呻吟审核结果

被如下接口引用：DescribeTaskDetail。

名称	类型	描述
Label	String	该字段用于返回检测结果需要检测的内容类型，此处固定为Moan（呻吟）以调用呻吟检测功能。注意：此字段可能返回 null，表示取不到有效值。
Score	Integer	该字段用于返回呻吟检测的置信度，取值范围：0（置信度最低）-100（置信度最高），越高代表音频越有可能属于呻吟内容。
StartTime	Float	该字段用于返回对应呻吟标签的片段在音频文件内的开始时间，单位为秒。
EndTime	Float	该字段用于返回对应呻吟标签的片段在音频文件内的结束时间，单位为秒。
SubLabelCode	String	内测中，敬请期待
SubLabel	String	该字段用于返回当前标签（Lable）下的二级标签。注意：此字段可能返回 null，表示取不到有效值。
Suggestion	String	该字段用于返回基于恶意标签的后续操作建议。当您获取到判定结果后，返回值表示系统推荐的后续操作；建议您按照业务所需，对不同违规类型与建议值进行处理。返回值：Block：建议屏蔽，Review ：建议人工复审，Pass：建议通过示例值：Pass

AudioResultDetailSpeakerResult

音频说话人声纹识别返回结果

被如下接口引用：CreateAudioModerationSyncTask。

名称	类型	描述
Label	String	该字段用于返回检测结果需要检测的内容类型。注意：此字段可能返回 null，表示取不到有效值。示例值：1
Score	Integer	该字段用于返回呻吟检测的置信度，取值范围：0（置信度最低）-100（置信度最高），越高代表音频越有可能属于说话人声纹。注意：此字段可能返回 null，表示取不到有效值。示例值：1
StartTime	Float	该字段用于返回对应说话人的片段在音频文件内的开始时间，单位为秒。注意：此字段可能返回 null，表示取不到有效值。示例值：1
EndTime	Float	该字段用于返回对应说话人的片段在音频文件内的结束时间，单位为秒。注意：此字段可能返回 null，表示取不到有效值。示例值：1

AudioResultDetailTextResult

音频ASR文本审核结果

被如下接口引用：DescribeTaskDetail。

名称	类型	描述
Label	String	该字段用于返回检测结果所对应的恶意标签。返回值：Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义违规；以及其他令人反感、不安全或不适宜的内容类型。注意：此字段可能返回 null，表示取不到有效值。
Keywords	Array of String	该字段用于返回ASR识别出的文本内容命中的关键词信息，用于标注内容违规的具体原因（如：加我微信）。该参数可能会有多个返回值，代表命中的多个关键词；若返回值为空，Score不为空，则代表识别结果所对应的恶意标签（Label）来自于语义模型判断的返回值。注意：此字段可能返回 null，表示取不到有效值。
LibId	String	该字段仅当Label为Custom：自定义关键词时该参数有效,用于返回自定义库的ID，以方便自定义库管理和配置。注意：此字段可能返回 null，表示取不到有效值。
LibName	String	该字段仅当Label为Custom：自定义关键词时该参数有效,用于返回自定义库的名称,以方便自定义库管理和配置。注意：此字段可能返回 null，表示取不到有效值。
Score	Integer	该字段用于返回当前标签下的置信度，取值范围：0（置信度最低）-100（置信度最高），越高代表文本越有可能属于当前返回的标签；如：色情 99，则表明该文本非常有可能属于色情内容。注意：此字段可能返回 null，表示取不到有效值。
Suggestion	String	该字段用于返回后续操作建议。当您获取到判定结果后，返回值表示具体的后续建议操作。返回值：Block：建议屏蔽，Review ：建议人工复审，Pass：建议通过注意：此字段可能返回 null，表示取不到有效值。
LibType	Integer	该字段用于返回自定义关键词对应的词库类型，取值为1（黑白库）和2（自定义关键词库），若未配置自定义关键词库,则默认值为1（黑白库匹配）。
SubLabel	String	该字段用于返回当前标签（Lable）下的二级标签。注意：此字段可能返回 null，表示取不到有效值。

AudioSegments

表示声音段信息

被如下接口引用：DescribeTaskDetail。

名称	类型	描述
OffsetTime	String	该字段用于返回音频片段的开始时间，单位为秒。对于点播文件，该参数代表对应音频相对于完整音轨的偏移时间，如0（代表不偏移），5（音轨开始后5秒），10（音轨开始后10秒）；对于直播文件，该参数则返回对应音频片段开始时的Unix时间戳，如：1594650717。注意：此字段可能返回 null，表示取不到有效值。
Result	AudioResult	该字段用于返回音频片段的具体审核结果，详细内容敬请参考AudioResult数据结构的描述。注意：此字段可能返回 null，表示取不到有效值。

BucketInfo

文件桶信息
参考腾讯云存储相关说明 https://cloud.tencent.com/document/product/436/44352

被如下接口引用：CreateAudioModerationTask, DescribeTaskDetail。

名称	类型	必选	描述
Bucket	String	是	该字段用于标识腾讯云对象存储的存储桶名称,关于文件桶的详细信息敬请参考腾讯云存储相关说明。注意：此字段可能返回 null，表示取不到有效值。
Region	String	是	该字段用于标识腾讯云对象存储的托管机房的分布地区，对象存储 COS 的数据存放在这些地域的存储桶中。注意：此字段可能返回 null，表示取不到有效值。
Object	String	是	该字段用于标识腾讯云对象存储的对象Key,对象作为基本单元被存放在存储桶中；用户可以通过腾讯云控制台、API、SDK 等多种方式管理对象。有关对象的详细描述敬请参阅相应产品文档。注意：此字段可能返回 null，表示取不到有效值。

InputInfo

输入信息详情

被如下接口引用：DescribeTaskDetail。

名称	类型	描述
Type	String	该字段表示文件访问类型，取值为URL（资源链接）和COS (腾讯云对象存储)。注意：此字段可能返回 null，表示取不到有效值。
Url	String	该字段表示文件访问的链接地址，格式为标准URL格式。备注：当Type为URL时此字段不为空。注意：此字段可能返回 null，表示取不到有效值。
BucketInfo	BucketInfo	该字段表示文件访问的腾讯云存储桶信息。备注：当Type为COS时此字段不为空。注意：此字段可能返回 null，表示取不到有效值。

MediaInfo

媒体类型

被如下接口引用：DescribeTasks。

名称	类型	描述
Codecs	String	该字段用于返回传入的媒体文件的编码格式，如wav、mp3、aac、flac、amr、3gp、 m4a、wma、ogg、ape等。
Duration	Integer	该字段用于返回对传入的流媒体文件进行分片的片段时长，单位为毫秒。默认值为15秒，支持用户自定义配置。
Width	Integer	内测中，敬请期待
Height	Integer	内测中，敬请期待
Thumbnail	String	内测中，敬请期待

MoanResult

呻吟低俗检测结果

被如下接口引用：CreateAudioModerationSyncTask。

名称	类型	描述
Label	String	固定取值为Moan（呻吟/娇喘），如音频中无复杂类型「MoanResult」的返回则代表该音频中无呻吟/娇喘相关违规内容；注意：此字段可能返回 null，表示取不到有效值。示例值：1
Score	Integer	机器判断当前分类的置信度，取值范围：0~100。分数越高，表示越有可能属于当前分类。（如：Moan 99，则该样本属于呻吟/娇喘的置信度非常高。）示例值：1
Suggestion	String	建议您拿到判断结果后的执行操作。建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过示例值：1
StartTime	Float	违规事件开始时间，单位为秒（s）；示例值：1
EndTime	Float	违规事件结束时间，单位为秒（s）；示例值：1
SubLabel	String	该字段用于返回当前标签（Lable）下的二级标签。注意：此字段可能返回null，表示取不到有效值。注意：此字段可能返回 null，表示取不到有效值。示例值：1

RecognitionResult

识别类标签结果信息

被如下接口引用：CreateAudioModerationSyncTask, DescribeTaskDetail。

名称	类型	描述
Label	String	可能的取值有：Teenager 、Gender 注意：此字段可能返回 null，表示取不到有效值。示例值：1
Tags	Array of Tag	识别标签列表注意：此字段可能返回 null，表示取不到有效值。示例值：2

StorageInfo

用于表示数据存储的相关信息

被如下接口引用：CreateAudioModerationTask。

名称	类型	必选	描述
Type	String	否	该字段表示文件访问类型，取值为URL（资源链接）和COS (腾讯云对象存储)；该字段应当与传入的访问类型相对应，可用于强校验并方便系统快速识别访问地址；若不传入此参数，则默认值为URL，此时系统将自动判定访问地址类型。
Url	String	否	该字段表示文件访问的链接地址，格式为标准URL格式。备注：当Type为URL时此字段不为空，该参数与BucketInfo参数须传入其中之一
BucketInfo	BucketInfo	否	该字段表示文件访问的腾讯云存储桶信息。备注：当Type为COS时此字段不为空，该参数与Url参数须传入其中之一。

Tag

音频切片识别标签

被如下接口引用：CreateAudioModerationSyncTask。

名称	类型	描述
Name	String	根据Label字段确定具体名称：当Label 为Teenager 时 Name可能取值有：Teenager 当Label 为Gender 时 Name可能取值有：Male 、Female 注意：此字段可能返回 null，表示取不到有效值。示例值：1
Score	Integer	置信分：0～100，数值越大表示置信度越高注意：此字段可能返回 null，表示取不到有效值。示例值：2
StartTime	Float	识别开始偏移时间，单位：毫秒注意：此字段可能返回 null，表示取不到有效值。示例值：3
EndTime	Float	识别结束偏移时间，单位：毫秒注意：此字段可能返回 null，表示取不到有效值。示例值：4

TaskData

任务数据

被如下接口引用：DescribeTasks。

名称	类型	描述
DataId	String	该字段用于返回音频审核任务数据所对应的数据ID，方便后续查询和管理审核任务。注意：此字段可能返回 null，表示取不到有效值。
TaskId	String	该字段用于返回音频审核任务所生成的任务ID，用于标识具体审核任务，方便后续查询和管理。
Status	String	该字段用于返回所查询内容的任务状态。取值：FINISH（任务已完成）、PENDING （任务等待中）、RUNNING （任务进行中）、ERROR （任务出错）、CANCELLED （任务已取消）。
Name	String	该字段用于返回音频审核任务所对应的任务名称，方便后续查询和管理审核任务。注意：此字段可能返回 null，表示取不到有效值。
BizType	String	该字段用于返回调用音频审核接口时传入的BizType参数，方便数据的辨别和管理。注意：此字段可能返回 null，表示取不到有效值。
Type	String	该字段用于返回调用音频审核接口时输入的音频审核类型，取值为：AUDIO（点播音频）和LIVE_AUDIO（直播音频），默认值为AUDIO。注意：此字段可能返回 null，表示取不到有效值。
Suggestion	String	该字段用于返回基于恶意标签的后续操作建议。当您获取到判定结果后，返回值表示系统推荐的后续操作；建议您按照业务所需，对不同违规类型与建议值进行处理。返回值：Block：建议屏蔽，Review ：建议人工复审，Pass：建议通过注意：此字段可能返回 null，表示取不到有效值。
MediaInfo	MediaInfo	输入信息注意：此字段可能返回 null，表示取不到有效值。
Labels	Array of TaskLabel	该字段用于返回检测结果所对应的恶意标签。返回值：Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义违规；以及其他令人反感、不安全或不适宜的内容类型。注意：此字段可能返回 null，表示取不到有效值。
CreatedAt	String	该字段用于返回被查询任务创建的时间，格式采用 ISO 8601标准。
UpdatedAt	String	该字段用于返回被查询任务最后更新时间，格式采用 ISO 8601标准。注意：此字段可能返回 null，表示取不到有效值。

TaskFilter

任务筛选器

被如下接口引用：DescribeTasks。

名称	类型	必选	描述
BizType	String	否	该字段用于传入任务对应的业务类型供筛选器进行筛选。Biztype为策略的具体的编号，用于接口调度，在内容安全控制台中可配置。不同Biztype关联不同的业务场景与审核策略，调用前请确认正确的Biztype。Biztype仅为数字、字母与下划线的组合，长度为3-32个字符。备注：在不传入该参数时筛选器默认不筛选业务类型。
Type	String	否	该字段用于传入音频审核对应的任务类型供筛选器进行筛选，取值为：VIDEO（点播视频审核），AUDIO（点播音频审核）， LIVE_VIDEO（直播视频审核）, LIVE_AUDIO（直播音频审核）。备注：在不传入该参数时筛选器默认不筛选任务类型。
Suggestion	String	否	该字段用于传入音频审核对应的建议操作供筛选器进行筛选，取值为：Block：建议屏蔽，Review：建议人工复审，Pass：建议通过。备注：在不传入该参数时筛选器默认不筛选建议操作。
TaskStatus	String	否	该字段用于传入审核任务的任务状态供筛选器进行筛选，取值为：FINISH（任务已完成）、PENDING （任务等待中）、RUNNING （任务进行中）、ERROR （任务出错）、CANCELLED （任务已取消）。备注：在不传入该参数时筛选器默认不筛选任务状态。

TaskInput

音视频任务数据结构

被如下接口引用：CreateAudioModerationTask。

名称	类型	必选	描述
DataId	String	否	选填参数，该字段表示您为待检测对象分配的数据ID，传入后可方便您对文件进行标识和管理。取值：由英文字母（大小写均可）、数字及四个特殊符号（_，-，@，#）组成，长度不超过64个字符。
Name	String	否	选填参数，该字段表示音频审核任务所对应的任务名称，方便后续查询和管理审核任务。
Input	StorageInfo	否	必填参数，该字段表示审核文件的访问参数，用于获取审核媒体文件，该参数内包括访问类型和访问地址。

TaskLabel

用于返回审核任务输出的标签

被如下接口引用：DescribeTaskDetail, DescribeTasks。

名称	类型	描述
Label	String	该字段用于返回检测结果所对应的恶意标签。返回值：Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义违规；以及其他令人反感、不安全或不适宜的内容类型。注意：此字段可能返回 null，表示取不到有效值。
Suggestion	String	该字段用于返回当前标签对应的后续操作建议。当您获取到判定结果后，返回值表示系统推荐的后续操作；建议您按照业务所需，对不同违规类型与建议值进行处理。返回值：Block：建议屏蔽，Review ：建议人工复审，Pass：建议通过注意：此字段可能返回 null，表示取不到有效值。
Score	Integer	该字段用于返回当前标签（Label）下的置信度，取值范围：0（置信度最低）-100（置信度最高），越高代表文本越有可能属于当前返回的标签；如：色情 99，则表明该文本非常有可能属于色情内容；色情 0，则表明该文本不属于色情内容。注意：此字段可能返回 null，表示取不到有效值。
SubLabel	String	该字段用于返回当前标签（Lable）下的二级标签。注意：此字段可能返回 null，表示取不到有效值。

TaskResult

创建任务时的返回结果

被如下接口引用：CreateAudioModerationTask。

名称	类型	描述
DataId	String	该字段用于返回创建音频审核任务时在TaskInput结构内传入的DataId，用于标识具体审核任务。注意：此字段可能返回 null，表示取不到有效值。
TaskId	String	该字段用于返回音频审核任务所生成的任务ID，用于标识具体审核任务，方便后续查询和管理。注意：此字段可能返回 null，表示取不到有效值。
Code	String	该字段用于返回任务创建的状态，如返回OK则代表任务创建成功，其他返回值可参考公共错误码。注意：此字段可能返回 null，表示取不到有效值。
Message	String	仅在Code的返回值为错误码时生效，用于返回错误的详情内容。注意：此字段可能返回 null，表示取不到有效值。

TextResult

音频文本内容审核结果

被如下接口引用：CreateAudioModerationSyncTask。

名称	类型	描述
Label	String	恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告。以及其他令人反感、不安全或不适宜的内容类型。如音频中无复杂类型「TextResults」的返回则代表该音频中无相关违规内容；注意：此字段可能返回 null，表示取不到有效值。示例值：Normal
Keywords	Array of String	命中的关键词，为空则代表该违规内容出自于模型的判断；注意：此字段可能返回 null，表示取不到有效值。示例值：1
LibId	String	命中关键词库的库标识；注意：此字段可能返回 null，表示取不到有效值。示例值：1
LibName	String	命中关键词库的名字；注意：此字段可能返回 null，表示取不到有效值。示例值：1
Score	Integer	机器判断当前分类的置信度，取值范围：0~100。分数越高，表示越有可能属于当前分类。（如：Porn 99，则该样本属于色情的置信度非常高。）注意：此字段可能返回 null，表示取不到有效值。示例值：1
Suggestion	String	建议您拿到判断结果后的执行操作。建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过注意：此字段可能返回 null，表示取不到有效值。示例值：1
LibType	Integer	自定义词库的类型，自定义词库相关的信息可登录控制台中查看； 1：自定义黑白库； 2：自定义库；示例值：1
SubLabel	String	该字段用于返回当前标签（Lable）下的二级标签。注意：此字段可能返回null，表示取不到有效值。注意：此字段可能返回 null，表示取不到有效值。示例值：1

User

User结果

被如下接口引用：CreateAudioModerationTask。

名称	类型	必选	描述
Level	Integer	否	用户等级，默认0 未知 1 低 2 中 3 高
Gender	Integer	否	性别默认0 未知 1 男性 2 女性
Age	Integer	否	年龄默认0 未知
UserId	String	否	业务用户ID 如填写，会根据账号历史恶意情况，判定消息有害结果，特别是有利于可疑恶意情况下的辅助判断。账号可以填写微信uin、QQ号、微信openid、QQopenid、字符串等。该字段和账号类别确定唯一账号。
Phone	String	否	手机号
AccountType	String	否	业务用户ID类型 "1-微信uin 2-QQ号 3-微信群uin 4-qq群号 5-微信openid 6-QQopenid 7-其它string"
Nickname	String	否	用户昵称
HeadUrl	String	否	用户头像图片链接
Desc	String	否	用户简介，长度不超过5000字
RoomId	String	否	群聊场景房间ID
GroupId	String	否	群聊场景群ID
GroupSize	Integer	否	群聊场景群用户数
ReceiverId	String	否	消息接收者ID
SendTime	String	否	消息生成时间，毫秒

上一篇: 查看审核任务列表下一篇: 错误码