创建视频审核任务--veImageX-火山引擎

文档中心

veImageX

智能审核

创建视频审核任务

本接口用于创建视频内容审核任务，支持对视频内容进行多维度安全检测，包括但不限于涉黄、涉政、涉恐等违规内容识别。可配置审核维度、冻结策略等参数，实现对违规内容的自动化处理。支持回调通知功能，便于业务系统实时获取审核结果。

注意事项

计费说明：智能审核属于附加组件下智能处理模块，属于后付费计费，使用后会产生附加组件智能处理费用。
前提条件：请确保已开通智能处理计费配置。
使用限制：使用组件前，请先确认智能审核使用限制。
请求频率：单用户请求频率限制为 5 次/秒。
超时时间：超时时间约为 10 秒。
服务地址：veImageX 在全球多个区域部署，每个区域有自己对应的 OpenAPI 域名，不支持跨区域调用。详情参见服务地址。

请求说明

请求方式：POST
请求地址：https://imagex.volcengineapi.com/?Action=CreateVideoAuditTask&Version=2023-05-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

Query

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

Body

参数	类型	是否必选	示例值	描述
ServiceId	String	是	`9u**6i`	服务 ID。您可以在 veImageX 控制台服务管理页面，在创建好的图片服务中获取服务 ID。您也可以通过 OpenAPI 的方式获取服务 ID，具体请参考获取所有服务信息。
TaskType	String	是	`audit_video`	任务类型，当前仅支持取值为 `audit_video`。
Type	String	是	`UrlFile`	审核任务场景。取值如下所示： `UrlFile`：存量文件处理，针对已有存储内的文件请求获取审核结果。传入方式是 `ResUri` 方式，即在 TXT 文件（审核文件）内填写了待审核文件 URL，并将该 TXT 文件上传至指定服务后获取并传入该文件的 StoreUri。 `Url`：URL 直传场景。配合 `ImageInfos` 参数，即可直接传入待审核文件的 URL 及区分标识。 `Upload`：上传场景，针对上传文件到指定服务下的场景。可通过 `EnableAuditRange` 参数指定审核的范围，例如对指定上传到某目录下的文件进行审核。
EnableAuditRange	Integer	否	`1`	是否开启审核范围配置，仅当 `Type` 取值为 `Upload` 时生效。默认值为 `0`。支持的取值如下所示。 `0`：不限范围； `1`：指定前缀匹配（需配合 `AuditPrefix` 或 `NoAuditPrefix` 使用）； `2`：指定通配符匹配（需配合 `AuditPrefix` 或 `NoAuditPrefix` 使用）。
AuditPrefix	Array of String	否	`["images/","temp/"]`	指定需要审核的文件前缀列表，仅当 `EnableAuditRange` 取值为 `1` 时生效。若需要对某个目录进行审核，请设置路径为对应的目录名并以 `/` 结尾，例如 `123/test/`。
NoAuditPrefix	Array of String	否	`["images/temp/", "test/"]`	指定不进行审核的文件前缀列表，仅当 `EnableAuditRange` 取值为 `1` 时生效。若需要对某个目录不进行审核，请设置路径为对应的目录名并以 `/` 结尾，例如 `123/test/`。
Auditwildcard	Array of String	否	`["/_image","/test?/"]`	指定通配符匹配的审核范围，支持使用 `` 进行多字符匹配和 `?` 进行单字符匹配。不同通配符需用逗号隔开。例如 `/a/b/c` 匹配 `/a/testb/c`，`/a/b/c/test12?/*` 匹配 `/a/b/c/test123/file.mp4`。
NoAuditwildcard	Array of String	否	`["/_image","/test?/"]`	指定通配符匹配的不审核范围，支持使用 `` 进行多字符匹配和 `?` 进行单字符匹配。不同通配符需用逗号隔开。例如 `/a/b/c` 匹配 `/a/testb/c`，`/a/b/c/test12?/*` 匹配 `/a/b/c/test123/file.mp4`。
ResUri	Array of String	否	`["tos-i-vcr***ae88-cn/audit-list.txt"]`	审核文件的 StoreUri，仅当 `Type` 为 `UrlFile` 时生效。该文件为 .txt 格式，需上传至指定服务对应存储中，文件内容为待审核文件的 URL 列表，每行一个 URL，最多支持 10000 行。
ImageInfos	Array of ImageInfos	否	`-`	当 `Type` 为 `Url` 时，用于批量提交待审核文件的 URL 列表。每个元素包含文件 URL 和自定义标识。
AuditAbility	Integer	是	`1`	审核能力类型，用于指定审核任务所使用的审核模型。目前仅支持取值 `1`，即智能审核能力。
AuditDimensions	Array of String	是	`["video_porn","video_sexy"]`	图像风险审核的具体维度。取值如下：视频画面： `video_porn` ：涉黄，主要适用于通用色情、色情动作、性行为、性暗示、性分泌物、色情动漫、色情裸露等涉黄场景的风险识别 `video_sensitive1` ：涉敏1，具体指涉及暴恐风险 `video_sensitive2`：涉敏2，具体指涉及政治内容风险 `video_forbidden`：违禁，主要适用于打架斗殴、爆炸、劣迹艺人等场景的风险识别 `video_uncomfortable`：引人不适，主要适用于恶心、恐怖、尸体、血腥等引人不适场景的风险识别 `video_qrcode`：二维码，主要适用于识别常见二维码（QQ、微信、其他二维码等） `video_badpicture`：不良画面，主要适用于自我伤害、丧葬、不当车播、吸烟/纹身/竖中指等不良社会风气的风险识别 `video_sexy`：性感低俗，主要适用于舌吻、穿衣性行为、擦边裸露等多种性感低俗场景的风险识别 `video_age`：年龄，主要适用于图中人物对应的年龄段识别 `video_underage`：未成年相关，主要适用于儿童色情、儿童邪典等风险识别 `video_quality`：图片质量，主要适用于图片模糊、纯色边框、纯色屏等风险识别 `video_ad_law`：广告法，主要适用于识别视频内违反广告法相关规定的内容，含虚假宣传、绝对化用语、违禁品类广告、不正当竞争类广告表述等违规广告场景。视频音频： `audio_porn` ：涉黄，主要适用于通用色情、色情动作、性行为、性暗示、性分泌物、色情动漫、色情裸露等涉黄场景的风险识别 `audio_sensitive1` ：涉敏1，具体指涉及暴恐风险 `audio_sensitive2`：涉敏2，具体指涉及政治内容风险 `audio_forbidden`：违禁，主要适用于打架斗殴、爆炸、劣迹艺人等场景的风险识别 `audio_ad` ：广告，识别音频内包含的产品推广、品牌宣传、营销引流等各类广告内容。 `audio_contact_information` ：联系方式，主要适用于识别音频内的手机号、微信号、QQ 号、邮箱、社交账号等各类联系方式。 `audio_abuse` ：辱骂，主要适用于识别音频内的人身攻击、恶意诋毁、污言秽语等辱骂性内容。 `audio_defraud` ：诈骗，主要适用于识别音频内的虚假宣传、诱导转账、假冒身份等诈骗相关话术。 `audio_violation_of_public_order`：违背公序良俗，主要适用于识别音频内的违背社会公德、公序良俗、伦理道德等不良内容。 `audio_low_quality` ：低质音频，主要适用于识别音频内的杂音过大、音量异常、声音模糊、断音失真等低质量音频问题。 `audio_ad_law`：广告法，主要适用于识别音频内违反广告法相关规定的内容，含虚假宣传、绝对化用语、违禁品类广告、不正当竞争类广告表述等违规广告场景。说明您可将 `AuditDimensions` 与 `AuditTextDimensions` 搭配使用，实现图像和文字内容的综合审核。
AuditTextDimensions	Array of String	否	`["video_ad","video_charillegal"]`	文字审核的具体维度。默认不审核任何维度。取值如下： `video_ad`：识别图像上的广告文字。 `video_defraud`：识别图像上的诈骗文字。 `video_charillegal`：识别图像上的涉黄、涉敏、违禁等违规文字。说明您可将 `AuditTextDimensions` 与 `AuditDimensions` 搭配使用，实现图像和文字内容的综合审核。
EnableFreeze	Boolean	否	`true`	是否开启冻结功能，默认值为 `false`。支持的取值如下所示。 `true`：开启； `false`：不开启。说明开启冻结功能后，需配合 `FreezeType`、`FreezeDimensions` 和 `FreezeStrategy` 使用。
FreezeType	Array of String	否	`["recheck","nopass"]`	冻结措施，仅当 `EnableFreeze` 为 `true` 时生效。支持的取值如下所示。 `recheck`：建议复审； `nopass`：审核不通过。
FreezeDimensions	Array of String	否	`["video_porn","video_sexy"]`	冻结维度，取值需要与 `AuditDimensions` 审核维度保持一致或少于 `AuditDimensions`。例如，若 `AuditDimensions` 取值为 `["video_porn","video_sexy"]`，`AuditTextDimensions` 取值为 `["video_ad"]`，则支持以下任意一种组合： `["video_porn","video_sexy","video_ad"]` `["video_porn","video_sexy"]` `["video_porn","video_ad"]` `["video_sexy","video_ad"]`
FreezeStrategy	Integer	否	`0`	冻结策略，当前仅支持取值为 `0`，表示禁用文件。
EnableCallback	Boolean	否	`true`	是否开启审核结果回调功能，默认值为 `false`。支持的取值如下所示。 `true`：开启回调； `false`：不开启回调。说明开启回调功能后，需配合 `CallbackUrl`、`CallbackDimensions` 和 `CallbackImageTypes` 使用。
CallbackDimensions	Array of String	否	`["video_porn","video_sexy"]`	回调类型，取值需要与 `AuditDimensions` 审核维度保持一致或少于 `AuditDimensions`。例如，若 `AuditDimensions` 取值为 `["video_porn","video_sexy"]`，`AuditTextDimensions` 取值为 `["video_ad"]`，则支持以下任意一种组合： `["video_porn","video_sexy","video_ad"]` `["video_porn","video_sexy"]` `["video_porn","video_ad"]` `["video_sexy","video_ad"]`
CallbackImageTypes	Array of String	否	`["problem","frozen"]`	指定需要回调的文件类型，需配合 `EnableCallback` 使用。支持的取值如下所示。 `normal`：正常文件； `problem`：问题文件； `frozen`：冻结文件； `fail`：审核失败文件。
CallbackUrl	String	否	`https://api.example.com/audit/callback`	接收审核结果回调的 URL，veImageX 将以 POST 方式向该地址发送 JSON 格式的回调数据。需配合 `EnableCallback` 参数开启回调功能使用。回调数据格式请参考回调内容文档。
Region	String	是	`cn`	指定审核任务所属的地区。当前仅支持国内地区，取值为 `cn`。
Interval	Integer	是	`1`	视频截帧频率，单位为秒，默认值为 `2`。表示每隔指定秒数对视频进行一次截帧处理。

ImageInfos

参数	类型	是否必选	示例值	描述
ImageUri	String	否	`https://test.png`	待审核文件 URL，需满足公网可访问。
DataId	String	否	`92bodw28122j19***018h3i1928g`	建议您根据实际业务情况，将该参数作为可区分审核文件 `ImageUri` 的自定义标识。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
TaskId	String	`652ceffd309a6dd937a3780d`	任务 ID

请求示例

POST https://imagex.volcengineapi.com/?Action=CreateVideoAuditTask&Version=2023-05-01
{
    "ServiceId": "9u**6i",
    "TaskType": "audit_video",
    "Type": "Url",
    "AuditAbility": 1,
    "AuditDimensions": [
        "video_porn",
        "video_sensitive1",
        "video_sensitive2"
    ],
    "Region": "cn",
    "ImageInfos": [
        {
            "ImageUri": "https://test.image.com/example.mp4",
            "DataId": "92bodw28122j19***018h3i1928g"
        }
    ],
    "EnableCallback": true,
    "CallbackDimensions": [
        "video_porn",
        "video_sensitive1"
    ],
    "CallbackImageTypes": [
        "problem",
        "frozen"
    ],
    "CallbackUrl": "https://api.example.com/audit/callback"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateVideoAuditTask",
        "Version": "2023-05-01",
        "Service": "ImageX",
        "Region": "cn-north-1"
    },
    "Result": {
        "TaskId": "652ceffd309a6dd937a3780d"
    }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码和 veImageX 错误码。

最近更新时间：2026.01.26 15:49:55

这个页面对您有帮助吗？

有用

无用

veImageX

注意事项 #

请求说明 #

调试 #

请求参数 #

Query #

Body #

ImageInfos #

返回参数 #

请求示例 #

返回示例 #

错误码 #