图片检测

检测图片是否包含违法违规内容。

请求地址

    POST https://developer.toutiao.com/api/v2/tags/image/

请求参数

请求 Headers

属性数据类型必填说明
X-Tokenstring小程序 access_token,参考登录凭证检验

请求 Body

属性数据类型必填说明
targetsarray图片检测服务类型,目前支持 pornpoliticsaddisgusting 四种
tasksarray检测任务列表
imagestring检测的图片链接
image_datastring图片数据的 base64 格式,有 image 字段时,此字段无效

返回值

正确返回的 JSON 如下:

属性数据类型说明
log_idstring请求 id
dataarray检测结果列表
codenumber检测结果-状态码
msgstring检测结果-消息
data_idstring检测结果-数据 id
task_idstring检测结果-任务 id
predictsarray检测结果-置信度列表
targetstring检测结果-置信度-服务/目标
model_namestring检测结果-置信度-模型/标签
probnumber检测结果-置信度-概率,仅供参考,可以忽略
hitboolean检测结果-置信度-结果,当值为 true 时表示检测的图片包含违法违规内容,比如是广告

errCode

当请求失败时,会返回非 0code,错误信息会携带在 message 中,错误码含义如下:

错误号描述
0成功
400参数有误
401access_token 校验失败

图片检测返回模型特征

目标模型特征说明
pornimage_porn图片涉黄
pornimage_vulgar图片低俗
politicsimage_leader图片涉政/领导人
politicsimage_cartoon_leader图片涉政/领导人漫画
adimage_ocr图片 ocr
adimage_qrcode图片二维码
disgustingimage_disgusting图片恶心

请求示例

请求 body

{
  "targets": ["ad", "porn", "politics", "disgusting"],
  "tasks": [
    {
      "image": "https://image.url"
    }
  ]
}

返回示例

正常返回

{
  "log_id": "202008182040220101311330404A050996",
  "data": [
    {
      "msg": "",
      "code": 0,
      "task_id": "MICROAPP_6862302991173550092",
      "predicts": [
        {
          "prob": 0,
          "hit": false,
          "target": "ad",
          "model_name": "image_qrcode"
        },
        {
          "prob": 0,
          "hit": false,
          "target": "ad",
          "model_name": "image_ocr"
        },
        {
          "prob": 0.014402140863239765,
          "hit": false,
          "target": "porn",
          "model_name": "image_porn"
        },
        {
          "prob": 0.00028251955518499017,
          "hit": false,
          "target": "porn",
          "model_name": "image_vulgar"
        }
      ],
      "data_id": null
    }
  ]
}

错误返回

access_token 检验失败时会返回如下信息:

{
  "error_id": "40a69eb094994627ae740d9e15f00ac2",
  "code": 401,
  "message": "[app token sign fail] bad token",
  "exception": "[app token sign fail] bad token"
}

Bug & Tip

  • 请求 body 的Content-Type限定为application/json
  • 该接口请在开发者服务器端请求。
  • imageimage_data 至少存在一个,同时存在时 image_data 无效。
点击纠错
评价此篇文档