检测提交接口
2024.11.20 14:05:39
融媒体解决方案适用于多种类型媒体（文本、图片、点播音频、点播音视频、文档）合并过检场景，提交接口用于检测数据的提交。
接口说明
该接口为融媒体检测数据提交接口，建议使用HTTP协议进行接口调用。根据不同的检测数据类型，结果返回方式支持配置同步检测或异步检测：
- 同步检测：支持文本和图片两种类型。配置同步检测会实时返回检测结果。
- 异步检测：支持所有类型（文本、图片、音频、音视频和文档），其中音频、音视频和文档因为检测耗时相对较长，只支持异步检测。
默认都是异步检测方式，如果需要设置同步检测，请联系易盾策略经理进行配置。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权
检测数据要求
请求体限制：所有请求参数大小总和不能超过10M
文本要求
文本限制：单次请求<5000字符，字段长度超过5000字符，会提示参数错误
图片要求
- 图片支持类型：URL
- 图片支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、ICO、HEIC、SVG
- 图片大小（适用于同步和异步检测）: 单张<10M，像素建议不低于50px*50px，像素过低会影响识别效果
- 图片下载：下载时间限制为5秒内，如果下载时间超过5秒，接口检测失败
- 截帧说明：易盾自动将GIF图，长图（长宽比大于5的图片）截帧过检，最多5张，GIF图，长图均按照实际截图张数进行计费
点播音频要求
- 点播音频支持类型：URL
- 点播音频支持格式：wav、mp3、aac、amr、3gp、m4a、wma、ogg、ape、flac、alac、wavpack、silk_v3等
- 点播音频大小：音频文件大小不超过550M
- 点播音频时长：时长小于5小时
点播音视频要求
- 点播音视频支持类型：URL
- 点播音视频支持格式：flv、mkv 、mp4 、rmvb 、avi 、wmv、3gp、ts、mov、rm、mpeg、wmf等
- 点播音视频时长：时长小于5小时
文档要求
- 文档支持类型：URL
- 文档支持格式：
txt、doc、docx、ppt、pptx、xls、xlsx、xlsm、pdf、rar、zip、csv、rtf、odt、lrc、pot、potx、 pps、 ppsx、 pptm、 potm、 ppsm、 dot、 dotx、docm、dotm、xltm、xltx、xlt、et、ett、wps、wpt、dps、dpt、dwg、pst、vsd、vsdx、vsdm、xml、epub、ofd - 文档大小：单文档<150M
检测耗时
融媒体检测接口根据设置的同步或异步检测方式不同，接口耗时也不同，具体超时时间设置建议如下：
异步检测： 此时接口只是接收提交的检测任务，检测流程异步进行，整体耗时较短，建议设置为200ms
同步检测： 此时接口会执行同步检测流程，并同步返回检测结果
-
文本同步检测，响应时间依赖文本的长度，根据不同长度建议适当调整接口超时时间，200字以内建议200ms，200字以上建议1s
-
图片同步检测，响应时间依赖图片的下载时间，请保证被检测图片所在的存储服务稳定可靠，建议适当调整接口超时时间，建议为10s
历史版本
请求
| 名称 | 值 |
|---|---|
| HTTP URL | https://as.dun.163.com/v2/mediasolution/submit |
| HTTP Method | POST |
请求头
| 名称 | 类型 | 描述 |
|---|---|---|
| Content-Type | String | 固定值："application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成。
公共参数
公共参数包含密钥信息和参数签名信息，公共参数详细见请求公共参数
业务参数
| 名称 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| version | String | 是 | 4 | 接口版本号，值为v2.1 |
| ip | String | 否 | 128 | 用户IP地址，建议抄送，辅助机审策略精准调优 |
| account | String | 否 | 128 | 用户唯一标识，与易盾账号画像库匹配，建议抄送，辅助机审策略精准调优 |
| deviceId | String | 否 | 128 | 用户设备id，与易盾设备画像库匹配，明文请转大写传入；MD5加密请明文转大写后MD5计算，再转大写传入，建议抄送 |
| deviceType | Number | 否 | 4 | 用户设备id的类型，0：其他，10：IMEI，11：AndroidID，12：IDFA，13：IDFV，14：MAC，20：IMEI_MD5，21：AndroidID_MD5，22：IDFA_MD5，23：IDFV_MD5，24：MAC_MD5，可选值-10000~10000 |
| censorExt | String | 否 | 1024 | 人审标签扩展字段，可传入任意标签内容，用于在人审模板(审核模板配置请参考人工审核模板高级配置)时指定数据并配置特殊审核逻辑。一次传入支持多个标签，标签间使用英文逗号","隔开，不支持大写英文字母，请全部使用小写 |
| publishTime | Number | 否 | 13 | 发表时间，UNIX 时间戳（毫秒值）） |
| dataId | String | 否 | 128 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| title | String | 否 | 512 | 融媒体标题 |
| content | Object[] | 否 | 150000 | content为json数组格式，提交时转换为string类型 |
| ∟ type | String | 是 | 10 | 类型，分别为text：文本，image：图片，audio：点播语音，audiovideo：音视频，file：文档 |
| ∟ data | String | 是 | 5000 | 检测数据，类型为text时最多传入20条文本内容，每条最长5000字符；类型为image时最多传入50张图url，每张最长512字符；类型为audio时最多传入5条语音url，每条最长512字符；类型为audiovideo时最多传入5条音视频url，每条最长512字符；类型为file时最多传入10个文url，每个最长512字符 |
| ∟ dataId | String | 否 | 128 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ remark | String | 否 | 200 | 自定义备注信息 |
| ∟ config | Obejct | 否 | 128 | 检测数据配置 |
| ∟ scFrequency | Number | 否 | 4 | 截图检测频率，默认5秒截图检测一次，可设置范围为0.5～60秒 |
| ∟ subType | Number | 否 | 4 | 支持file内容提交，按照富文本样式展示，0：默认url提交，1：file按照内容提交，以富文本样式展示 |
| ∟ checkMode | Number | 否 | 4 | 指定检测模式，1：同步，2：异步；仅支持文本和图片数据，不传则以业务配置为准 |
| ∟ advancedFrequency | String | 否 | 128 | 高级截帧设置，此项填写，默认截帧策略失效，如{"durationPoints":[300,600],"frequencies":[1,5,10]} |
| ∟ durationPoints | Object[] | 是 | 5 | 视频时长区间分割，单位为秒，数组最多5个 |
| ∟ frequencies | Object[] | 是 | 6 | 视频时长区间对应的截帧频率，可设置范围为0.5～600秒，数组最多6个 |
| 自定义解析字段 | Object[] | 否 | 150000 | 格式同content字段。业务方自定义的解析检测或者解析不检测字段，支持同时设置多个自定义字段。确定字段名称、检测配置要求后，请联系易盾策略经理进行配置。注意：只要字段内容需要解析并展示在审核区域，就需要按此字段格式接入。 |
| 自定义不解析字段 | String | 否 | 1024 | 业务自定义非解析检测字段，非解析检测字段无法切换为检测字段。确认字段名称、非检测配置后，请联系易盾策略经理进行配置。支持同时设置多个自定义不解析字段，字段内容将展示在扩展信息区域，辅助人工审核。 |
| callback | String | 否 | 512 | 数据回调参数，调用方根据业务情况自行设计，当调用融媒体异步检测获取结果时，该接口会原样返回该字段。作为数据处理标识，因此该字段应该设计为能唯一定位到该次请求的数据结构，如对用户的昵称进行检测，dataId可设为用户标识（用户ID），用户修改多次，每次请求数据的dataId可能一致，但是callback参数可以设计成定位该次请求的数据结构，比如callback字段设计成json，包含dataId和请求的时间戳等信息，当然如果不想做区分，也可以直接把callback设置成dataId的值。 |
| callbackUrl | String | 否 | 1024 | 异步检测结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。 |
| token | String | 否 | 256 | 内容安全与反作弊融合版专属字段，来自易盾反作弊SDK返回的token，接入SDK必传，请联系您的专属策略经理获取相关开发文档 |
| uniqueKey | String | 否 | 64 | 数据归档去重字段，开启归档去重功能的产品将根据此字段进行去重处理，配合dataVersion使用 |
| dataVersion | Number | 否 | 19 | long型，值越大，代表版本越新，配合uniqueKey使用 |
请求体示例
content=[{"type":"image","data":"https://url/image1.jpg","dataId":"01"},{"type":"text","data":"检测文本","dataId":"02"}]&version=v2.1&signature=signature&secretId=your_secret_id×tamp=1646984669446&nonce=12353
响应
响应结果
根据配置的同步检测和异步检测方式不同，响应结果也有一定的区别，响应公共字段已省略，详细见响应公共字段
异步检测
默认都是异步检测
| 名称 | 类型 | 是否返回 | 描述 |
|---|---|---|---|
| result | Object | 是 | 融媒体结果 |
| ∟antispam | Object | 是 | 融媒体检测任务提交结果 |
| ∟ taskId | String | 是 | 本次请求数据标识，可以根据该标识查询数据最新结果 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ callback | String | 否 | 数据回调参数，请求参数中传来的callback字段原样返回 |
同步结果返回
在开启文本和图片同步结果返回的情况下，返回的结构如下：
| 名称 | 类型 | 是否返回 | 描述 |
|---|---|---|---|
| result | Object | 是 | 融媒体结果 |
| ∟antispam | Object | 是 | 融媒体机器检测结果 |
| ∟ taskId | String | 是 | 本次请求数据标识，可以根据该标识查询数据最新结果 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ callback | String | 否 | 数据回调参数，请求参数中传来的callback字段原样返回 |
| ∟ suggestion | Number | 是 | 建议动作，0：通过，1：嫌疑，2：不通过 |
| ∟ resultType | Number | 是 | 结果类型，1：机器结果，2：人审结果 |
| ∟ checkStatus | Number | 是 | 检测状态，1：检测中，2：检测成功，3：检测失败 |
| ∟ evidences | Object | 否 | 机审证据信息， 默认只返回嫌疑和不通过的证据信息，以及检测失败数据的失败原因。由于图片存在下载失败等情况，请通过解析图片的failureReason确认检测失败原因。 |
| ∟ texts | Object[] | 否 | 文本检测结果 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的title或content时，此字段值为title或content，当数据来自提交接口自定义字段时，此字段值为自定义字段名 |
| ∟ suggestion | Number | 是 | 建议动作，0：通过，1：嫌疑，2：不通过 |
| ∟ resultType | Number | 是 | 结果类型，1：机器结果，2：人审结果 |
| ∟ censorType | Number | 是 | 审核模式，0：纯机审，1：机审+部分人审，2：机审+全量人审 |
| ∟ strategyVersions | Object[] | 否 | 策略版本号，策略更新时该参数会更新，可用于追溯策略调优效果 |
| ∟ label | Number | 是 | 示例值：100，分类信息，100：色情，200：广告，260：广告法，300：暴恐，400：违禁，500：涉政，600：谩骂，700：灌水，900：其他，1100：涉价值观 |
| ∟ version | String | 是 | 版本号 |
| ∟ filteredContent | String | 否 | 过滤后文本内容，当命中信息中包含敏感词时，将敏感词内容用*代替后返回，*号数量与敏感词字数相同；若未命中敏感词，则不返回 |
| ∟ isRelatedHit | Boolean | 是 | 是否命中关联检测，true：关联检测命中，false：原文命中 |
| ∟ 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 | 是 | 细分类，详细编码请参考下方对应细分类编码对照表 |
| ∟ subLabelDepth | Number | 是 | 命中的标签层级，目前支持的层级：2,3 |
| ∟ secondLabel | String | 是 | 命中二级标签细分类 |
| ∟ thirdLabel | String | 否 | 命中三级标签细分类 |
| ∟ rate | Number | 是 | 置信度分数，0-1之间取值，1为置信度最高，0为置信度最低 |
| ∟ details | Object | 否 | 命中的详细信息 |
| ∟ keywords | Object[] | 否 | 命中的敏感词信息 |
| ∟ word | String | 是 | 自定义敏感词内容 |
| ∟ libInfos | Object[] | 否 | 命中的自定义库信息 |
| ∟ type | Number | 是 | 库类型，1：自定义用户名单库，2：自定义ip名单库 |
| ∟ entity | String | 是 | 自定义用户名单信息，自定义ip名单信息 |
| ∟ releaseTime | String | 是 | 名单解封时间，时间戳单位毫秒 |
| ∟ hitInfos | Object[] | 否 | 命中的线索信息 |
| ∟ value | String | 是 | 线索内容 |
| ∟ positions | Object[] | 是 | 线索位置，数据起始位置为0，如果返回线索信息中包含emoij表情，一般emoij表情占2位 |
| ∟ fieldName | String | 是 | 位置类型，content：正文，title：标题 |
| ∟ startPos | Number | 是 | 线索开始坐标 |
| ∟ endPos | Number | 是 | 线索结束坐标 |
| ∟ images | Object[] | 否 | 图片检测结果 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的title或content时，此字段值为title或content，当数据来自提交接口自定义字段时，此字段值为自定义字段名 |
| ∟ name | String | 是 | 图片名称（或图片标识） |
| ∟ status | Number | 是 | 检测状态：2 检测成功，3 检测失败 |
| ∟ failureReason | Number | 否 | 检测失败原因，当status为3（检测失败）时返回：610 图片下载失败、620 图片格式错误、630 其他 |
| ∟ suggestion | Number | 是 | 建议动作，0：通过，1：嫌疑，2：不通过 |
| ∟ resultType | Number | 是 | 结果类型，1：机器结果，2：人审结果 |
| ∟ frameSize | Number | 是 | 长图、gif图片拆帧后的分帧数，默认为1 |
| ∟ censorType | Number | 是 | 审核模式，0：纯机审，1：机审+部分人审，2：机审+全量人审 |
| ∟ labels | Object[] | 是 | 命中的分类信息 |
| ∟ label | Number | 是 | 分类信息，100：色情，110：性感低俗，200：广告，210：二维码，260：广告法，300：暴恐，400：违禁，500：涉政，800：恶心类，900：其他，1100：涉价值观 |
| ∟ level | Number | 是 | 命中级别，示例值：1：嫌疑，2：不通过，0：正常，特殊策略下可返回“level=0”的数据，如果需要返回可以找策略经理配置 |
| ∟ rate | Number | 是 | 置信度分数，0-1之间取值，1为置信度最高，0为置信度最低。若level为正常，置信度越大，说明正常的可能性越高。若level为不通过或嫌疑，置信度越大，说明垃圾的可能性越高 |
| ∟ subLabels | Object[] | 是 | 细分类信息，可能包含多个 |
| ∟ subLabel | String | 是 | 细分类，详细编码请参考下方对应细分类编码对照表 |
| ∟ subLabelDepth | Number | 是 | 命中的标签层级，目前支持的层级：2,3 |
| ∟ secondLabel | String | 是 | 命中二级标签细分类 |
| ∟ thirdLabel | String | 否 | 命中三级标签细分类 |
| ∟ rate | Number | 是 | 置信度分数，0-1之间取值，1为置信度最高，0为置信度最低 |
| ∟ rate | Number | 是 | 置信度分数，0-1之间取值，1为置信度最高，0为置信度最低 |
| ∟ details | Object | 否 | 命中的详细对象信息 |
| ∟ keywords | Object[] | 否 | 命中的自定义敏感词信息 |
| ∟ word | string | 是 | 敏感词内容 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟ libInfos | Object[] | 是 | 命中的自定义图片名单信息 |
| ∟ type | Number | 是 | 1：自定义用户名单，2：自定义ip名单，3：自定义设备名单，4：自定义图片名单，目前只支持返回4自定义图片名单 |
| ∟ entity | String | 是 | 该图片命中自定义图片名单对应原始添加的根源图片url |
| ∟ releaseTime | Number | 是 | 名单解封时间，时间戳单位毫秒 |
| ∟ hitCount | String | 是 | 历史针对该数据源图片命中所有次数 |
| ∟ value | String | 否 | 图片中包含的可识别内容 |
| ∟ group | String | 否 | value对应的分组名称，用于对value的解释 |
| ∟ hitInfos | Object[] | 是 | 命中的线索信息 |
| ∟ value | String | 是 | 图片中包含的可识别内容 |
| ∟ group | String | 否 | value对应的分组名称，用于对value的解释 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟valueAddService | Object | 是 | 增值服务信息，如有检测需求请联系易盾策略经理开启服务 |
| ∟ emotionAnalysis | Object | 否 | 情感分析检测结果 |
| ∟ texts | Object[] | 否 | 文本情感分析检测结果 |
| ∟ taskId | String | 是 | 检测任务ID，示例值："fx6sxdcd89fvbvg4967b4787d78a" |
| ∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的title或content时，此字段值为title或content，当数据来自提交接口扩展字段时，此字段值为扩展字段名 |
| ∟ dataId | String | 是 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ positiveProb | Number | 是 | 正向情绪倾向，取值0-1，分数越高，正向情绪越高 |
| ∟ negativeProb | Number | 是 | 负向情绪倾向，取值0-1，分数越高，负向情绪越高 |
| ∟ sentiment | String | 是 | 情感类型，negative（负向情绪），neutral（中性情绪），positive（正向情绪），unknown（未知） |
| ∟ language | Object | 否 | 语种检测结果 |
| ∟ texts | Object[] | 否 | 文本语种检测结果 |
| ∟ taskId | String | 是 | 检测任务ID，示例值："fx6sxdcd89fvbvg4967b4787d78a" |
| ∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的title或content时，此字段值为title或content，当数据来自提交接口扩展字段时，此字段值为扩展字段名 |
| ∟ dataId | String | 是 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ type | String | 是 | 语种代码详见，语种代码表 |
| ∟ ocr | Object | 否 | OCR结果信息 |
| ∟ images | Object[] | 否 | 图片OCR结果信息 |
| ∟ taskId | String | 是 | 检测任务ID |
| ∟ field | String | 是 | 数据来源字段名 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ height | Number | 是 | 图片高度，单位像素 |
| ∟ width | Number | 是 | 图片宽度，单位像素 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ content | String | 是 | 该图片中所有的文字信息集合 |
| ∟ lineContents | Object[] | 是 | OCR行信息 |
| ∟ lineContent | String | 是 | 每行的文字信息 |
| ∟ lang | String | 否 | 语种信息 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟ face | Object | 否 | 人脸检测信息，人脸检测结果需额外付费开启，如有需要请联系您的专属商务，未开通状态下此数组返回为空 |
| ∟ images | Object[] | 否 | 图片人脸检测信息 |
| ∟ taskId | String | 是 | 检测任务ID，示例值："fx6sxdcd89fvbvg4967b4787d78a" |
| ∟ field | String | 是 | 数据来源字段名 |
| ∟ name | String | 否 | 图片名称（或图片标识） |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ faceNumber | Number | 是 | 该图片中包含的人脸个数 |
| ∟ faceContents | Object[] | 是 | 人脸详细信息 |
| ∟ name | String | 是 | 图片中出现的人脸名字，未识别则为空。该字段可识别明星、政治人物等人脸信息，用于落马官员/劣迹艺人检测，或明星头像/政治头像检测 |
| ∟ glasses | String | 是 | 人脸戴眼镜，normal（无眼镜）、 glasses（普通眼镜）、 sunglasses（墨镜），如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ gender | String | 否 | 人脸性别，值为男（male）、女（female）；不可识别则为空 |
| ∟ age | Integer | 否 | 人脸年龄，值为具体年龄（age）；不可识别则为空 |
| ∟ type | String | 否 | 人脸类型，包含卡通脸（cartoon）、普通（normal），如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ category | String | 否 | 人物分类，包含名人（star）、普通（normal）、海外娱乐明星（overseaEntertainmentStar）、海外体育明星（overseaSportStar）、海外政客（overseaPolitician）、海外网红（overseaInternetStar） |
| ∟ beautyScore | Number | 否 | 人脸颜值分数，0-1，保留4位小数，如有检测需求请联系易盾策略经理开启服务，如有需要请联系您的专属商务，未开通状态下不返回该字段 |
| ∟ sizeRatio | String | 否 | 人脸占比，百分比形式 |
| ∟ x1 | Number | 否 | 位置信息，对应目标矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | 位置信息，对应目标矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | 位置信息，对应目标矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | 位置信息，对应目标矩形右下角纵坐标相对坐标 |
| ∟ quality | Object | 否 | 图片质量检测结果，图片质量检测结果需额外付费开启，如有需要请联系您的专属商务，未开通状态下此数组返回为空 |
| ∟ images | Object[] | 否 | 图片质量检测结果 |
| ∟ taskId | String | 是 | 检测任务ID，示例值："fx6sxdcd89fvbvg4967b4787d78a" |
| ∟ field | String | 是 | 数据来源字段名 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ aestheticsRate | Number | 否 | 美观度分数，0-1，分数越高美观度越高，建议0.5分以上可认为美观度较好，0.3分以下可认为美观度较差，具体视业务场景而定 |
| ∟ sharpnessRate | Number | 否 | 清晰度分数，0-1，分数越高清晰度越高，建议0.5分以上可认为清晰度较好，0.3分以下可认为清晰度较差，具体视业务场景而定 |
| ∟ metaInfo | Object | 否 | 图片基本信息 |
| ∟ byteSize | Number | 否 | 图片大小，单位byte |
| ∟ format | String | 否 | 图片格式 |
| ∟ height | Number | 否 | 图片高度，单位像素 |
| ∟ width | Number | 否 | 图片宽度，单位像素 |
| ∟ boarderInfo | Object | 否 | 图片背景信息 |
| ∟ hit | Boolean | 否 | 图片是否包含边框（任一边包含边框均视为包含）ture：包含边框；false：不包含边框 |
| ∟ top | Boolean | 否 | 图片顶部是否包含边框，ture：包含边框；false：不包含边框 |
| ∟ right | Boolean | 否 | 图片右侧是否包含边框，ture：包含边框；false：不包含边框 |
| ∟ bottom | Boolean | 否 | 图片底部是否包含边框，ture：包含边框；false：不包含边框 |
| ∟ left | Boolean | 否 | 图片左侧是否包含边框，ture：包含边框；false：不包含边框 |
| ∟ backgroundInfo | Object | 否 | 图片背景信息 |
| ∟ pureBackground | boolean | 否 | 纯色背景检测，ture：背景纯色；false：背景复杂 |
| ∟ logo | Object | 否 | logo检测结果，logo检测支持对图片中包含的通识logo进行识别，检测结果返回需额外付费开启，如有需要请联系您的专属商务，未开通状态下此数组返回为空 |
| ∟ images | Object[] | 否 | 图片logo检测结果 |
| ∟ taskId | String | 是 | 检测任务ID |
| ∟ field | String | 是 | 数据来源字段名 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ logoName | String | 是 | logo名字，不可识别则为空 |
| ∟ x1 | Number | 否 | logo位置信息，对应logo矩形左上角横坐标相对坐标 |
| ∟ y1 | Number | 否 | logo位置信息，对应logo矩形左上角纵坐标相对坐标 |
| ∟ x2 | Number | 否 | logo位置信息，对应logo矩形右下角横坐标相对坐标 |
| ∟ y2 | Number | 否 | logo位置信息，对应logo矩形右下角纵坐标相对坐标 |
| ∟ discern | Object | 否 | 图片识别结果，识别检测支持对图片中物体进行识别，识别结果返回需额外付费开启，如有需要请联系您的专属商务，未开通状态下此数组返回为空 |
| ∟ images | Object[] | 否 | 图片识别结果 |
| ∟ taskId | String | 是 | 检测任务ID |
| ∟ field | String | 是 | 数据来源字段名 |
| ∟ dataId | String | 否 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| ∟ details | Object[] | 否 | 命中的详细信息 |
| ∟ discernName | String | 是 | 识别物体名称 |
| ∟ rate | Number | 是 | 识别分数，0-1之间取值，1为置信度最高，0为置信度最低。 |
| ∟ type | Number | 是 | 图片识别类型，1 场景识别，2 地标识别，3 通用识别，4：乐谱识别，5：动漫识别，6：服饰识别，7：地图截图识别，8：聊天截屏识别，9：手机识别，10：举白纸识别，11：哺乳照识别，12：可爱卡通骷髅识别 |
| ∟anticheat | Object | 是 | 反作弊检测结果，如有检测需求请联系易盾策略经理开启服务 |
| ∟ taskId | String | 是 | 检测任务ID |
| ∟ suggestion | Number | 是 | 建议动作，0：通过，1：嫌疑，2：不通过 |
| ∟ hitInfo | Number | 是 | 命中信息 |
| ∟ hitType | Number | 是 | 反作弊命中类型，详见hitType返回码及含义表 |
响应示例
异步结果返回示例
{
"code": 200,
"msg": "ok",
"result": {
"antispam": {
"dataId": "131246",
"callback": "i am callback",
"taskId": "jk5wux0l0u6zjmotwc088svg05009pgr"
}
}
}
同步结果返回示例
文本和图片开启同步结果返回
{
"code":200,
"msg":"ok",
"result":{
"antispam":{
"checkStatus":2,
"dataId":"131246",
"suggestion":2,
"callback":"i am callback",
"evidences":{
"images":[
{
"dataId":"792707",
"field":"image1",
"suggestion":2,
"censorType":0,
"name":"81uoe1igu601b2v2wfoik3fg05009pgr",
"resultType":1,
"labels":[
{
"subLabels":[
{
"subLabel":"50003",
"rate":1,
"details":{
"hitInfos":[
{
"y1":0.1756,
"y2":0.7165,
"x1":0.1711,
"x2":0.8457,
"value":"李四"
}
]
}
}
],
"level":2,
"rate":1,
"label":500
},
{
"level":0,
"rate":1,
"label":300
}
],
"status":2
}
],
"texts":[
{
"dataId":"192470",
"field":"image1",
"suggestion":2,
"censorType":0,
"isRelatedHit":false,
"resultType":1,
"labels":[
{
"subLabels":[
{
"subLabel":"100080",
"details":{
"hitInfos":[
{
"positions":[
{
"fieldName":"content",
"startPos":0,
"endPos":2
}
],
"value":"测试"
},
{
"positions":[
{
"fieldName":"content",
"startPos":23,
"endPos":24
}
],
"value":"江"
}
],
"keywords":[
{
"word":"测试"
}
]
}
},
{
"subLabel":"100002"
}
],
"level":2,
"label":100
},
{
"subLabels":[
{
"subLabel":"500001",
"details":{
"hitInfos":[
{
"positions":[
{
"fieldName":"content",
"startPos":15,
"endPos":18
}
],
"value":"测试1"
}
]
}
},
{
"subLabel":"500013",
"details":{
"hitInfos":[
{
"positions":[
{
"fieldName":"content",
"startPos":15,
"endPos":18
}
],
"value":"测试2"
}
]
}
}
],
"level":2,
"label":500
},
{
"level":0,
"label":200
},
{
"level":0,
"label":260
}
]
}
]
},
"resultType":1,
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
},
"valueAddService":{
"emotionAnalysis":{
"texts":[
{
"dataId":"192470",
"field":"image1",
"details":[
{
"sentiment":"positive",
"positiveProb":0.7576994299888611,
"negativeProb":0.24208970367908478
}
],
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
}
]
},
"face":{
"images":[
{
"dataId":"792707",
"field":"image1",
"details":[
{
"faceContents":[
{
"maskType":"normal",
"expression":"happy",
"gender":"male",
"y1":0.1756,
"name":"张三",
"y2":0.7165,
"x1":0.1711,
"x2":0.8457,
"type":"normal",
"category":"normal",
"beautyScore":0.49,
"age":50
}
],
"faceNumber":1
}
],
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
}
]
},
"discern":{
"images":[
{
"dataId":"792707",
"field":"image1",
"details":[
{
"rate":0.9593,
"type":3,
"discernName":"张三"
},
{
"rate":0.755,
"type":3,
"discernName":"人物特写"
},
{
"rate":0.4752,
"type":3,
"discernName":"人脸"
}
],
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
}
]
},
"logo":{
"images":[
{
"dataId":"792707",
"field":"image1",
"details":[
],
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
}
]
},
"language":{
"texts":[
{
"dataId":"192470",
"field":"image1",
"details":[
{
"type":"zh"
}
],
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
}
]
},
"quality":{
"images":[
{
"dataId":"792707",
"field":"image1",
"details":[
{
"metaInfo":{
"byteSize":124343,
"format":"png",
"width":267,
"height":333
},
"sharpnessRate":0.7394,
"aestheticsRate":0.6262,
"boarderInfo":{
"hit":false,
"top":false,
"left":false,
"bottom":false,
"right":false
},
"backgroundInfo":{
"pureBackground":false
}
}
],
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
}
]
},
"ocr":{
"images":[
{
"dataId":"792707",
"field":"image1",
"width":267,
"details":[
],
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr",
"height":333
}
]
}
},
"anticheat":{
"suggestion":2,
"taskId":"81uoe1igu601b2v2wfoik3fg05009pgr",
"hitInfo":{
"hitType":3
}
}
}
}
响应返回码
响应返回码见：响应返回码
示例代码
服务端 SDK 接入
推荐使用我们提供的服务端 SDK 进行接入（目前支持 Java 和 Go 两种语言），不但可以节省接入成本，实现更快速的集成，并享有灵活的请求配置选项，同时 SDK 内置了错误重试、熔断降级等功能，提升服务可用性。点击 服务端 SDK 接入指引 了解更多。
