接口常见问题

2022.05.18 09:55:55
    • 什么是在线检测接口?

    实时返回机器审核结果的接口。

    • 什么是离线结果获取接口?

    在线检测结果中不确定的数据,会进行离线分析和人工审核,这些数据的结果需要客户通过离线结果获取接口进行定时获取

    • 易盾为什么要设计在线检测和离线结果获取两种接口?

    在线接口实时返回检测结果,帮助客户尽早拦截有害数据。为了进一步提高最终结果的准确性,易盾配备了专业编审团队,会对在线检测结果中不确定数据进行7*24小时审核。同时,在线检测每日会根据离线结果进行升级,提升在线检测效果。

    • 通过易盾接口获取到的结果,客户怎么处理?

    易盾会对垃圾数据做出标记,客户可根据标记处理。例如文本在线检测返回不通过的,可以直接删除,返回疑似的,先设置为用户本人可见,等离线结果获取后再决定删除还是公开。

    • 在线检测接口和离线结果获取接口可否只调用其中一个?

    可以只调在线检测接口,不可只调离线结果获取接口。产品对内容质量要求高的,建议两个都调用。

    • 接口参数里的非必选字段有什么用?

    非必选字段可以提升反垃圾效果,建议尽量提供。例如提供IP数据后,易盾就可对IP进行分析检测。

    • 易盾在线检测接口支持最大QPS是多少?

    每个产品下文本默认200条/s,图片64张/s,视频直播100路/s,视频点播30路/s,直播电视墙100路/s,直播音频100路/s,点播音频30路/s,如有更大需求,请联系您的专属商务。

    • 易盾用户中心文本数据查询页面中的等待回调、不需要回调、已回调三种回调状态分别是什么意思?

    等待回调:数据状态有变更,等待客户调用离线接口获取

    不需要回调:在线返回通过和不通过的数据,数据状态没有变更

    已回调:数据状态有变更,客户已经通过离线接口获取

    • 是否支持IPV6?

    目前已经支持IPV6,ip字段目前不对长度做校验,可以直接传IPV6格式

    • 文本接口请求参数dataid和图片接口请求参数name的作用?

    用户产品可以根据业务情况自行设计,该字段可以作为请求数据的唯一标识,方便定位和查询数据。

    • callback参数的作用?

    数据回调参数,调用方根据业务情况自行设计,作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,该字段在线提交,在离线接口返回时保持原数据返回。具体请参考各个离线接口文档说明。

    • 文本v3.1和v3.0区别,图片v3.2和v3.0区别?

    v3.0历史版本是违禁包含涉政类别,从文本v3.1,图片v3.2之后涉政和违禁分开返回,建议以官网最新的接口版本为准。

    • 图片检测失败的情况包含哪几种?

    610:图片下载失败,图片的连接访问不存在或者无访问权限导致的下载失败。

    620:图片格式错误,图片格式识别不是取决于url中的名称后缀,是图片本身的格式存在异常,或者是图片上传图床不完整导致下载时无法识别图片格式导致。

    630:其他下载失败情况预留,或者是图片预处理失败的情况,请您联系我们。

    • 图片检测大小建议?

    一般建议的图片大小不超过20M,大于50px* 50px;

    如像素过低,图像质量较差对于检测效果会有影响,建议尺寸:1024px* 1024px;

    • 文本检测为什么会出现返回为空的情况?

    当文本返回正常分类时,返回的labels数组为空。具体请您参考文本在线检测接入文档

    "code": 200,
    "msg": "ok",
    "result": {
        "taskId": "079560a6c9f34783bdce47e168510038",
        "action": 0,
        "labels": [
    			]
    }
    
    • 主动回调与离线回调的区别?

    目前主动回调支持:文本,图片,视频,音频4项业务, 主动回调需要在提交参数的时候带有callbackUrl,文本和图片在人工审核之后通过主动回调人工质检结果,视频和音频是异步检测,通过主动回调获取结果

    主动回调获取走结果,是不能再在离线接口进行获取。 如果主动回调没有获取到结果? 您服务端接收到我们推送的结果后,返回的HTTP状态码为200时,表示推送成功,其他的HTTP状态码均视为您接收失败,我们将每隔10分钟推送一次,如果一直失败,持续一天后不再推送;我们主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,客户需保证接收接口性能稳定并且保证幂等性。

    • 如何处理富文本中的图片数据?

    依据客户检测的时效性,如果希望实时获取结果建议客户将文本数据和图片数据拆分,图片调用云安全(易盾)图片检测接口进行检测。 或者可以通过文档解决方案实现,可支持图片和文本一起提交检测,需要在文档离线接口获取检测结果。

    • 离线接口回调是否可以调取多次?

    离线接口数据获取是一次性的,如果回调之后的数据想再次获取可以通过query 接口,taskid值查询,获取查询接口demo地址

    • 视频处理状态码有哪些?

    0:检测成功。

    110:请求重复,视频检测以业务id和url为依据,如果当前业务下有一个正在检测的视频,此时提交相同的url,会判定为重复提交,接口返回110请求重复。

    120:参数错误,请求的url不合法,或者其他请求参数错误,请您核查。

    130:解析错误,视频无法正常解析。

    140:数据类型错误,视频格式异常。

    160:视频大小超限(>5G)

    如有以上问题请您及时联系我们。

    • 音频检测失败的情况,返回asrResult字段各个状态码的含义?

    1:文件格式错误

    2:文件下载失败

    3:解析失败

    4:音频流不存在

    如有以上问题请您及时联系我们

    • 各业务检测耗时参考

    1.文本检测时长

    文本检测时长一般平均为50ms以内;如果较长文本检测时间会相应增加。

    2.图片检测时长

    图片的检测时长需综合考虑图片下载时间,图片下载时间与网络环境和服务器限制有关,扣除图片下载时间,对于图片的检测速度平均为100ms以内。

    3.点播视频检测时长

    点播视频的检测时长需综合考虑视频下载时间,截帧时间与网络环境和服务器限制有关,视频检测速度与视频时长成正比,扣除视频下载和截帧时间,一般60s以内视频平均可在2s内检测完毕,10分钟以内视频平均可在5s内检测完毕,1小时以内视频平均可在10s内检测完毕。

    4.点播音频检测时长

    点播音频的检测时长需综合考虑音频下载时间,语音识别翻译时间与网络环境和服务器限制。一般60s的音频平均检测时长为10s。

    5.直播类业务检测时长

    直播类业务随直播流一起检测,机器检测到不通过、嫌疑结果时返回。直播流结束,检测即停止。

    在线咨询 电话咨询:95163223 免费试用