文档中心

企业直播

API 参考

CreateScriptPreReview - 创建脚本预审任务

调用 CreateScriptPreReview 接口，创建脚本预审任务。任务创建成功后，返回预审任务 ID。您可以通过该任务 ID 查看预审分析结果、下载预审报告，或通过回调地址接收脚本预审任务状态消息。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。
前提条件：确保当前账号为已开通质检服务的火山引擎主账号或具备脚本预审 > 可编辑权限的子账号。有关如何添加子账号及授权子账号，详见为子账号授权。

请求说明

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

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`CreateScriptPreReview`	接口名称。当前 API 的名称为 `CreateScriptPreReview`。
Version	String	是	`2024-08-01`	接口版本。当前 API 的版本为 `2024-08-01`。
ProjectName	String	是	`1827016328608457`	直播质检或视频质检项目的名称。您可通过调用 ListProjects 接口，获取项目名称。

Body

参数	类型	是否必选	示例值	描述
TaskName	String	是	`直播脚本预审任务 A`	脚本预审任务名称，长度为 1 到 200 个字符。
ScenarioId	Long	是	`1`	审核场景 ID。您可通过调用 ListScenarios 接口获取 ID。系统将基于您所选审核场景中的文字类规则，对该脚本文本进行预审。说明在脚本预审中，仅审核场景中的文字类规则生效，包括系统敏感词、ASR 敏感词和豆包文字分析规则。
Content	String	是	`欢迎来到本场直播。本场将介绍商品 A 的核心卖点、适用场景和优惠信息。`	待预审的脚本文本正文。支持长度为 1 到 20,000 个字符。
CallbackURL	String	否	`https://www.example.com/callback`	脚本预审任务的回调地址，支持 HTTP 和 HTTPS 协议头。配置后，当脚本预审任务进入待人审、审核完成或执行失败状态时，直播质检服务会将脚本预审任务状态消息以 `POST` 方法提交至该地址。详见脚本预审结果回调。
Extra	String	否	`extra`	需要透传的业务相关信息。仅用于信息透传，不做其他处理。
TagIds	Array of Long	否	`[121]`	标签 ID，用于绑定脚本预审任务。每个脚本预审任务最多支持绑定 10 个标签。不传则不绑定任何标签。说明父标签 ID 不生效。

返回参数

参数	类型	示例值	描述
TaskId	Long	`39737671`	脚本预审任务 ID。您可以通过该任务 ID 查看预审分析结果或下载预审报告。

请求示例

POST https://livesaas.volcengineapi.com/?Action=CreateScriptPreReview&Version=2024-08-01&ProjectName=1827016328608457
{
    "TaskName": "直播脚本预审任务 A",
    "ScenarioId": 1,
    "Content": "欢迎来到本场直播。本场将介绍商品 A 的核心卖点、适用场景和优惠信息。",
    "CallbackURL": "https://www.example.com/callback",
    "Extra": "extra",
    "TagIds": [
        121
    ]
}

返回示例

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

错误码

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

最近更新时间：2026.08.27 11:53:17

这个页面对您有帮助吗？

有用

无用

企业直播

注意事项 #

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #