内容安全文本异步检测或人工审核的结果,客户可以通过轮询调用该接口获取数据,轮询模式与推送模式互斥,只能选取一种模式进行结果获取 ## 接口说明 该接口返回文本经过人工审核的结果或者文本异步机器检测结果,需要客户通过该接口进行定时轮询获取,当提交检测接口参数callbackUrl为空时,表示结果通过该接口获取,结果可以根据提交检测时返回的taskId对应 ### 鉴权说明 易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权 (https://support.dun.163.com/documents/588434200783982592?docId=588930751964876800) ### 结果说明 - 获取结果后,下次调用,不会再次返回之前获取过的结果 - 接口一次最多返回200个结果,人工审核结果数据默认保留7天,7天不获取会失效,异步检测结果默认保留4小时,超过4小时不获取会失效 - 接口请求频率建议1s一次,过快服务器会拒绝处理,客户可以根据业务需求进行适当调整 - 异步检测一般10s内会检测完成,异步机器检测结果建议尽快获取 ### 接口耗时 结果获取接口的响应很快,正常50ms内返回结果,业务方根据需求适当调整超时时间,建议为1s ### 历史版本 v4版本轮询模式文档请点此查看 (https://support.dun.163.com/documents/2018041901?docId=150426005789659136) ## 请求 ### 请求地址 名称 | 值 HTTP URL | http://as.dun.163.com/v5/text/callback/results (http://as.dun.163.com/v5/text/callback/results) HTTP Method | POST ### 请求头 名称 | 类型 | 描述 Content-Type | String | 固定值:"application/x-www-form-urlencoded" ### 请求参数 ### 请求参数 请求参数由公共参数和业务参数两部分组成 #### 公共参数 公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数 (https://support.dun.163.com/documents/588434200783982592?docId=588929779347722240) #### 业务参数 名称 | 类型 | 是否必填 | 最大长度 | 描述 version | String | 是 | 4 | 接口版本号,可选值v5.6 yidunRequestId | String | 否 | 64 | 幂等参数说明 (https://support.dun.163.com/documents/588434393394810880?docId=708481399616323584) ### 请求体示例 Code: version=v5.2&signature=xxx&secretId=xxx&businessId=xxx×tamp=1677207014000&nonce=1234 ## 响应 该接口可以返回人工审核结果或异步机器检测结果,两类结果响应字段有一定区分,可根据resultType字段进行区分解析,为了方便阅读,下面响应结果分为:人工审核响应结果以及异步检测响应结果。 ### 人工审核响应结果 响应字段如下,响应通用字段已省略,详细见响应公共字段 (https://support.dun.163.com/documents/588434200783982592?docId=588929832340037632),resultType为2时表示人工审核结果,详细字段信息如下: 名称 | 类型 | 是否返回 | 描述 result | Object[] | 是 | 文本回调结果 ∟ antispam | Object | 是 | 文本内容安全检测结果 ∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ suggestion | Number | 是 | 建议动作,0:通过,2:不通过 ∟ remark | String | 否 | 人审备注信息 ∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 ∟ censorType | Number | 是 | 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审 ∟ callback | String | 是 | 产品调用文本同步检测 (https://support.dun.163.com/documents/588434200783982592?docId=589310433773625344)或文本批量同步检测 (https://support.dun.163.com/documents/588434200783982592?docId=589315439839027200)传递的callback字段数据。 ∟ censorExtension | Object | 否 | 人审拓展字段 ∟ qualityInspectionTaskId | String | 是 | 用于质检任务的关联, 父子任务逗号分隔 ∟ qualityInspectionType | Number | 是 | 质检类型,1:人审,2:机审 ∟ censorLabels | Object[] | 是 | 审核标签信息 ∟ code | String | 是 | 审核标签唯一编号 ∟ desc | String | 否 | 选择标签填写的备注内容 ∟ customCode | 否 | String | 自定义审核标签编号 ∟ name | String | 是 | 审核标签的名称 ∟ parentLabelId | String | 是 | 父标签Id ∟ depth | Number | 是 | 层级 ∟ censorSource | Number | 否 | 审核来源,0:易盾人审,1:客户审核,2:易盾机审,3:用户质检,4:易盾质检 ∟ censorRound | Number | 否 | 审核轮数,普通审核轮数为0,高级审核:1-第1轮人审,2-第2轮人审,以此类推,saas人工审核模板配置请参考人工审核模板设置说明文档 (https://support.dun.163.com/documents/359794278577393664?docId=360144401039806464)。若您使用易盾人工审核服务,非必要情况下不要对该字段做解析依赖。人审团队为了您的审核质量,会自发的在某些高风险时段进行多轮审核来保证交付质量,所以该字段可能会在不通知到您的情况下变化,感谢您的配合,有任何问题可以随时联系我们 ∟ censorTime | Number | 否 | 审核时间 ∟ labels | Object[] | 是 | 命中的分类信息,检测通过情况labels默认返回为空数组 ∟ label | Number | 是 | 命中分类,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观 ∟ level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 ∟ subLabels | Object[] | 否 | 细分类信息,可能包含多个 ∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码对照表 ### 人工审核响应体示例 Code (json): { "code":200, "msg":"ok", "result":[ { "antispam":{ "taskId":"wet2h1hhoba8qbik9f3orljg00123rdh", "dataId":"1185546433254492160", "suggestion":2, "remark":"人审备注内容,填写备注才会返回", "resultType":2, "callback":"", "censorType":0, "censorSource":1, "censorRound":0, "censorTime":1639374062208, "censorExtension": { "qualityInspectionTaskId": "xxx" }, "censorLabels":[ { "code":"1604386821661", "customCode":"自定义标签编码", "name":"审核标签名称", "desc":"" }, { "code":"1604386813202", "customCode":"自定义标签编码", "name":"审核标签名称", "desc":"" } ], "isRelatedHit":false, "labels":[ { "label":100, "level":2, "subLabels":[ { "subLabel":"100001" } ] } ] } } ] } ### 异步检测响应结果 响应字段如下,响应通用字段已省略,详细见响应公共字段 (https://support.dun.163.com/documents/588434200783982592?docId=588929832340037632),resultType为1时表示异步机器检测结果,详细字段信息如下: 名称 | 类型 | 是否返回 | 最低版本 | 描述 result | Object[] | 是 | v5.1 | 文本回调结果 ∟ antispam | Object | 是 | v5.1 | 文本内容安全检测结果 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ suggestion | Number | 是 | v5.1 | 建议动作,0:通过,1:嫌疑,2:不通过 ∟ label | Number | 是 | v5.1 | 命中分类,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观 ∟ secondLabel | String | 否 | v5.3 | 命中二级标签细分类 ∟ thirdLabel | String | 否 | v5.3 | 命中三级标签细分类 ∟ riskdescription | String | 否 | v5.3 | 风险描述,拼接 label|secondlabel|thirdlabel 的中文实时示意,注意分隔使用「|」,将上层对应一级分类带入,若存在二级/三级透出拼装,若无可不显示 ∟ customAction | Number | 否 | v5.1 | 自定义动作,0:通过,2:不通过。customAction字段用于saas审核系统-机审标准集中的自定义调度功能,将易盾机器检测嫌疑结果通过配置映射为业务自己的自定义动作,可参考图片流程:https://nos.netease.com/yidun/bceb8815e1f50c2339899976e9a2ec28.png ∟ suggestionLevel | Number | 否 | v5.2 | 嫌疑级别,针对部分定制策略支持命中嫌疑时返回,1:低嫌疑,2:高嫌疑,对通用策略、模型结果暂不支持,v5.2版本新增,默认不返回,如果需要返回请联系策略经理配置 ∟ suggestionRiskLevel | Number | 是 | v5.3 | 描述:0-无 1-低风险 2-中风险 3-高风险 。建议风险等级仅表示该标签在内容风险治理下参考的风险级别,用于做数据分层处置,风险高低与嫌疑级别及精度均无关,仅做建议透出。高风险: 攻击主要领导人、党政机构及国家机构,讨论敏感事件,或违反《互联网信息服务管理办法》的内容。此类内容易引发重大舆情事件,受到监管处罚;中风险:内容可能会引起用户不适和投诉,可能触犯法规,企业可能被处罚。例如性感、擦边类内容;低风险:内容可能会引起少量用户投诉,影响用户体验。例如一般性广告内容;无风险:正常内容,主要为生态治理类标签,例如黑麦,低质量图片等 ∟ publicOpinionInfo | String | 否 | v5.1 | 专项信息,用于命中特定专项策略时返回 ∟ resultType | Number | 是 | v5.1 | 结果类型,1:机器结果,2:人审结果 ∟ censorType | Number | 是 | v5.1 | 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审 ∟ callback | String | 是 | v5.1 | 产品调用文本异步检测 (https://support.dun.163.com/documents/588434200783982592?docId=589314383258816512)或文本批量异步检测 (https://support.dun.163.com/documents/588434200783982592?docId=589315409428844544)传递的callback字段数据。 ∟ strategyVersions | Object[] | 否 | v5.1 | 策略版本号,策略更新时该参数会更新,可用于追溯策略调优效果。如需开启请联系策略经理 ∟ label | Number | 是 | v5.1 | 分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观 ∟ version | String | 是 | v5.1 | 版本号 ∟ isRelatedHit | Boolean | 是 | v5.1 | 是否命中关联检测,true:关联检测命中,false:原文命中 ∟ relatedHitType | Number | 否 | v5.1 | 关联检测命中类型,开启关联检测后返回。1:关联检测命中且原文命中,2:关联检测命中且原文没命中,3:关联检测没命中且原文命中 ∟ filteredContent | String | 否 | v5.3 | 过滤后文本内容,当命中信息中包含敏感词时,将敏感词内容用*代替后返回,*号数量与敏感词字数相同;若未命中敏感词,则不返回 ∟ mergeHints | String[] | 否 | v5.3 | 文本命中线索内容,若文本多个位置内容存在风险,会将所有线索内容合并在一起返回 ∟customLabels | Object[] | 是 | v5.1 | 客户自定义标签映射标签,默认不返回,如需此功能请联系专属策略经理配置 ∟ name | String | 是 | v5.1 | 名称,一级标签/二级标签/三级标签 ∟ code | String | 是 | v5.1 | 编码 客户自定义标签编码 ∟ depth | Number | 是 | v5.1 | 深度 1-一级标签 2-二级标签 3-三级标签 ∟ labels | Object[] | 是 | v5.1 | 命中的分类信息,检测通过情况labels默认返回为空 ∟ label | Number | 是 | v5.1 | 命中分类,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观 ∟ rate | Number | 是 | v5.2 | 置信度分数,置信度分数仅代表【判为该标签】的可能性,并不代表风险严重程度。0-1之间取值,1为置信度最高,0为置信度最低(v5.2及以上支持) ∟ level | Number | 是 | v5.1 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 ∟ subLabels | Object[] | 否 | v5.1 | 细分类信息,可能包含多个 ∟ subLabel | String | 是 | v5.1 | 末级标签,可能是二级或三级,层级见subLabelDepth,详细编码请参考标签对照表,请定期通过标签接口获取最新的标签信息,避免遗漏新标签风险 ∟ level | Number | 是 | v5.1 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 ∟ subLabelDepth | Number | 是 | v5.3 | 末级标签的标签层级,目前支持的层级:2,3;v5.3及以上开始支持 ∟ secondLabel | String | 是 | v5.3 | 命中二级标签细分类 ∟ thirdLabel | String | 否 | v5.3 | 命中三级标签细分类 ∟ riskdescription | String | 是 | v5.3 | 风险描述,拼接 label|secondlabel|thirdlabel 的中文实时示意,注意分隔使用「|」,将上层对应一级分类带入,若存在二级/三级透出拼装,若无可不显示 ∟ rate | Number | 否 | v5.2 | 置信度分数,置信度分数仅代表【判为该标签】的可能性,并不代表风险严重程度。0-1之间取值,1为置信度最高,0为置信度最低(v5.2及以上支持) ∟ politicalSentiment | Number | 否 | v5.2 | 涉政正负向属性,正向-0、负向-1、中性-2、无结果-3。如有需要请联系您的专属商务,未开通状态下不返回(v5.2及以上开始支持) ∟ explain | String | 否 | v5.3 | 大模型标签解释 ∟ isLlmCheck | Boolean | 否 | v5.3 | 是否来自大模型检测 ∟ details | Object | 否 | v5.1 | 命中的详细信息 ∟ keywords | Object[] | 否 | v5.1 | 命中的敏感词信息 ∟ word | String | 是 | v5.1 | 自定义敏感词内容 ∟ strategyGroupName | String | 否 | v5.2 | 命中的策略组名称 ∟ strategyGroupId | Long | 否 | v5.2 | 命中的策略组id ∟ libInfos | Object[] | 否 | v5.3 | 命中的自定义库信息 ∟ type | Number | 是 | v5.3 | 库类型,1:自定义用户名单库,2:自定义ip名单库 ∟ entity | String | 是 | v5.3 | 自定义用户名单信息,自定义ip名单信息 ∟ releaseTime | Number | 是 | v5.3 | 名单解封时间,时间戳单位毫秒 ∟ anticheat | Object | 否 | v5.1 | 命中的反作弊信息 ∟ type | Number | 是 | v5.1 | 反作弊命中类型,详见hitType返回码及含义表 (https://support.dun.163.com/documents/588434200783982592?docId=490705415386509312) ∟ rules | Object[] | 否 | v5.3 | 命中用户自定义的规则信息 ∟ name | String | 是 | v5.3 | 规则名 ∟ hitInfos | Object[] | 否 | v5.1 | 命中的线索信息 ∟ value | String | 是 | v5.1 | 线索内容 ∟ positions | Object[] | 是 | v5.1 | 线索位置,数据起始位置为0,如果返回线索信息中包含emoij表情,一般emoij表情占2位 ∟ fieldName | String | 是 | v5.1 | 位置类型,content:正文,title:标题 ∟ startPos | Number | 是 | v5.1 | 线索开始坐标 ∟ endPos | Number | 是 | v5.1 | 线索结束坐标 ∟ llm | Object | 否 | v5.1 | 大模型命中关键词信息 ∟ keyword | String | 是 | v5.1 | 大模型命中关键词 ∟ extension | String | 否 | v5.1 | 自定义扩展字段,json 格式,可用于除机审标签外客户还需要大模型做其他维度打标识别的场景 ∟ emotionAnalysis | Object | 否 | v5.1 | 文本情感分析检测结果,如有需要请联系您的专属商务,未开通状态下不返回 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 否 | v5.1 | 命中的详细信息 ∟ positiveProb | Number | 是 | v5.1 | 正向情绪倾向,取值0-1,分数越高,正向情绪越高 ∟ negativeProb | Number | 是 | v5.1 | 负向情绪倾向,取值0-1,分数越高,负向情绪越高 ∟ sentiment | String | 是 | v5.1 | 情感类型,negative(负向情绪),neutral(中性情绪),positive(正向情绪),unknown(未知) ∟ anticheat | Object | 否 | v5.1 | 文本反作弊检测结果,如有需要请联系您的专属商务,未开通状态下不返回 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 否 | v5.1 | 命中的详细信息 ∟ suggestion | Number | 是 | v5.1 | 检测结果,0:通过,10:嫌疑,20:不通过 ∟ hitInfos | Object[] | 是 | v5.1 | 命中信息 ∟ hitType | Number | 是 | v5.1 | 反作弊命中类型,详见hitType返回码及含义表 (https://support.dun.163.com/documents/588434200783982592?docId=490705415386509312) ∟ hitMsg | String | 是 | v5.1 | 反作弊命中详情,可定制返回值 ∟ userRisk | Object | 否 | v5.1 | 文本用户画像检测结果,如有需要请联系您的专属商务,未开通状态下不返回 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 否 | v5.1 | 命中的详细信息 ∟ account | String | 否 | v5.1 | 账号信息 ∟ accountLevel | Number | 否 | v5.1 | 账号等级,0:低风险,1:中风险,2:高风险 ∟ acDetails | Object[] | 否 | v5.1 | 风险详情,如果同时命中多个类型,则会返回所有风险信息 ∟ riskType | String | 是 | v5.1 | yin_liu_hei_chan(引流黑产),qi_zha_xian_yi(欺诈嫌疑),she_jiao_la_ren(社交拉人) ∟ riskLevel | Number | 是 | v5.1 | 账号等级,0:低风险,1:中风险,2:高风险 ∟ riskScore | String | 是 | v5.1 | 风险分值 0-1 ∟ language | Object | 否 | v5.1 | 文本语种检测结果,如有需要请联系您的专属商务,未开通状态下不返回 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 否 | v5.1 | 命中的详细信息 ∟ type | String | 是 | v5.1 | 语种代码详见,语种代码表 (https://support.dun.163.com/documents/588434200783982592?docId=891095487301275648) ∟ riskControl | Object | 否 | v5.5 | 智能风控检测结果,如有需要请联系您的专属商务,未开通状态下不返回(v5.5及以上版本支持) ∟ taskId | String | 是 | v5.5 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.5 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 否 | v5.5 | 智能风控命中详情 ∟ riskLevel | Number | 是 | v5.5 | 风险等级:0 正常,1 低风险,2 中风险,3 高风险,4 可信源。 风险等级只会返回一个,取本次命中的最高风险等级 ∟ hitInfos | Object[] | 否 | v5.5 | 备注 ∟ type | String | 是 | v5.5 | 命中的风险标签编号 ∟ name | String | 是 | v5.5 | 命中的风险标签对应的名称,命中的标签的上下级名称采用‘-’进行拼接 ∟ aigcPrompt | Object | 否 | v5.1 | aigc提示分析结果,如有需要请联系您的专属商务,未开通状态下不返回 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ proxyAnswerType | Number | 是 | v5.1 | 0-没有代答结果,1-有代答结果,从details结构中解析代答结果,2-需要请求流式代答接口获取代答结果,详见 文档 (https://support.dun.163.com/documents/588434200783982592?docId=1220865426122788864) ∟ details | Object[] | 是 | v5.1 | aigc提示分析详情 ∟ type | Number | 是 | v5.1 | prompt分类的枚举值,1, "需拦截" 2, "需正向引导" 3, "准确回答" 4, "需拦截/正向引导" ∟ answer | String | 否 | v5.1 | 回答 ∟ source | Number | 否 | v5.1 | 标记对外输出内容由知识库结果还是大模型生成的结果(0代表知识库,1代表大模型,2代表自定义代答知识库) ∟ libId | String | 否 | v5.1 | 代答知识库的唯一标识,能够根据该值定位到该条知识库信息,如果对数据结果有异议,可以发送改值给策略经理查询 ∟ answerId | String | 否 | v5.1 | 代答知识库内每个答案的唯一标识,能够根据该值定位到该条答案信息,如果对数据结果有异议,可以发送改值给策略经理查询 ∟ underage | Object | 否 | v5.1 | 未成年文本检测结果, 如有需要请联系您的专属商务,未开通状态下不返回 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 是 | v5.1 | 未成年文本检测结果详情 ∟ type | Number | 是 | v5.1 | 1,“涉未成年文本” 2,“不涉未成年文本” ∟ similarText | Object | 否 | v5.1 | 相似文本检索结果,如有需要请联系您的专属商务,未开通状态下不返回 ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 是 | v5.1 | 相似文本检索结果详情 ∟ matchDataId | String | 是 | v5.1 | 命中基准相似库文本的dataId ∟ rate | Number | 是 | v5.1 | 命中相似度值,0-1取值,1为完全相同 ∟ llmCheckInfo | Object | 否 | v5.1 | 文本大模型检测命中信息(同步检测不支持,只支持异步检测返回 ) ∟ taskId | String | 是 | v5.1 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 ∟ dataId | String | 是 | v5.1 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 ∟ details | Object[] | 否 | v5.1 | 文本大模型检测命中的详细信息 ∟ modelIdentifier | String | 否 | v5.1 | 命中的大模型标识 ∟ explain | String | 否 | v5.1 | 命中大模型的识别解释 ∟ label | String | 否 | v5.1 | 大模型识别标签(同步检测不支持,只支持异步检测返回 ) ∟ keyword | String | 否 | v5.1 | 大模型命中关键词 ∟ extension | String | 否 | v5.1 | 自定义扩展字段(JSON字符串) ∟ llmFailureReason | Number | 否 | v5.1 | 大模型检测失败原因,当llmStatus为2(失败)时返回:14005 请求参数错误,14012 请求受限/并发繁忙,15003 大模型响应超时 ∟ llmStatus | Number | 否 | v5.1 | 大模型检测状态:1:成功,2:失败 ### 异步检测响应体示例 Code (json): { "code": 200, "msg": "ok", "result": [ { "antispam": { "taskId": "fx6sxdcd89fvbvg4967b4787d78a", "dataId": "dataId", "suggestion": 1, "suggestionLevel":2, "resultType": 1, "censorType": 0, "callback": "callback", "strategyVersions": [ { "label": 100, "version": "v1.0" } ], "isRelatedHit": false, "labels": [ { "label": 100, "rate":1, "level": 1, "subLabels": [ { "subLabel": "100001", "details": { "keywords": [ { "word": "xxx" } ], "libInfos": [ { "type": 1, "entity": "xxx" } ], "anticheat": { "hitType": 5 }, "hitInfos": [ { "value": "xxx", "positions": [ { "fieldName": "title", "startPos": 0, "endPos": 1 } ] } ] } } ] } ], "llmFailureReason": 15003, "llmStatus": 2 }, "emotionAnalysis": { "taskId": "fx6sxdcd89fvbvg4967b4787d78a", "dataId": "dataId", "details": [ { "positiveProb": 0.5, "negativeProb": 0, "sentiment": "positive" } ] }, "anticheat": { "taskId": "fx6sxdcd89fvbvg4967b4787d78a", "dataId": "dataId", "details": [ { "suggestion": 20, "hitInfos": [ { "hitType": 5, "hitMsg": "无SDK数据" } ] } ] }, "userRisk":{ "taskId":"hfy5g22yezojhvd8t8kb66qg00309r8q", "dataId":"dataIdvalue", "details":[ { "account":"account", "accountLevel":1, "acDetails":[ { "riskType":"yin_liu_hei_chan", "riskLevel":2, "riskScore":0.4 } ] } ] }, "language": { "taskId": "fx6sxdcd89fvbvg4967b4787d78a", "dataId": "dataId", "details": [ { "type": "zh" } ] } } ] } ## 示例代码 ### 服务端 SDK 接入 推荐使用我们提供的服务端 SDK 进行接入(目前支持 Java 和 Go 两种语言),不但可以节省接入成本,实现更快速的集成,并享有灵活的请求配置选项,同时 SDK 内置了错误重试、熔断降级等功能,提升服务可用性。点击 服务端 SDK 接入指引 (https://support.dun.163.com/documents/594247746924453888?docId=682781209345695744) 了解更多。 #### Github Demo 地址 - Java SDK Demo (https://github.com/yidun/yidun-java-sdk/blob/main/yidun-java-sdk-demo/src/main/java/com/netease/yidun/sdk/antispam/text/v5/TextCallbackDemo.java) - Golang SDK Demo (https://github.com/yidun/yidun-golang-sdk/blob/main/yidun/demo/antispam/text/v5/callback/text_callback_demo.go) #### Gitee Demo 地址(Github 无法访问时选择) - Java SDK Demo (https://gitee.com/netease_yidun/yidun-java-sdk/blob/main/yidun-java-sdk-demo/src/main/java/com/netease/yidun/sdk/antispam/text/v5/TextCallbackDemo.java) - Golang SDK Demo (https://gitee.com/netease_yidun/yidun-golang-sdk/blob/main/yidun/demo/antispam/text/v5/callback/text_callback_demo.go) ### HTTP API 接入 #### Github Demo 地址 - PHP Demo (https://github.com/yidun/antispam-php-demo/blob/master/text/v5/callback_v5.php) - Python Demo (https://github.com/yidun/antispam-python-demo/blob/master/text/text_callback.py) - Golang Demo (https://github.com/yidun/antispam-go-demo/blob/master/text/callback/text_callback.go) - Node.js Demo (https://github.com/yidun/antispam-nodejs-demo/blob/master/textCallbackDemo.js) - C# Demo (https://github.com/yidun/antispam-csharp-demo/blob/master/TextCallbackDemoV5.cs) - Java Demo (https://github.com/yidun/antispam-java-demo/blob/master/src/main/java/com/netease/is/antispam/demo/text/v5/TextCallbackAPIDemoV5.java) #### Gitee Demo 地址(Github 无法访问时选择) - PHP Demo (https://gitee.com/netease_yidun/antispam-php-demo/blob/master/text/v5/callback_v5.php) - Python Demo (https://gitee.com/netease_yidun/antispam-python-demo/blob/master/text/text_callback.py) - Golang Demo (https://gitee.com/netease_yidun/antispam-go-demo/blob/master/text/callback/text_callback.go) - Node.js Demo (https://gitee.com/netease_yidun/antispam-nodejs-demo/blob/master/textCallbackDemo.js) - C# Demo (https://gitee.com/netease_yidun/antispam-csharp-demo/blob/master/TextCallbackDemoV5.cs) - Java Demo (https://gitee.com/netease_yidun/antispam-java-demo/blob/master/src/main/java/com/netease/is/antispam/demo/text/v5/TextCallbackAPIDemoV5.java)