You need to enable JavaScript to run this app.
导航
veImageX
  • 文档首页
    • /
  • veImageX

更新审核任务配置

最近更新时间：2023.11.16 17:44:39

首次发布时间：2023.10.20 18:03:21

我的收藏

本接口支持对任务状态为已取消的审核任务，通过指定服务 ID 和任务 ID 来更新该条审核任务的各项配置。

说明

您可通过调用查询所有审核任务查看所有审核任务的状态。

注意事项

  • 请求频率：单用户请求频率限制为 5 次/秒。
  • 超时时间：超时时间约为 10 秒。
  • 前提条件：仅支持对已取消状态的任务更新配置。
  • 服务地址：veImageX 在全球多个区域部署，每个区域有自己对应的 OpenAPI 域名，不支持跨区域调用。具体详情请查看服务地址。

请求说明

  • 请求方式：POST
  • 请求地址：https://imagex.volcengineapi.com/?Action=UpdateImageAuditTask&Version=2018-08-01

调试

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

请求参数

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

参数类型是否必选示例值描述
Content-TypeString是application/json请求头字段

Query

参数类型是否必选示例值描述
ActionString是UpdateImageAuditTask接口名称。当前 API 的名称为 UpdateImageAuditTask。
VersionString是2018-08-01接口版本。当前 API 的版本为 2018-08-01。

Body

参数类型是否必选示例值描述
RegionString否cn任务地区。当前仅支持取值 cn，表示国内。
TaskIdString是98172790****918301任务 ID，您可通过调用 查询所有审核任务 获取所需的任务 ID。

EnableAuditRange

String

否

0

仅当 Type 取值 Upload 时，配置生效。
审核范围，取值如下所示：

  • 0：（默认）不限范围
  • 1：指定范围

AuditPrefix

Array of String

否

["123/"]

仅当 EnableAuditRange 取值 1 时，配置生效。
指定前缀审核，若你希望对某个目录进行审核，请设置路径为对应的目录名，以/结尾。例如123/

NoAuditPrefix

Array of String

否

["abc/"]

仅当 EnableAuditRange 取值 1 时，配置生效。
指定前缀不审核，若你希望对某个目录不进行审核，请设置路径为对应的目录名，以/结尾。例如123/

AuditDimensions

Array of String

是

["porn","sensitive1","sensitive2"]

审核维度，根据审核能力的不同，其具体取值不同。基础审核与智能审核之间不支持混用。

  • 基础安全审核，仅当 AuditAbility 取值为 0 时，配置生效。
    • govern：涉政
    • porn ：涉黄
    • illegal：违法违规
    • terror：涉暴
  • 智能安全审核，仅当 AuditAbility 取值为 1 时，配置生效。
    • 图像风险识别
      • porn ：涉黄，主要适用于通用色情、色情动作、性行为、性暗示、性分泌物、色情动漫、色情裸露等涉黄场景的风险识别
      • sensitive1 ：涉敏1，具体指涉及暴恐风险
      • sensitive2：涉敏2，具体值涉及政治内容风险
      • forbidden：违禁，主要适用于打架斗殴、爆炸、劣迹艺人等场景的风险识别
      • uncomfortable：引人不适，主要适用于恶心、恐怖、尸体、血腥等引人不适场景的风险识别
      • qrcode：二维码，主要适用于识别常见二维码（QQ、微信、其他二维码等）
      • badpicture：不良画面，主要适用于自我伤害、丧葬、不当车播、吸烟/纹身/竖中指等不良社会风气的风险识别
      • sexy：性感低俗，主要适用于舌吻、穿衣性行为、擦边裸露等多种性感低俗场景的风险识别
      • age：年龄，主要适用于图中人物对应的年龄段识别
      • underage：未成年相关，主要适用于儿童色情、儿童邪典等风险识别
      • quality：图片质量，主要适用于图片模糊、纯色边框、纯色屏等风险识别
    • 图文风险识别，您可在 AuditTextDimensions 配置文字审核的维度。

    说明

    您可将智能安全审核的图像风险识别和图文风险识别搭配使用。

AuditTextDimensions

Array of String

否

["ad"]

智能安全审核类型下图片文本审核的具体维度，取值如下所示：

  • ad：广告，综合图像及文字内容智能识别广告
  • defraud：诈骗，综合图像及文字内容智能识别诈骗
  • charillegal：文字违规，图片上存在涉黄、涉敏、违禁等违规文字

说明

仅当 AuditDimensions 取值为智能安全审核模型时，您可将 AuditTextDimensions 与 AuditDimensions 搭配使用。

EnableFreeze

Boolean

否

true

是否开启冻结，取值如下所示：

  • true：开启
  • false：（默认）不开启

FreezeType

Array of String

否

["nopass","recheck"]

冻结措施，取值如下所示：

  • recheck：建议复审
  • nopass：审核不通过

FreezeDimensions

Array of String

否

["porn","sensitive1"]

冻结维度，取值需要与 AuditDimensions 审核维度保持一致或少于 AuditDimensions。
例如，AuditDimensions 取值 ["pron","sexy"]，AuditTextDimensions 取值 ["ad"]，支持您将 FreezeDimensions 取值 ["pron","sexy","ad"] 、 ["pron","sexy"]、["pron","ad"] 和 ["sexy","ad"] 任意一种。

FreezeStrategyFloat否0冻结策略，当前仅支持取 0，表示禁用图片。

EnableCallback

Boolean

否

true

是否开启回调，取值如下所示：

  • true：开启
  • false：（默认）不开启

CallbackDimensions

Array of String

否

["porn","sensitive1"]

回调类型，取值需要与 AuditDimensions 审核维度保持一致或少于 AuditDimensions。
例如，AuditDimensions 取值 ["pron","sexy"]，AuditTextDimensions 取值 ["ad"]，支持您将 FreezeDimensions 取值 ["pron","sexy","ad"] 、 ["pron","sexy"]、["pron","ad"] 和 ["sexy","ad"] 任意一种。

CallbackImageTypes

Array of String

否

["problem","frozen"]

回调图片类型，取值如下所示：

  • normal：正常图片

  • problem：问题图片

  • frozen：冻结图片

  • fail：审核失败图片

CallbackUrlString否http://example.callback.com回调 URL，veImageX 以 Post 方式向业务服务器发送 JSON 格式回调数据。具体回调参数请参考回调内容。

返回参数

本接口暂无特有的返回参数。更多信息请见公共返回参数。

示例

请求示例

POST https://imagex.volcengineapi.com/?Action=UpdateImageAuditTask&Version=2018-08-01
{
  "ServiceId": "lk**i0",
  "TaskId": "010802*****01281",
  "Type": "UrlFile",
  "AuditDimensions": [
    "porn",
    "sensitive1",
    "sensitive2"
  ],
  "AuditTextDimensions": [
    "ad"
  ],
  "AuditAbility": 1,
  "EnableFreeze": true,
  "EnableCallback": true,
  "FreezeType": [
    "nopass",
    "recheck"
  ],
  "FreezeDimensions": [
    "porn",
    "sensitive1"
  ],
  "FreezeStrategy": 0,
  "CallbackDimensions": [
    "porn",
    "sensitive1"
  ],
  "CallbackImageTypes": [
    "problem",
    "frozen"
  ],
  "CallbackUrl": "http://example.callback.com"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20231016174144CD8C36D58177D5DDE53F",
    "Action": "UpdateImageAuditTask",
    "Version": "2018-08-01",
    "Service": "imagex",
    "Region": "cn-north-1"
  },
  "Result": {
  }
}

错误码

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

服务端 SDK

推荐您使用服务端 SDK 来调用 API，我们已在 GitHub 提供了 PHP 的参考示例。