图片检测V2
收藏
我的收藏

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

请求地址

线上地址

POST https://developer.toutiao.com/api/apps/censor/image

沙盒地址

POST https://open-sandbox.douyin.com/api/apps/censor/image

请求参数

请求 Body

属性	数据类型	必填	说明
`app_id`	string	是	小程序 ID
`access_token`	string	是	小程序 `access_token`，参考登录凭证检验
`image`	string	否	检测的图片链接
`image_data`	string	否	图片数据的 `base64` 格式，有 `image` 字段时，此字段无效

返回值

正确返回的 JSON 如下：

属性	数据类型	说明
`error`	number	检测结果-状态码
`message`	string	检测结果-消息
`predicts`	array	检测结果-置信度列表
`model_name`	string	检测结果-置信度-模型/标签
`hit`	boolean	检测结果-置信度-结果，当值为 `true` 时表示检测的图片包含违法违规内容，比如是广告

errCode

当请求失败时，会返回非 0 的 error，错误信息会携带在 message 中，错误码含义如下：

错误号	描述
`0`	成功
`1`	参数有误
`2`	`access_token` 校验失败
`3`	图片下载失败
`4`	服务内部错误

图片检测返回模型特征

模型特征	说明
`porn`	图片涉黄
`cartoon_leader`	领导人漫画
`anniversary_flag`	特殊标志
`sensitive_flag`	敏感旗帜
`sensitive_text`	敏感文字
`leader_recognition`	敏感人物
`bloody`	图片血腥
`fandongtaibiao`	未准入台标
`plant_ppx`	图片涉毒
`high_risk_social_event`	社会事件
`high_risk_boom`	爆炸
`high_risk_money`	人民币
`high_risk_terrorist_uniform`	极端服饰
`high_risk_sensitive_map`	敏感地图
`great_hall`	大会堂
`cartoon_porn`	色情动漫
`party_founding_memorial`	建党纪念

请求示例

请求 body

{
  "app_id": "ttxxxxxxxxxxxxxxxx",
  "access_token": "0d495e15563015e3f599c742384f546cac4ce63911464106af8094a0581bae7386dcff77b1b9b6fc4c16b69c9048ba2a2846c7ae8d8f07aa8b84a52bcb4d560a5b8724d99f8816600b5xxxxxxxxxx",
  "image": "https://image.url"
}

返回示例

正常返回

{
  "error": 0,
  "message": "image censor success",
  "predicts": [
    {
      "model_name": "anniversary_flag",
      "hit": false
    },
    {
      "model_name": "bloody",
      "hit": false
    },
    {
      "model_name": "high_risk_boom",
      "hit": false
    },
    {
      "model_name": "cartoon_leader",
      "hit": false
    },
    {
      "model_name": "fandongtaibiao",
      "hit": false
    },
    {
      "model_name": "leader_recognition",
      "hit": false
    },
    {
      "model_name": "high_risk_money",
      "hit": false
    },
    {
      "model_name": "plant_ppx",
      "hit": false
    },
    {
      "model_name": "porn",
      "hit": false
    },
    {
      "model_name": "sensitive_flag",
      "hit": false
    },
    {
      "model_name": "high_risk_sensitive_map",
      "hit": false
    },
    {
      "model_name": "sensitive_text",
      "hit": false
    },
    {
      "model_name": "high_risk_social_event",
      "hit": false
    },
    {
      "model_name": "high_risk_terrorist_uniform",
      "hit": false
    },
    {
      "model_name": "party_founding_memorial",
      "hit": false
    },
    {
      "model_name": "cartoon_porn",
      "hit": false
    },
    {
      "model_name": "great_hall",
      "hit": false
    }
  ]
}

错误返回

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

{
  "error": 2,
  "message": "bad access_token"
}

Bug & Tip

•

image 和 image_data 至少存在一个，同时存在时 image_data 无效。

•

请求 body 的Content-Type限定为application/json。

•

该接口请在开发者服务器端请求。

图片检测V2收藏我的收藏