开发
API

图片检测 V2

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

请求地址

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

请求参数

请求 Body

属性数据类型必填说明
app_idstring小程序 ID
access_tokenstring小程序 access_token,参考登录凭证检验
imagestring检测的图片链接
image_datastring图片数据的 base64 格式,有 image 字段时,此字段无效

返回值

正确返回的 JSON 如下:

属性数据类型说明
errornumber检测结果-状态码
messagestring检测结果-消息
predictsarray检测结果-置信度列表
model_namestring检测结果-置信度-模型/标签
hitboolean检测结果-置信度-结果,当值为 true 时表示检测的图片包含违法违规内容,比如是广告

errCode

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

错误号描述
0成功
1参数有误
2access_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

  • imageimage_data 至少存在一个,同时存在时 image_data 无效。
  • 请求 bodyContent-Type限定为application/json
  • 该接口请在开发者服务器端请求。

常见问题

已经添加图片检测,但审核打回:图片类型检测没有通过

点击纠错
评价此篇文档