内容安全检测

收藏

我的收藏

检测一段文本是否包含违法违规内容。

请求地址

线上地址

POST https://developer.toutiao.com/api/v2/tags/text/antidirt

沙盒地址

POST https://open-sandbox.douyin.com/api/v2/tags/text/antidirt

请求参数

请求 Headers

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

请求 Body

属性	数据类型	必填	说明
tasks	array	是	检测任务列表
content	string	是	检测的文本内容

返回值

正确返回的 JSON 如下：

属性	数据类型	说明
log_id	string	请求 id
data	array	检测结果列表
code	number	检测结果-状态码
msg	string	检测结果-消息
data_id	string	检测结果-数据 id
task_id	string	检测结果-任务 id
predicts	array	检测结果-置信度列表
target	string	检测结果-置信度-服务/目标
model_name	string	检测结果-置信度-模型/标签
prob	number	检测结果-置信度-概率，仅供参考，可以忽略
hit	boolean	检测结果-置信度-结果，当值为 true 时表示检测的文本包含违法违规内容

errCode

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

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

请求示例

请求 body

{
  "tasks": [
    {
      "content": "要检测的文本"
    }
  ]
}

返回示例

正常返回

{
  "log_id": "202008181611370100150421452708466F",
  "data": [
    {
      "msg": "",
      "code": 0,
      "task_id": "MICROAPP_6862233737027911687",
      "predicts": [
        {
          "prob": 0,
          "hit": false,
          "target": null,
          "model_name": "short_content_antidirt"
        }
      ],
      "data_id": null
    }
  ]
}

错误返回

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

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

Bug & Tip

• 请求 body 的Content-Type限定为application/json。
• 该接口请在开发者服务器端请求。