# 创建内容审核任务 - CreateContentCheckTask #### 功能介绍 功能介绍： 在指定项目下创建内容审核任务，支持版权风险检测和内容合规检测两种类型。任务可配置OBS数据源、检测模态、调度策略和违规文件迁移等能力。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /v1/{project_id}/content-check/tasks 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，标识资源所属的华为云项目，用于隔离不同的租户资源。可通过用户控制台的"我的凭证"页面或调用IAM服务接口获取对应的项目ID **约束限制：** 满足正则匹配"\^\[a-z0-9\]{32}$" **取值范围：** 由IAM服务接口返回，为固定长度的32个字符，由数字和字母组成 **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token，用于鉴权和标识调用方身份。通过调用IAM服务"查询用户Token"接口获取，Token值为响应消息头中X-Subject-Token对应的值 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | task_name | 是 | String | **参数解释：** 内容审核任务名称 **约束限制：** 内容审核任务名称以大小写字母或中文开头，可包含数字、中划线、下划线，长度不能超过512个字节 **取值范围：** 不涉及 **默认取值：** 不涉及 | | task_type | 是 | String | **参数解释：** 任务类型，用于指定内容审核任务的类型 **约束限制：** 不涉及 **取值范围：** - COPYRIGHT-版权风险检测 - COMPLIANCE-内容合规检测 **默认取值：** 不涉及 | | description | 否 | String | **参数解释：** 资源描述信息 **约束限制：** 描述由由英文字母、数字、中英文括号、连字符、下划线、汉字和空格组，长度不能超过512个字节 **取值范围：** 不涉及 **默认取值：** 不涉及 | | content_modals | 是 | Array of strings | **参数解释：** 内容模态列表，数组元素为字符串类型，指定本次审核需要检测的内容类型 **约束限制：** 不可重复 **取值范围：** - TEXT-文本 - OCR_TEXT-OCR文本识别 - STATIC_IMAGE-静态图片 **默认取值：** 不涉及 | | data_formats | 是 | Array of strings | **参数解释：** 数据格式列表，数组元素为字符串类型，指定本次审核需要检测的数据文件格式 **约束限制：** 不可重复，需与content_modals匹配（TEXT模态支持LEROBOT格式） **取值范围：** - TXT-纯文本 - PDF-PDF文档 - WORD-Word文档 - EXCEL-Excel表格 - JSON-JSON数据格式 **默认取值：** 不涉及 | | data_source | 是 | String | **参数解释：** 数据来源 **约束限制：** 当前仅支持OBS **取值范围：** - OBS-对象存储服务 **默认取值：** 不涉及 | | src_bucket | 是 | String | **参数解释：** 源OBS桶 **约束限制：** 最大长度512字符 **取值范围：** 不涉及 **默认取值：** 不涉及 | | src_directory | 否 | String | **参数解释：** 源OBS桶内目录路径 **约束限制：** 最大长度512字符 **取值范围：** 不涉及 **默认取值：** 不涉及 | | traverse_subdir | 是 | Boolean | **参数解释：** 是否遍历子目录 **约束限制：** 不涉及 **取值范围：** true-是，false-否 **默认取值：** 不涉及 | | schedule_type | 是 | String | **参数解释：** 调度类型 **约束限制：** 不涉及 **取值范围：** - ONCE-单次执行 - DAILY-每天执行 - WEEKLY-每周执行 - MONTHLY-每月执行 **默认取值：** 不涉及 | | next_run_time | 否 | Long | **参数解释：** 下次运行时间，Unix时间戳，单位毫秒，表示周期性任务下一次计划执行的时间点 **约束限制：** 不能早于当前时间减10分钟（允许10分钟容差） **取值范围：** 0 \~ 9999999999999（Unix时间戳，单位毫秒） **默认取值：** 不涉及 | | detection_config | 否 | Map\ | **参数解释：** 检测配置，Map\类型，用于配置各项检测规则及其风险阈值 **约束限制：** - key必须在合法检测项名称列表内，且需与task_type匹配（COPYRIGHT类型仅支持IP_CONFIDENCE/MATCH_LENGTH/TOLERANCE；COMPLIANCE类型仅支持内容检测项如SEXUAL/PORN/VIOLENCE/POLITIC/DRUG等） - COPYRIGHT类型下，MATCH_LENGTH必须大于TOLERANCE **取值范围：** - task_type=COPYRIGHT时：IP_CONFIDENCE取值0.6\~0.99，MATCH_LENGTH取值10\~500，TOLERANCE取值0\~50 - task_type=COMPLIANCE时：value取值0\~100 **默认取值：** - IP_CONFIDENCE未传且content_modals含STATIC_IMAGE时默认0.75 - MATCH_LENGTH未传且content_modals含TEXT或OCR_TEXT时默认20 - TOLERANCE未传且content_modals含TEXT或OCR_TEXT时默认5 | | move_violation | 是 | Boolean | **参数解释：** 是否移动违规文件 **约束限制：** 不涉及 **取值范围：** true-是，false-否 **默认取值：** 不涉及 | | dst_bucket | 否 | String | **参数解释：** 目标OBS桶 **约束限制：** 最大长度512字符 **取值范围：** 不涉及 **默认取值：** 不涉及 | | dst_directory | 否 | String | **参数解释：** 目标目录 **约束限制：** 最大长度512字符 **取值范围：** 不涉及 **默认取值：** 不涉及 | | blacklist_ids | 否 | Array of strings | **参数解释：** 黑名单ID列表，数组元素为字符串类型，表示内容审核黑名单的ID，黑名单中的内容将被标记为违规。可通过查询内容审核黑名单列表接口获取 **约束限制：** 不涉及 **取值范围：** 数组元素为黑名单ID，字符类型，长度不超过64个字符 **默认取值：** 不涉及 | | whitelist_ids | 否 | Array of strings | **参数解释：** 白名单ID列表，数组元素为字符串类型，表示内容审核白名单的ID，白名单中的内容允许通过审核。可通过查询内容审核白名单列表接口获取 **约束限制：** 不涉及 **取值范围：** 数组元素为白名单ID，字符类型，长度不超过64个字符 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | task_id | String | **参数解释：** 任务ID **取值范围：** 不涉及 | #### 请求示例 创建内容审核任务（版权风险检测） ``` { "task_name" : "content-check-task-finance", "task_type" : "COPYRIGHT", "description" : "金融业务数据内容合规审核任务", "content_modals" : [ "TEXT", "OCR_TEXT" ], "data_formats" : [ "PDF", "WORD" ], "data_source" : "OBS", "src_bucket" : "obs-bucket-finance-audit", "src_directory" : "finance/reports/2026", "traverse_subdir" : true, "schedule_type" : "WEEKLY", "next_run_time" : 1787392800000, "detection_config" : { "IP_CONFIDENCE" : 0.85, "MATCH_LENGTH" : 20, "TOLERANCE" : 5 }, "move_violation" : true, "dst_bucket" : "obs-bucket-violation-archive", "dst_directory" : "violation/2026-08", "blacklist_ids" : [ "2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b" ], "whitelist_ids" : [ "3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c" ] } ``` #### 响应示例 **状态码：200** ``` { "task_id" : "0c1a3b5f4d0e4f2a9b8067c5d1e2f3a4" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求已成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。