内容安全文本异步检测或人工审核的结果，客户可以通过轮询调用该接口获取数据，轮询模式与推送模式互斥，只能选取一种模式进行结果获取
## 接口说明
该接口返回文本经过人工审核的结果或者文本异步机器检测结果，需要客户通过该接口进行定时轮询获取，当提交检测接口参数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)|
### 请求体示例
```
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|是|细分类，详细编码请参考下方对应细分类编码对照表|
### 人工审核响应体示例
```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：失败|
### 异步检测响应体示例
```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)