跳到主要内容

同步文本识别（审核）

1. 接口介绍​

对文本中的色情、涉政、暴恐、敏感、广告、谩骂等违法低质内容进行识别及过滤，并实时返回审核结果。

  • 字数限制：同步文本识别接口最大支持 2, 000 个字符识别。

  • 支持语种：文本审核默认识别中文，如需识别其他语种（例如，英文、日语、韩语、泰语、越南语、马来语、印尼语、印地语、菲律宾语、阿拉伯语、土耳其语、俄语、德语、法语、意大利语、西班牙语、葡萄牙语等）中的风险内容，请联系我们进行相应配置，以保证识别效果。

2. 请求​

2.1 请求地址​

区域请求地址
国内http://api.text.tuputech.com/v3/recognition/text/<secretId>
国外http://api-us.open.tuputech.com/v3/recognition/text/<secretId>
国外http://api-oversea.open.tuputech.com/v3/recognition/text/<secretId>
提示

<secretId> 需替换为您的 secretId，请联系我们为您开通 secretId。

2.2 请求方法​

POST

2.3 请求头​

Content-Type: application/json

2.4 QPS 限制​

  • 1 秒最多允许请求 50 次；
  • 1 个请求最多携带 10 个文本；

如有特殊并发需求，请联系我们。

2.5 请求参数说明​

参数名类型是否必填说明
textArray是请求的文本相关内容, 详见 text 参数说明
timestampNumber是当前的服务器的 Unix 时间戳
nonceNumber是随机数
signatureString是

RSA-SHA256 算法签名。签名步骤：

  1. 将参与签名的参数（secretId，timestamp，nonce）用英文半角逗号 , 拼接，得到 SignString；
  2. 使用您的私钥以 RSA-SHA256 算法对 SignString 签名，然后进行 Base64 编码，得到 signature 字符串。

Text 参数说明​

参数名类型是否必填说明
contentString是待检测的文本内容，可以为词语或句子，最大支持 2,000 字符
contentIdString否客户自定义信息，方便根据该 ID 找到相关的文本, 建议可设置为 secretId + 当前时间 + 随机数，参考请求示例
userIdString否用户 ID
forumIdString否板块 ID

2.6 请求示例​

{
  "text": [
    {
      "content": "32132131",
      "contentId": "5bcf23077f532488c2ccd6a615414997698270",
      "userId": "test",
      "forumId": "car"
    }
  ],
  "timestamp": 1541499770,
  "nonce": 0.8469537531104208,
  "signature": "CsIMcHuWqn/QFEnHWcFEhrB7ydcg5xTKawpRpNqA9Nw2WlCVIDR5jDcyUF85"
}

3. 返回结果​

3.1 返回参数说明​

TaskId​

57c4036c557603652aeeb222

TaskId 对象中的数据结构​

参数名类型是否必有说明
textsArray是识别的详细结果, 具体数据结构详见：Texts 数据结构

Texts 数据结构​

参数名类型是否必有说明
contentString是检测的文本内容
actionString是检测结果, pass : 通过， block : 不通过, review : 复审
labelString是命中的标签，详见返回标签说明
reviewBool是是否需要复审， true ：需要， false ：不需要
rateFloat是吻合分数，分数越高，识别出来的结果越准确，取值为 0 到 1 之间或者空值 null（外语语种审核不返还分数）
detailsArray是命中的关键词详细信息，如果 actions 为 pass ，则 details 为空数组，详见：Details 数据结构
contentIdString否客户自定义信息
userIdString否用户 ID
forumIdString否版块 ID

Details 数据结构​

参数名类型是否必有说明
keywordString否命中的关键词。
1. 若命中算法模型，值为空字符串；
2. 若命中单个关键词，值为关键词字符串，例如： 习近平 ；
3. 若同时命中多个关键词（组合规则），值为通过 + 拼接，且被括号包裹的字符串，例如： (加+微信) ； (A+B) 表示关键词 A 与 B 之间无顺序要求， {A+B} 表示关键词 A 与 B 之间按照出现顺序匹配
hintString否检测文本中的违规内容片段，例如原文为 那我先加您微信，发您一下 ，值为： 加您微信
mainLabelString否命中的风险主标签，详见返回标签说明
subLabelString否二级标签

3.2 返回标签说明​

label 与 mainLabel 值说明

label 值说明
Normal正常
Terror暴恐
Porn色情
Politics涉政
Sensitive敏感
ADs广告
Abuse谩骂
UserDefine自定义

3.3 返回示例​

{
  "57c4036c557603652aeeb222": {
    "texts": [
      {
        "contentId": "5c495dd6ca4faa03dafcb05215517048827110.9555874784367748",
        "userId": "Test",
        "forumId": "test",
        "content": "早晨",
        "action": "pass",
        "label": "Normal",
        "review": false,
        "rate": 0.998047,
        "details": []
      },
      {
        "contentId": "5c495dd6ca4faa03dafcb05215517048827110.9555874784367748",
        "userId": "Test",
        "forumId": "test",
        "content": "毛！！泽！！东",
        "action": "block",
        "label": "Politics",
        "review": false,
        "rate": 1,
        "details": [
          {
            "keyword": "毛泽东",
            "hint": "毛！！泽！！东",
            "mainLabel": "Politics",
            "subLabel": "National_Leader"
          }
        ]
      }
    ]
  },
  "code": 0,
  "message": "success",
  "nonce": "0.9224814879136034",
  "timestamp": 1551704883139
}