产品
热门产品
人工智能
存储
网络
SaaS基础设施
视频云
物联网
应用PaaS
研发运维
专有部署
热门产品
云舟观测 GC
一站式数据采集与应用监控观测平台
人工智能
AI平台
天纪大模型开发 TLM
大模型微调、训练
天纪AI开发 TAI
全流程AI开发平台
天纪智能体开发 ADP
大模型驱动的智能体开发
天纪智能问答 RDP
检索增强生成(RAG)的问答
AI应用
内容审核 CM
图片审核|文本审核|音频审核|视频审核
人脸人体识别 FHR
人脸识别|人体识别|人脸比对|摔倒检测
OCR识别 OCR
卡证识别|通用文本识别|车牌识别
图像技术 IA
面向图片场景提供的多种人工智能技术
模型市场 MaaS
图片、音频、视频等多场景的算法模型
视觉分析
视图计算 VEC
云边融合 AI赋能的智能视图计算
存储
对象存储 OBS
稳定、安全、可靠的云存储服务
文件存储 QHDFS
具有标准HDFS访问协议的分布式文件系统
网络
内容分发网络 CDN
安全、稳定、低延时的分发加速服务
P2P内容分发 PCDN
利用闲置资源而构建的低成本高品质CDN
SaaS基础设施
API文档管理 APICloud
API文档、调试、MOCK一体化协作平台
统一身份认证 IAM
统一的身份认证、授权管理
幕印企业学堂 MuYin
企业培训|内容付费|知识营销
视频云
视频直播 LIVE
大规模实时转码、低延时的直播服务
视频点播 VOD
视频流畅播放服务
音视频通话 RTC
便捷的跨平台实时音视频互动直播服务
媒体处理 MPC
简洁的云媒体转码及内容合成处理服务
视频工具 SDK
视频剪辑SDK | 播放SDK
易讲教室直播 YiJiang
视频技术与传统教室融合
物联网
帝视物联网 IOT
低延时、海量存储的物联网视频监控服务
生活物联网平台
针对消费级智能设备的物联网平台
应用PaaS
云短信 SMS
融合三网,安全可信的短信服务
研发运维
云舟观测 GC
一站式数据采集与应用监控观测平台
三六零天御加固保 JiaGu
提供安全可靠的加固防护产品及服务
兼容性测试 OpenTest
提供数百款TOP机型的云测服务
真机租用 RentPhone
远程真机租用,流畅体验如手机在手
iOS预审 iOSPre
智能扫描、分析、筛查ios审核的被拒风险点
专有部署
360云计算管理平台 Stack
规划、建设、运维一体的云计算解决方案
奇麟大数据 QiLin
企业级一站式大数据平台
360容器管理平台 Container
可对外私有化的容器云平台
360AI开发平台专有版 Prophet
全流程机器学习开发平台
更多产品,敬请期待
解决方案
产品解决方案
行业解决方案
产品解决方案
视频
通用直播解决方案
短视频解决方案
公共语音房聊天室解决方案
物联网
儿童手表音视频通话
云端NVR解决方案
数据上云
通用存储解决方案
IoT设备
AI+IPC解决方案
智能门锁解决方案
安防传感解决方案
智能网关解决方案
个护健康解决方案
账号体系
360用户帐号体系解决方案
行业解决方案
智慧城市
智慧社区解决方案
智慧交通解决方案
电商视频解决方案
电商视频解决方案
电商平台收款解决方案
教育
在线教育解决方案
互动课堂解决方案
全屋智能
智慧公寓解决方案
智慧酒店解决方案
家庭智能解决方案
智慧安防解决方案
医疗
健康看护解决方案
智能制造
工业物联网解决方案
游戏
游戏音视频解决方案
更多解决方案,敬请期待
帮助支持
技术社区
关于我们
控制台
登录
注册
内容审核
云直播
产品文档
常见问题
API文档
云点播
产品文档
快速入门
API文档
CDN
产品文档
API文档
云存储
产品文档
SDK手册
API文档
互动直播
产品文档
API文档
操作指南
SDK管理
播放SDK
上传SDK
剪辑SDK
媒体处理
产品文档
API文档
帝视
产品文档
API文档
操作指南
支付平台
产品列表
产品文档
渠道接入解析
内容审核
产品文档
API文档
OCR识别
产品文档
API文档
人脸与人体识别
产品文档
API文档
SSL证书
产品说明
购买指南
电子签章
产品介绍
接入流程
云短信
接口文档
物联网平台
产品简介
快速入门
幕印企业学堂
产品介绍
生活物联网平台
产品简介
快速入门
图片处理
产品介绍
接口文档
视图计算
产品介绍
快速入门
常见问题
易讲-教室直播
产品介绍
帮助说明
产品说明
内容审核产品文档
服务开通操作手册
内容审核API文档
图片审核API(单张)
文本审核API(单条)
音频审核API
音频流审核API
视频审核API
视频流审核API
网页审核API
文档审核API
SDK示例
首页
>
开发者中心
>
内容审核
>
内容审核API文档
>
文本审核API(单条)
# 文本审核 本文提供了调用文本审核具体接口和参数说明。温馨提示:调用此服务API需登录智汇云官网进行开通,https://zyun.360.cn/manage ### 接口名 /v1/verify/text ### 请求域名 ai.zyun.360.cn ### 通讯协议 支持通过HTTP协议进行请求通信 ### 请求方式 支持post方式发送请求 ### 请求参数 #### Header头中传递的参数 |参数 |参数名 |参数描述| | ------------ | ------------ | ------------ | |Authorization |鉴权信息 |鉴权信息规则参见下方规则详细描述。| |Auth-Time| 当前时间 |规则参见下方详细描述。| |Rand-Num |随机数 |规则参见下方详细描述。| |Auth-Ver |版本号 |固定值:1.0| ####header认证参数说明 |参数名称 |说明| 用法| | ------------ | ------------ | |Authorization|认证字符串| 生成第一步:将AK、auth_time、rand_num、param_sign 拼接成一个字符串、中间用"\n"分隔。第二步:用SK对第一步生成的字符串做sha1加密,生成authorization | |Auth-Ver|认证版本| 1.0 | |Auth-Time|认证时间| 表示此次操作的时间,unix系统时间戳(10位)(不能为空,如果请求中的Auth-Time时间和服务器的时间差15分钟以上,服务器将拒绝该服务,并返回ERROR错误) | |Rand-Num|随机正整数| 表示一个随机正整数(rand生成即可) | ##Authorization生成规则 ``` $auth_time = time(); $auth_string = $ak . "\n" . $auth_time . "\n" . $rand_num . "\n" . $param_sign; $encrypt_string = base64_encode(hash_hmac("sha1", $auth_string, $sk, true)); $authorization = $ak . ":" . $encrypt_string; ``` ###构造密码串 |参数说明 |参数名称 |说明| 用法| | ------------ | ------------ | |auth_time |unxi时间戳(10位)| | |ak |Access Key| 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey | |sk |Secret Access Key| 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey| |rand_num |随机正整数| | |param_sign|参数按键排序并加入随机因子| 所有参数按key做升序排序后串成字符串$paramStr,然后 $paramStr的md5值连上$rand_num,然后再用md5计算得到的值为param_sign paramStr排序例子: 参数 { a1:v1, b1:v3, a2:v2 } 排序后的字符串为 a1=v1a2=v2b1=v3 | #### body中传递的参数(post) | 参数名称 | 必选 |类型 | 参数说明 | | ------------ | ------------ | ------------ | |template_id |true | string | 用户在智汇云官网申请的审核模板ID | |scene |true | string| 业务使用场景 可选值: live 直播 shopping 电商 game 游戏 news 新闻资讯 forum 论坛 social 社交 | | text_type | true | int | 文本的特殊含义,例如代表昵称、签名等,默认按照0处理,无特殊场景请选0 ;可选值: 0 无特殊含义 1 昵称 2 签名 3 群聊 4 文章 5 动态 6 评论 7 标题 8 主题/话题 9 商品描述 10 私聊 11 弹幕 | |text | true | string | 文本内容,不超过4000个字符(单个中文汉字和英文字母均看作一个字符 | |callback | false | string | 回调地址。当此参数不为空时,认定为异步任务。 | ###请求示例 ``` POST /v1/verify/text HTTP/1.1 Auth-Ver: 1.0 Auth-Time: 1587974786 Rand-Num: 8888 Authorization:xxxxxxxxxxxxxxxxxxxx User-Agent: PostmanRuntime/7.24.1 Accept: */* Cache-Control: no-cache Postman-Token: 14a15c58-c5fa-4712-90d4-24534b491232 Accept-Encoding: gzip, deflate, br Connection: keep-alive Content-Type: multipart/form-data; boundary=--------------------------769354003527143578128173 Content-Length: 562 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="text" xxx,xxx,xxx,请加微信889089 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="text_type" 0 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="template_id" 158771917344392482224503 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="scene" live ----------------------------769354003527143578128173-- ``` ### 返回结果以json为例 ``` { "errcode": 0, "errmsg": "ok", "data": { "taskid": "TID_T_T_2020042773500998417", "request_time": 1587974827, "cost": 0.310434319, "body": { "sid": "TEXT_V_KS_73534552849", "text": "xxx,xxx,xxx,请加微信889089", "suggest_summary": "REJECT", "suggest_summary_desc": "文本内容违规,建议直接拦截", "items": [ { "model": "COMMON", "label": "other", "label_desc": "其他", "score": 1, "words": [ "XXX" ] }, { "model": "COMMON", "label": "politics", "label_desc": "涉政", "score": 1, "words": [ "XXX", "XXX" ] }, { "model": "COMMON", "label": "ad", "label_desc": "广告", "score": 1, "words": [] }, { "model": "COMMON", "label": "violence", "label_desc": "涉暴", "score": 0.9259999990463257, "words": [ "XX" ] } ] } } } ``` ### 审核通过 ``` { "errcode": 0, "errmsg": "ok", "data": { "taskid": "TID_T_T_2020042719355572124433", "request_time": 1587986320, "cost": 0.254775359, "body": { "sid": "TEXT_V_KS_19355588901649", "text": "蓝天白云", "suggest_summary": "PASS", "suggest_summary_desc": "文本内容正常,建议放行", "items": [ { "model": "COMMON", "label": "normal", "label_desc": "正常", "score": 1, "words": [] } ] } } } ``` ### 异步回调结果 ``` { "errcode": 0, "errmsg": "ok", "data": { "taskid": "TID_T_Y_2020042719661336886033" } } ``` ### 返回结果说明 ####同步返回结果说明 |字段名| 类型 |说明| 备注| | ------------ | ------------ | ------------ | |taskid |string | 任务ID | 系统生成: 文本审核执行任务ID(异步任务是,同步返回,用于任务查询,回调) | |sid |string | 文本处理ID | 系统生成:文本审核任务查找,排查的ID | |suggest_summary | string | 审核结果 | "PASS": "文本内容正常,建议放行", "REVIEW": "文本内容可疑,建议人工审核", "REJECT": "文本内容违规,建议直接拦截" | |suggest_summary_desc | string | 审核结果文字说明 | 同上 | |items | []item | 命中风险项 | 命中的每个违规类型的详情 | ##### item数据结构 |字段名| 类型 |说明| 备注| | ------------ | ------------ | ------------ | |model |string | 文本审核模型 | COMMON:通用文本审核 | |label |string | 违规类型 | 系统生成: 审核结果命中标签 | |label_desc | string | 违规类型说明 | 系统生成:审核结果命中标签描述 | |score | float64 | 置信值 | 置信值越高,结果越可信 | |words | string[] | 命中的违规词 | ["习近平","邓小平","共产党"] | ### 错误码说明 |错误码| 含义 |场景| | ------------ | ------------ | ------------ | |400004 |参数错误 | 文本审核必传参数缺失,文本场景、文本类型不在可选列表内 | |440101 |模板ID格式错误 | 模板ID格式错误 | |440045 | 文本长度超限 | 文本长度超过4000个字符(单个中文汉字和英文字母均看作一个字符) | |441043 | 审核模板不存在 | 传入的模板ID不存在 | |441061 | 审核模板被禁用, 请联系客服 | 模板处于停用状态 | |441062 | 审核模板配置信息错误,请联系客服 | 模板ID对应的审核内容不是文本审核或者模板ID不属于当前通过认证的账号 | |441038 | 审核模板状态错误,请联系管理员 | 该模板的状态非有效状态 | # 异步文本审核结果查询(单条) ### 接口名 /v1/verify/text ### 接口描述 用于异步请求时,未收到回调结果时接入方主动查询审核结果 ### 请求域名 ai.zyun.360.cn ### 通讯协议 支持通过HTTP协议进行请求通信 ### 请求方式 支持post方式发送请求 ### 请求说明 | 参数名称 | 必选 |类型 | 参数说明 | | ------------ | ------------ | ------------ | |template_id |true | string | 用户在智汇云官网申请的审核模板ID | #### body中传递的参数(post) | 参数 | 类型 |是否必填 | 描述 | | ------------ | ------------ | ------------ | |taskid |string | true | 异步请求返回的taskid | ### 请求示例 ``` POST /v1/verify/textQuery HTTP/1.1 Host: 10.145.76.88:8385 Accept: */* Authorization:xxxxxxxxxxxxxxxxxxxxxxx Auth-Ver:1.0 Auth-Time:1588078102 Rand-Num:8888 Content-Length: 35 Content-Type: application/x-www-form-urlencoded taskid=TID_T_Y_20200428468302449752 ``` ### 返回示例(与文本审核返回数据结构相同) ``` { "errcode": 0, "errmsg": "ok", "data": { "taskid": "TID_T_Y_20200428468302449752", "request_time": 1588077544, "cost": 0.415697045, "body": { "sid": "TEXT_V_KS_468352781400", "text": "xx,xx,你好朋友", "suggest_summary": "REVIEW", "suggest_summary_desc": "文本内容可疑,建议人工审核", "items": [ { "model": "COMMON", "label": "politics", "label_desc": "涉政", "score": 0.9, "words": [ "xx" ] }, { "model": "COMMON", "label": "violence", "label_desc": "涉暴", "score": 0.8, "words": [ "xx" ] } ] } } } ``` #文本审核结果纠错 ### 接口名 /v1/verify/text_calibrate ### 请求域名 ai.zyun.360.cn ### 通讯协议 支持通过HTTP协议进行请求通信 ### 请求方式 支持post方式发送请求 ### 请求参数 #### Header头中传递的参数 | 参数 | 参数名 | 参数描述 | | ------------- | -------- | ------------------------------ | | Authorization | 鉴权信息 | 鉴权信息规则参见鉴权详细描述。 | | Auth-Time | 当前时间 | 规则参见鉴权详细描述。 | | Rand-Num | 随机数 | 规则参见鉴权详细描述。 | | Auth-Ver | 版本号 | 固定值:1.0 | #### body中传递的参数(post) | 参数名称 | 必选 | 类型 | 参数说明 | | ----------- | ----- | ------ | ------------------------------------------------------------ | | template_id | true | string | 文本审核模板ID,在控制台中可以创建 | | taskid | true | string | 文本审核任务唯一标识 | | type | true | string | 纠错类型 error:误杀 miss漏杀 | | labelId | false | int | 纠错类型为漏杀时必传 内容风险类型 1:涉政 2:色情 3:性感 4:广告 5:暴恐 6:违禁 7:商企logo 8:二维码 9:社交人脸 10:未成年人 11:公众人物 12:不良行为 13:辱骂 14:灌水 15:无意义 | | riskLevel | true | string | 期望处置结果 PASS:通过 REJECT:违规 | ### 请求示例 ``` POST /v1/verify/text_calibrate HTTP/1.1 Auth-Ver: 1.0 Auth-Time: 1587974786 Rand-Num: 8888 Authorization:xxxxxxxxxxxxxxxxxxxx User-Agent: PostmanRuntime/7.24.1 Accept: */* Cache-Control: no-cache Postman-Token: 14a15c58-c5fa-4712-90d4-24534b491232 Accept-Encoding: gzip, deflate, br Connection: keep-alive Content-Type: multipart/form-data; boundary=--------------------------769354003527143578128173 Content-Length: 562 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="template_id" 158771917344392482224503 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="taskid" TID_V_20220602297706882902327 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="type" error ----------------------------769354003527143578128173 Content-Disposition: form-data; name="labelId" 1 ----------------------------769354003527143578128173 Content-Disposition: form-data; name="riskLevel" PASS ```
即刻开始使用
只需完成注册与实名认证,即可体验我们的贴心服务
立即使用
请您联系我们
邮箱
g-zyun@360.cn
电话
4000052360
小安提醒您
试用小安,请确保该账户已通过智汇云实名认证
前往认证中心>>
1对1免费
咨询智汇云专属顾问
为您量身定制产品解决方案
您的姓名 :
手机号 :
公司名称(选填) :
相关产品 :
留言内容 :
需求描述
产品建议
其他
提交
登录后才可以留言哦
立即登录
去注册账号