调用ImAudit对图片、文本内容进行审核。

使用说明

本接口审核完成后审核结果同步返回。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ImAudit

系统规定参数。取值:ImAudit

Images String ["http://127.66.**.**/image.jpeg","http://127.66.**.**/photo.jpeg"]

图片URL的JSON数组,最大长度为100张。可以通过MPS控制台 > 媒体管理 > 媒体列表获取。图片和文本至少填写一个。待审核图片文件需要符合下述限制,否则可能导致任务失败:

  • 图片大小不超过20 MB,高度或宽度不超过30000px,且图片总像素不超过2.5亿px。
  • (建议)图片像素不低于256×256px,像素过低可能会影响审核效果。
Contents String ["你好呀","你是谁","我在哪里"]

文本JSON数组,用户自定义数组,最大长度为100段。图片和文本至少填写一个。

Scenes String ["porn","terrorism","ad"]

场景说明,用于指定审核场景。支持指定多个场景,用半角逗号(,)分隔。例如,{"porn","terrorism"}表示对图片同时进行智能鉴黄和暴恐摄政检测。取值:

  • porn:图片智能鉴黄。
  • terrorism:图片暴恐涉政。
  • ad:图文违规。
  • qrcode:图片二维码。
  • live:图片不良场景。
  • logo:图片logo。
  • antispam:文本反垃圾(仅对文本生效)。
BizType String 139440480445****

默认为公共配置。

返回数据

名称 类型 示例值 描述
TextQuotaExceed Boolean false

文本审核QPS是否超过限制。取值:true、false。

ImageQuotaExceed Boolean false

图片审核QPS是否超过限制。取值:true(不超过)、false(超过)。

RequestId String 5210DBB0-E327-4D45-ADBC-0B83C8793421

请求ID。

ImageResults Object

图片审核返回结果。调用成功是(code=200),返回结果中包含一个或多个元素。参数详情请参见图文审核接口返回数据

result Array of result

图片审核结果。

code Long 200

错误码,和HTTP状态码一致。如果执行成功则此参数不返回。

dataId String uuid-1234-1234-1234

检测对象对应的数据ID。

说明 如果在检测请求参数中传入了dataId,则此处返回对应的dataId。
extras Map

额外附加信息。图文违规(ad)场景中,该参数可能返回以下内容。

hitLibInfo:如果图片中的文字命中了自定义文本库,则返回命中的文本库信息。格式为数组,更多结构描述请参见hitLibInfo

msg String ok

请求信息的响应信息。

results Array of result

返回结果。调用成功时,返回结果中包含一个或多个元素。每个元素是一个结构体。

Label String sexy

检测结果的分类。不同检测场景的结果分类不同,具体如下:

  • 图片智能鉴黄(porn)结果分类:
    • normal:正常。
    • sexy:性感。
    • porn:色情。
  • 图片暴恐涉政(terrorism)结果分类:
    • normal:正常。
    • bloody:血腥。
    • explosion:爆炸烟光。
    • outfit:特殊装束。
    • logo:特殊标识。
    • weapon:武器。
    • politics:涉政。
    • violence:打斗。
    • crowd:聚众。
    • parade:游行。
    • carcrash:车祸现场。
    • flag:旗帜。
    • location:地标。
    • others:其他。
  • 图文违规(ad)结果分类:
    • normal:正常。
    • ad:其他广告。
    • politics:文字含涉政内容。
    • porn:文字含涉黄内容。
    • abuse:文字含辱骂内容。
    • terrorism:文字含暴恐内容。
    • contraband:文字含违禁内容。
    • spam:文字含其他垃圾内容。
    • npx:牛皮癣广告。
    • qrcode:含二维码。
    • programCode:含小程序码。
  • 图片二维码(qrcode)结果分类:
    • normal:正常。
    • qrcode:含二维码。
    • programCode:含小程序码。
  • 图片不良场景(live)结果分类:
    • normal:正常。
    • meaningless:图片中无内容(例如,黑屏、白屏)。
    • PIP:画中画。
    • smoking:吸烟。
    • drivelive:车内直播。
  • 图片logo(logo)结果分类:
    • normal:正常。
    • TV:含受管控的logo。
    • trademark:含商标。
Rate double 91.54

置信度分数,取值范围:0(表示置信度最低)~100(表示置信度最高)。如果suggestion为pass,则置信度越高,表示内容正常的可能性越高;如果suggestion为review或block,则置信度越低,表示内容违规的可能性越高。

说明 该值仅作为参考,强烈建议您不要在业务中使用。建议您参考suggestion和label(或者部分接口返回的sublabel)结果用于内容违规判定。
Scene String porn

图片检测场景。可取值:

  • porn:图片智能鉴黄。
  • terrorism:图片暴恐涉政。
  • ad:图文违规。
  • qrcode:图片二维码。
  • live:图片不良场景。
  • logo:图片logo。
Suggestion String block

建议您执行的后续操作。可取值:

  • pass:结果正常,无需进行其余操作。
  • review:结果不确定,需要进行人工审核。
  • block:结果违规,建议直接删除或者限制公开。
taskId String img4wlJcb7p4wH4lAP3111111-12****

检测任务的ID。

url String http://example.com/example-****.jpg

检测对象的URL。

TextResults Object

文本审核返回结果。调用成功是(code=200),返回结果中包含一个或多个元素。参数详情请参见图文审核接口返回数据

result Array of result

文本审核结果。

code Long 200

错误码,和HTTP状态码一致。更多信息,请参见错误码表

content String 这是一段测试文本

被检测文本,和调用请求中的待检测文本对应。

dataId String cfd33235-71a4-468b-8137-a5ffe323****

文字的顺序号。

msg String OK

请求消息的响应消息。

results Array of result

返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体。

details Array of details

命中风险信息,一条文本可能命中多条风险详情。

Label String porn

文本命中风险的分类。取值:

  • spam:含垃圾信息。
  • ad:广告。
  • politics:涉政。
  • terrorism:暴恐。
  • abuse:辱骂。
  • porn:色情。
  • flood:灌水。
  • contraband:违禁。
  • meaningless:无意义。
  • customized:自定义(例如命中自定义关键词)。
label String porn

文本垃圾检测结果的分类。取值:

  • normal:正常文本。
  • spam:含垃圾信息。
  • ad:广告。
  • politics:涉政。
  • terrorism:暴恐。
  • abuse:辱骂。
  • porn:色情。
  • flood:灌水。
  • contraband:违禁。
  • meaningless:无意义。
  • customized:自定义(例如命中自定义关键词)。
rate double 99.90

置信度分数,取值范围:0(表示置信度最低)~100(表示置信度最高)。如果suggestion为pass,则置信度越高,表示内容正常的可能性越高;如果suggestion为review或block,则置信度越低,表示内容违规的可能性越高。

说明 该值仅作为参考,强烈建议您不要在业务中使用。建议您参考suggestion和label(或者部分接口返回的sublabel)结果用于内容违规判定。
scene String antispam

检测场景。

suggestion String block

建议您执行的后续操作。取值:

  • pass:文本正常,可以直接放行。
  • review:文本需要进一步人工审核。
  • block:文本违规,可以直接删除或者限制公开。
taskId String txt6HB8NQoEbU@5fosnj2xVEM-1t****

检测任务的ID。

示例

请求示例

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=ImAudit
&Images=["http://127.66.**.**/image.jpeg","http://127.66.**.**/photo.jpeg"]
&Contents=["你好呀","你是谁","我在哪里"]
&Scenes=["porn","terrorism","ad"]
&BizType=139440480445****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ImAuditResponse>
    <TextQuotaExceed>false</TextQuotaExceed>
    <ImageQuotaExceed>false</ImageQuotaExceed>
    <RequestId>5210DBB0-E327-4D45-ADBC-0B83C8793421</RequestId>
    <ImageResults>
        <result>
            <code>200</code>
            <dataId>uuid-1234-1234-1234</dataId>
            <msg>ok</msg>
            <results>
                <Label>sexy</Label>
                <Rate>91.54</Rate>
                <Scene>porn</Scene>
                <Suggestion>block</Suggestion>
            </results>
            <taskId>img4wlJcb7p4wH4lAP3111111-12****</taskId>
            <url>http://example.com/example-****.jpg</url>
        </result>
    </ImageResults>
    <TextResults>
        <result>
            <code>200</code>
            <content>这是一段测试文本</content>
            <dataId>cfd33235-71a4-468b-8137-a5ffe323****</dataId>
            <msg>OK</msg>
            <results>
                <details>
                    <Label>porn</Label>
                </details>
                <label>porn</label>
                <rate>99.9</rate>
                <scene>antispam</scene>
                <suggestion>block</suggestion>
            </results>
            <taskId>txt6HB8NQoEbU@5fosnj2xVEM-1t****</taskId>
        </result>
    </TextResults>
</ImAuditResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TextQuotaExceed" : false,
  "ImageQuotaExceed" : false,
  "RequestId" : "5210DBB0-E327-4D45-ADBC-0B83C8793421",
  "ImageResults" : {
    "result" : [ {
      "code" : 200,
      "dataId" : "uuid-1234-1234-1234",
      "msg" : "ok",
      "results" : [ {
        "Label" : "sexy",
        "Rate" : 91.54,
        "Scene" : "porn",
        "Suggestion" : "block"
      } ],
      "taskId" : "img4wlJcb7p4wH4lAP3111111-12****",
      "url" : "http://example.com/example-****.jpg"
    } ]
  },
  "TextResults" : {
    "result" : [ {
      "code" : 200,
      "content" : "这是一段测试文本",
      "dataId" : "cfd33235-71a4-468b-8137-a5ffe323****",
      "msg" : "OK",
      "results" : [ {
        "details" : [ {
          "Label" : "porn"
        } ],
        "label" : "porn",
        "rate" : 99.9,
        "scene" : "antispam",
        "suggestion" : "block"
      } ],
      "taskId" : "txt6HB8NQoEbU@5fosnj2xVEM-1t****"
    } ]
  }
}

错误码

访问错误中心查看更多错误码。