1. 接口描述
接口请求域名: ams.tencentcloudapi.com 。
通过该接口可查看音频审核任务的详情信息,包括任务状态、检测结果、音频文件识别出的对应文本内容、检测结果所对应的恶意标签及推荐的后续操作等,具体输出内容可查看输出参数示例。
默认接口请求频率限制:20次/秒。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:DescribeTaskDetail。 |
| Version | 是 | String | 公共参数,本接口取值:2020-12-29。 |
| Region | 否 | String | 公共参数,本接口不需要传递此参数。 |
| TaskId | 是 | String | 该字段表示创建音频审核任务后返回的任务ID(在Results参数中),用于标识需要查询任务详情的审核任务。 示例值:w-audio-YBJzazmYs4vO27p2 |
| ShowAllSegments | 否 | Boolean | 该布尔字段表示是否展示全部的音频片段,取值:True(展示全部的音频分片)、False(只展示命中审核规则的音频分片);默认值为False。 示例值:false |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | 该字段用于返回创建音频审核任务后返回的任务ID(在Results参数中),用于标识需要查询任务详情的审核任务。 示例值:w-audio-YBJzazmYs4vO27p2 |
| DataId | String | 该字段用于返回调用音频审核接口时在Tasks参数内传入的数据ID参数,方便数据的辨别和管理。 示例值:azmYs4vO27p2 |
| BizType | String | 该字段用于返回调用音频审核接口时传入的BizType参数,方便数据的辨别和管理。 示例值:default |
| Name | String | 该字段用于返回调用音频审核接口时传入的TaskInput参数中的任务名称,方便任务的识别与管理。 示例值:名称 |
| Status | String | 该字段用于返回所查询内容的任务状态。 示例值:FINISH |
| Type | String | 该字段用于返回调用音频审核接口时输入的音频审核类型,取值为:AUDIO(点播音频)和LIVE_AUDIO(直播音频),默认值为AUDIO。 示例值:AUDIO |
| Suggestion | String | 该字段用于返回基于恶意标签的后续操作建议。当您获取到判定结果后,返回值表示系统推荐的后续操作;建议您按照业务所需,对不同违规类型与建议值进行处理。 示例值:Pass |
| Labels | Array of TaskLabel | 该字段用于返回检测结果所对应的恶意标签。 |
| InputInfo | InputInfo | 该字段用于返回审核服务的媒体内容信息,主要包括传入文件类型和访问地址。 |
| AudioText | String | 该字段用于返回音频文件识别出的对应文本内容,最大支持前1000个字符。 示例值:the text |
| AudioSegments | Array of AudioSegments | 该字段用于返回音频片段的审核结果,主要包括开始时间和音频审核的相应结果。 |
| ErrorType | String | 当任务状态为Error时,该字段用于返回对应错误的类型;任务状态非Error时,默认返回为空。 示例值:URL_ERROR |
| ErrorDescription | String | 当任务状态为Error时,该字段用于返回对应错误的详细描述,任务状态非Error时默认返回为空。 示例值:the url is request is 404 |
| CreatedAt | String | 该字段用于返回被查询任务创建的时间,格式采用 ISO 8601标准。 示例值:2021-01-28T08:20:25.759Z |
| UpdatedAt | String | 该字段用于返回被查询任务最后更新时间,格式采用 ISO 8601标准。 示例值:2021-01-28T08:20:25.759Z |
| Label | String | 该字段用于返回检测结果所对应的标签。如果未命中恶意,返回Normal,如果命中恶意,则返回Labels中优先级最高的标签 示例值:Normal |
| MediaInfo | MediaInfo | 媒体信息 |
| HitSnippetInfos | Array of HitSnippetInfos | 命中信息 |
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 查询详情
输入示例
POST / HTTP/1.1
Host: ams.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeTaskDetail
<公共请求参数>
{
"TaskId": "w-audio-ap**ln********O0"
}
输出示例
{
"Response": {
"AudioSegments": [],
"AudioText": "存在诗中,此刻命运请来强者,树影一弦歌,独山一切风。牵就生命太多选择,而我拒绝符合,我始终接着我自己顾自己的蛋搁你湿我的自己,你湿我的生己,也是我的眼睛让我看得清,当也聪明。若柔长身世,这身恨不过2万笑一句,要我说,这几份恶烈,让我来重现。心一律逃避,我不却不出名,只希奉我自己,如果生根是强百你,我愿力放出第一天亮生命寂寞下,上的是再等,从五秒钟逃命,下的就是你。我不承认什么不合理的规则,路再坎坷,不变的是我的执着,生命太多选择,而我拒绝符合,我始终接着我自己呼自己的反戈。你是我的最蜻,你是我的手心点,是我的眼睛,让我看得起。从林落入强势,逝者生存不破浪漫笑一曲,要我说,这世的恶烈,让我来重现,为了什么?惊心一语踏平,我不全服宿命痴心奉我自己,如果胜算,世常太命我眼里付出你一笑,所谓全力不负。你好关系,我只管穿我的正义着。下去。把100出一天不在一就燃烧着,记是遥远的火星,就算继续开天地当我。存在的证明的是应天,你和我也不是太迟就因着风间跟而起盼你的真情。",
"BizType": "mmtest_audio_test_089",
"CreatedAt": "2026-09-03T06:24:22.850Z",
"DataId": "",
"ErrorDescription": "",
"ErrorType": "",
"HitSnippetInfos": [
{
"AtomicCategory": "CategoryA",
"AtomicId": "IDA",
"AtomicName": "NameA",
"Duration": {
"End": 30,
"Start": 0
},
"ParticleId": "particleId",
"Positions": [
{
"End": 100,
"Start": 0
}
],
"Scene": "SceneA",
"Score": 0,
"Snippet": "SnippetA",
"Target": "targetA",
"UnitId": "IDB",
"UnitName": "NameB"
}
],
"InputInfo": {
"BucketInfo": null,
"Extra": "",
"ImageUrlList": [],
"TextContent": "",
"Title": "",
"Type": "URL",
"Url": "h*tps://****-*************625**********************************/**************y001.mp3"
},
"Label": "Normal",
"Labels": [],
"MediaInfo": {
"Codecs": "",
"Duration": 211,
"Height": 0,
"Thumbnail": "",
"Width": 0
},
"Name": "",
"RequestId": "063f1718-3374-41a9-aaf7-70e268125471",
"Status": "FINISH",
"Suggestion": "Pass",
"TaskId": "w-audio-apkSlnlHt2hVEPO0",
"Type": "AUDIO",
"UpdatedAt": "2026-09-03T06:25:18.202Z"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| DryRunOperation | DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。 |
| FailedOperation | 操作失败。 |
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
| LimitExceeded | 超过配额限制。 |
| MissingParameter | 缺少参数错误。 |
| OperationDenied | 操作被拒绝。 |
| RequestLimitExceeded | 请求的次数超过了频率限制。 |
| ResourceInUse | 资源被占用。 |
| ResourceInsufficient | 资源不足。 |
| ResourceNotFound | 资源不存在。 |
| ResourceUnavailable | 资源不可用。 |
| ResourcesSoldOut | 资源售罄。 |
| UnauthorizedOperation | 未授权操作。 |
| UnknownParameter | 未知参数错误。 |
| UnsupportedOperation | 操作不支持。 |