SubmitAudit - 提交人工审核意见--企业直播-火山引擎

文档中心

企业直播

API

SubmitAudit - 提交人工审核意见

调用 SubmitAudit 接口，在指定直播质检任务中，对直播进行实时人工处置（警告或断流）；或在机审结束后，提交是否人工审核通过的结论。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。

请求说明

请求方式：POST
请求地址：https://livesaas.volcengineapi.com/?Action=SubmitAudit&Version=2024-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`SubmitAudit`	接口名称。当前 API 的名称为 `SubmitAudit`。
Version	String	是	`2024-08-01`	接口版本。当前 API 的版本为 `2024-08-01`。
ProjectName	String	是	`182701****608457`	项目名称。您可通过调用 ListProjects 接口获取 ProjectName。

Body

参数	类型	是否必选	示例值	描述
TaskId	Integer	是	`397**671`	任务 ID。您可通过调用 CreateTask 或 ListTasks 获取 ID。
AuditSource	String	是	`LIVE`	提交人审意见的来源。取值如下： `LIVE`：监控台实时处理。若待审直播仍在进行中，请传入 `LIVE`，对应在质检平台监控台对直播进行实时处置。 `REPORT`：质检报告任务审核。若直播已结束且已生成质检报告，请传入 `REPORT`，对应在质检平台任务详情处给出直播是否审核通过的结论。说明您可通过 ListTasks 或直播质检消息回调中 `TaskStatus` 的值，判断该字段的值：当 `TaskStatus` 取值为 `2` 时，该字段传 `LIVE`；当 `TaskStatus` 取值为 `3` 或 `4` 时，该字段传 `REPORT`。
OperationType	String	否	`WARNING`	对当前任务绑定的直播间给出实时警告或断流的处置。取值如下： `WARNING`：对直播间发送警告消息。联系技术支持开通配置后，通过企业直播的直播伴侣客户端或手机 VolcLive App 开播的直播间可收到警告消息。对于其他三方平台，您可联系技术支持，提供警告消息的回调地址，通过消息回调实现该能力。 `INTERRUPTION`：对直播间进行断流。联系技术支持开通配置后，基于火山引擎企业直播服务开播的直播间将可被切断直播。断流后，直播间在 2 分钟内不可再次开播。注意当 `AuditSource` 取值为 `LIVE` 时，该参数必填。
AuditStatus	String	否	`APPROVED`	对当前任务中的直播内容给出是否审核通过的结论。取值如下： `APPROVED`：审核通过 `REJECTED`：审核不通过注意当 `AuditSource` 取值为 `REPORT` 时，该参数必填。
AuditComment	String	否	`涉及使用不规范宣传话术`	自定义实时处理备注或机审后的人工审核备注。最多支持 500 个字符。
MarkTime	Integer	否	`1000`	审核意见标记时间，表示相对于任务启动时间的偏移量，用于指定审核意见对应的时间点。单位为毫秒。默认为 `0`，表示在任务启动时提交审核意见。说明当 `AuditSource` 取值为 `LIVE` 时，该参数生效。

返回参数

参数	类型	示例值	描述
AuditId	String	`2000`	人工审核 ID。接口调用成功时返回。

请求示例

POST https://livesaas.volcengineapi.com/?Action=SubmitAudit&Version=2024-08-01&ProjectName=182701****608457
{
    "TaskId": 397**671,
    "AuditComment": "涉及使用不规范宣传话术",
    "MarkTime": 1000,
    "OperationType": "WARNING",
    "AuditSource": "LIVE"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "SubmitAudit",
        "Version": "2024-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1"
    },
    "Result": {
        "AuditId": "2000"
    }
}

错误码

下表提供了该接口特有的错误码，公共错误码请参见公共错误码和错误码文档。

状态码错误码错误信息说明

403 CannotSubmitAuditError 提交审核记录失败，非机审中状态，不能提交审核请检查 AuditSource 参数的值。

404 RecordNotExistError 任务不存在质检任务不存在。请检查 TaskId 的值。本接口仅支持对直播（非视频）质检任务提交人审意见。

状态码	错误码	错误信息	说明
403	CannotSubmitAuditError	提交审核记录失败，非机审中状态，不能提交审核	请检查 AuditSource 参数的值。
404	RecordNotExistError	任务不存在	质检任务不存在。请检查 TaskId 的值。本接口仅支持对直播（非视频）质检任务提交人审意见。
400	ParamInvalidError	参数不正确, AuditSource 为 LIVE 时必须传 OperationType	请求参数中有无效参数： `AuditSource` 仅支持 `LIVE` 或 `REPORT`，请检查；请检查 `OperationType` 或 `AuditStatus` 的值；请确保 `AuditComment` 的值少于 500 字符。

400

ParamInvalidError

参数不正确, AuditSource 为 LIVE 时必须传 OperationType

请求参数中有无效参数：

AuditSource 仅支持 LIVE 或 REPORT，请检查；
请检查 OperationType 或 AuditStatus 的值；
请确保 AuditComment 的值少于 500 字符。

最近更新时间：2026.05.09 16:30:47

这个页面对您有帮助吗？

有用

无用

企业直播

注意事项 #

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #