CreateTask - 创建质检任务--企业直播-火山引擎

文档中心

立即注册

导航

企业直播

CreateTask - 创建质检任务

最近更新时间：2025.07.18 11:24:38首次发布时间：2025.04.15 20:51:41

调用 CreateTask 接口，创建质检任务。任务成功创建后，返回任务 ID。您可通过该任务 ID，调用 GetReport 接口，获取质检报告，包含违规占比、话术分析占比、图像分析占比等。

注意事项

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

请求说明

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

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`CreateTask`	接口名称。当前 API 的名称为 `CreateTask`。
Version	String	是	`2024-08-01`	接口版本。当前 API 的版本为 `2024-08-01`。

Body

参数	类型	是否必选	示例值	描述
ProjectName	String	是	`182701****608457`	项目名称。您可通过调用 ListProjects 接口，获取项目名称。
TaskName	String	是	`任务 A`	任务名称，长度为 1 到 200 个字符。支持以下字符：中文数字大写字母 A - Z 小写字母 a - z
TaskType	Integer	是	`2`	任务类型。取值如下： `1`：视频审核（暂不支持） `2`：直播审核
ScenarioId	Long	是	`1`	审核场景 ID。您可通过调用 ListScenarios 接口获取 ID。
LivePullURL	String	否	`https://www.example.com`	直播拉流地址。目前支持以下直播拉流协议：RTMP、HLS 和 FLV。说明当 `TaskType` 取值为 `2` 时，本参数和 `ActivityId` 参数至少需要传一个。若两者同时传入，则本参数的优先级更高，即使用该直播拉流地址创建质检任务。如果持续 1 分钟左右未正常拉取到直播流，则停止拉流，任务自动终止。如果直播时长超过 24 小时，任务自动终止。
CallbackURL	String	否	`https://www.example.com`	回调地址，支持 HTTP 和 HTTPS 协议头。在任务开始到结束的整个生命周期中，当发生以下事件时，直播质检会将任务状态消息、机审违规消息，以及人审处置意见消息以 POST 方式提交至该地址：质检任务状态变化，包括任务开始、任务结束和任务执行失败触发机审违规消息提交人审处置意见说明如需通过质检消息回调获取任务状态消息、机审违规消息，以及人审处置意见消息，该参数必选。
Extra	String	否	`extra`	需要透传的业务相关信息。长度为 1 到 1000 个字符。仅用于信息透传，不做其他处理。
ActivityId	Long	否	`1836863952377033`	质检任务关联的企业直播直播间 ID。当前接口会使用该直播间的拉流地址创建质检任务。说明当 `TaskType` 取值为 `2` 时，本参数和 `LivePullURL` 参数至少需要传一个。若两者同时传入，则 `LivePullURL` 的优先级更高，即使用 `LivePullURL` 参数取值的直播拉流地址创建质检任务。如果持续 1 分钟左右未正常拉取到直播流，则停止拉流，任务自动终止。如果直播时长超过 24 小时，任务自动终止。
TaskStartTime	Long	否	`1751887200`	任务的开始时间。Unix 时间戳，单位为分钟。取值为 `0` 表示立即开始任务。
TagIds	Array of Long	否	`[121]`	标签 ID，用于绑定质检任务。每个质检任务最多支持绑定 10 个标签。说明父标签 ID 不生效。

返回参数

参数	类型	示例值	描述
TaskId	Long	`397**671`	任务 ID。您可通过该任务 ID，调用 GetReport 接口，获取质检报告，包含违规占比、话术分析占比、图像分析占比等。

请求示例

POST https://livesaas.volcengineapi.com/?Action=CreateTask&Version=2024-08-01
{
    "ProjectName": "182701****608457",
    "TaskName": "任务 A",
    "TaskType": 2,
    "ScenarioId": 1,
    "CallbackURL": "https://www.example.com",
    "Extra": "extra",
    "LivePullURL": "https://www.example.com",
    "ActivityId": 1836863952377033,
    "TaskStartTime": 1751887200,
    "TagIds": [
        121
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateTask",
        "Version": "2024-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1"
    },
    "Result": {
        "TaskId": 397**671
    }
}

错误码

访问公共错误码和错误码获取详细信息。