图像内容审核-API 中心-腾讯云

1. 接口描述

接口请求域名： tiia.tencentcloudapi.com 。

图像审核包含鉴黄、政治敏感识别、暴恐识别、图文审核等服务。

• 鉴黄：识别图片中是否存在涉黄内容，将图片分为正常、性感、色情三类，并输出分类的置信度。

• 政治敏感识别：识别图片中是否存在政治人物、政治恶搞、著名政治事件照片等内容。

• 暴恐识别：识别图片中的暴力恐怖元素，例如武器、管制刀具、血腥、恐怖主义等。

• 图文审核：结合OCR、NLP和二维码识别算法，分析图片中的文字是否违规，或是否存在二维码等营销内容，并输出违规内容的类别（涉黄、涉政、谩骂、广告营销、暴恐等）。

为了方便使用、减少图片传输次数，图像审核包装成多合一接口，实际上是多个服务。

图像审核根据服务的调用次数收费。例如一张图片同时调用鉴黄、图文审核两个服务，那么此次调用按照两次计费。

公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：ImageModeration。
Version	是	String	公共参数，本接口取值：2019-05-29。
Region	是	String	公共参数，详见产品支持的地域列表。
Scenes.N	是	Array of String	本次调用支持的识别场景，可选值如下： 1. PORN，即色情识别 2. TERRORISM，即暴恐识别 3. POLITICS，即政治敏感识别 4. TEXT, 即图像文本识别支持多场景（Scenes）一起检测。例如，使用 Scenes=["PORN", "TERRORISM"]，即对一张图片同时进行色情识别和暴恐识别。
ImageUrl	否	String	图片URL地址。图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 TEXT场景要求图片经Base64编码后不超过3M。 • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边：短边<5；接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。
Config	否	String	预留字段，后期用于展示更多识别信息。
Extra	否	String	透传字段，透传简单信息。
ImageBase64	否	String	图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。注意：图片需要base64编码，并且要去掉编码头部。

3. 输出参数

参数名称	类型	描述
Suggestion	String	识别场景的审核结论： PASS：正常 REVIEW：疑似 BLOCK：违规
PornResult	PornResult	色情识别结果。注意：此字段可能返回 null，表示取不到有效值。
TerrorismResult	TerrorismResult	暴恐识别结果。注意：此字段可能返回 null，表示取不到有效值。
PoliticsResult	PoliticsResult	政治敏感识别结果。注意：此字段可能返回 null，表示取不到有效值。
Extra	String	透传字段，透传简单信息。
DisgustResult	DisgustResult	恶心内容识别结果。注意：此字段可能返回 null，表示取不到有效值。
TextResult	TextResult	文字识别结果。注意：此字段可能返回 null，表示取不到有效值。
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 多个识别场景调用都成功

例：同时调用色情识别、暴恐识别和政治敏感识别，返回结果均为成功。

输入示例

https://tiia.tencentcloudapi.com/?Action=ImageModeration
&ImageUrl=https://xx/a.jpg
&Config=''
&Scenes.0=PORN
&Scenes.1=POLITICS
&Scenes.2=TERRORISM
&Scenes.3=TEXT
&<公共请求参数>

输出示例

{
  "Response": {
    "Suggestion": "REVIEW",
    "PornResult": {
      "Code": 0,
      "Msg": "OK",
      "Suggestion": "PASS",
      "Confidence": 83,
      "AdvancedInfo": "",
      "Type": "LABEL"
    },
    "PoliticsResult": {
      "Code": 0,
      "Msg": "OK",
      "Suggestion": "PASS",
      "Confidence": 8,
      "FaceResults": [
        {
          "FaceRect": {
            "Height": 221,
            "Width": 221,
            "X": 98,
            "Y": 115
          },
          "Candidates": [
            {
              "Name": "本拉登",
              "Confidence": 8
            }
          ]
        }
      ],
      "Type": "FACE"
    },
    "TerrorismResult": {
      "Code": 0,
      "Msg": "OK",
      "Suggestion": "REVIEW",
      "Confidence": 42,
      "AdvancedInfo": "",
      "FaceResults": [],
      "Type": "LABEL"
    },
    "TextResult": {
      "Keywords": [
        "美女&包夜"
      ],
      "Type": "PORN",
      "Code": 0,
      "Msg": "成功",
      "Confidence": 82,
      "Suggestion": "REVIEW",
      "AdvancedInfo": ""
    },
    "Extra": "",
    "RequestId": "02f1733c-1bfe-49ed-9e72-8ecd6ba058dd"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力，能显著降低使用云 API 的难度，推荐使用。

API 3.0 Explorer

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
FailedOperation.DownLoadError	文件下载失败。
FailedOperation.ImageDecodeFailed	图片解码失败。
FailedOperation.InvokeChargeError	调用计费返回失败。
FailedOperation.RequestTimeout	后端服务超时。
FailedOperation.TooLargeFileError	文件太大。
FailedOperation.UnKnowError	内部错误。
FailedOperation.UnOpenError	服务未开通。
InvalidParameterValue.InvalidParameterValueLimit	参数值错误。
ResourcesSoldOut.ChargeStatusException	计费状态异常。

图像内容审核

本页目录：