轮询模式

2024.03.19 16:06:56

    内容安全点播音频异步检测或人工审核的结果,客户可以通过轮询调用该接口获取数据。轮询模式与推送模式互斥,只能选取一种模式进行结果获取。

    接口说明

    该接口返回点播音频经过人工审核的结果或者点播音频异步机器检测结果,需要客户通过该接口进行定时轮询获取,当提交检测接口参数callbackUrl为空时,表示结果通过该接口获取,结果可以根据提交检测时返回的taskId对应。

    鉴权说明

    易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权

    结果说明

    • 获取结果后,下次调用,不会再次返回之前获取过的结果
    • 接口一次最多返回200个结果,审核结果数据默认保留7天,7天不获取会失效
    • 接口请求频率建议1s一次,过快服务器会拒绝处理,客户可以根据业务需求进行适当调整

    接口耗时

    结果获取接口的响应很快,正常50ms内返回结果,业务方根据需求适当调整超时时间,建议为1s

    历史版本

    v3版本点播语音异步检测轮询模式请点此查看

    请求

    请求地址

    名称
    HTTP URL http://as.dun.163.com/v4/audio/callback/results
    HTTP Method POST

    请求头

    名称 类型 必填 描述
    Content-Type String 固定值:"application/x-www-form-urlencoded"

    请求参数

    请求参数由公共参数和业务参数两部分组成

    公共参数

    公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数

    业务参数

    名称 类型 必填 最大长度 描述
    version String 4 接口版本v4.1
    yidunRequestId String 64 幂等参数说明

    请求体示例

    version=v4.1&signature=xxx&secretId=xxx&businessId=xxx&nonce=12345×tamp=1628137551000
    

    响应

    该接口可以返回人工审核结果或异步机器检测结果,两类结果结构保持一致。

    响应结果

    响应字段如下,响应公共字段已省略,详细见响应公共字段,resultType为2时表示人工审核结果,详细字段信息如下:

    名称 类型 必须返回 描述
    result Object[] 点播音频检测结果
      ∟ antispam Object 内容安全检测结果
       ∟ taskId String 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询
       ∟ status Number 检测状态,2-检测成功,3-检测失败
       ∟ label Number 整体分类信息,0:正常,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1100:涉价值观,1050:噪音
       ∟ suggestion Number 建议结果 0-通过 1-嫌疑 2-删除
       ∟ customAction Number 自定义动作,0:通过,2:不通过。customAction字段用于saas审核系统-机审标准集中的自定义调度功能,将易盾机器检测嫌疑结果通过配置映射为业务自己的自定义动作,可参考图片流程:https://nos.netease.com/yidun/bceb8815e1f50c2339899976e9a2ec28.png
       ∟ suggestionLevel Number 嫌疑级别,针对部分定制策略支持命中嫌疑时返回,1:低嫌疑,2:高嫌疑,对通用策略、模型结果暂不支持,v5.2版本新增,默认不返回,如果需要返回请联系运营经理配置
       ∟ resultType Number 结果类型 1-机器结果 2-人审结果
       ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
       ∟ failureReason Number 检测失败原因,当检测失败时返回,1:文件格式错误,2:文件下载失败,3:解析失败,4:音频流不存在
       ∟ callback String 提交时传递的callback
       ∟ censorSource Number 审核来源,0:易盾人审,1:客户人审,2:易盾机审,3:用户质检,4:易盾质检
       ∟ remark String 人审备注信息
       ∟ censorTime Number 审核完成时间,毫秒单位时间戳(13位)
       ∟ duration Number 音频时长字段,单位s
       ∟ durationMs Number 音频时长字段,单位ms
       ∟ customAction Number 客户自定义建议结果 0-通过 2-删除
       ∟ censorLabels Object[] 支持在智能审核系统自定义标签分类信息
        ∟ code String 在智能系统配置自定义便签之后会生成一个唯一的标签ID
        ∟ name String 在智能审核系统配置自定义标签名称
        ∟ desc String 在智能审核系统配置自定义标签备注
        ∟ customCode String 在智能审核系统配置自定义标签ID
       ∟ segments Object[] 音频数据所在断句详细信息
        ∟ startTime Number 断句开始时间点,单位秒
        ∟ endTime Number 断句结束时间点,单位秒
        ∟ startTimeMillis Number 断句开始时间点,单位毫秒
        ∟ endTimeMillis Number 断句结束时间点,单位毫秒
        ∟ type Number 断句类型,0-语音识别,1-声纹检测
        ∟ leaderName String 领导人名,若命中领导人声纹,返回对应的领导人名
        ∟ content String 音频数据所在断句语音识别原文内容,支持返回异常数据所在断句内容
        ∟ url String 风险片段对应语音片段的临时访问地址,地址有效期为7天,如需开启请联系易盾策略经理
        ∟ labels Object[] 分类信息
         ∟ label Number 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1100:涉价值观,1050:噪音
         ∟ level Number 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置
         ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。
         ∟ subLabels Object[] 命中细分类信息
          ∟ subLabel String 细分类,详细编码请参考下方对应细分类编码对应表
          ∟ subLabelDepth Number 命中的标签层级,目前支持的层级:2,3
          ∟ secondLabel String 命中二级标签细分类
          ∟ thirdLabel String 命中三级标签细分类
          ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。
          ∟ details Object 其他信息
           ∟ hitInfos Object[] 证据信息
            ∟ value String 命中的敏感词或者声纹检测的分值
            ∟ songName String 命中的涉政歌曲名称
           ∟ keywords Object[] 自定义敏感词线索分类信息
            ∟ word String 自定义添加敏感词
           ∟ libInfos Object[] 自定义名单线索分类信息
            ∟ listType Number 名单类型,1:自定义用户名单,2:自定义IP名单,3:自定义设备名单
            ∟ entity String 名单内容
          ∟ rules Object[] 命中用户自定义的规则信息
           ∟ name String 规则名
      ∟ language Object 语种检测结果,如有需要请联系您的专属商务,未开通状态下不返回
       ∟ taskId String 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询
       ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
       ∟ callback String 提交时传递的callback
       ∟ details Object[] 语种检测详情
        ∟ type String 语种类型,支持检测语种类型请参考语种代码表
        ∟ segments Object[] 识别语种检测的音频断句
         ∟ startTime Number 最近开始时间点,单位秒
         ∟ endTime Number 最近结束时间点,单位秒
         ∟ startTimeMillis Number 最近开始时间点,单位毫秒
         ∟ endTimeMillis Number 最近结束时间点,单位毫秒
      ∟ asr Object 语音识别检测结果,如有需要请联系您的专属商务,未开通状态下不返回
       ∟ taskId String 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询
       ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
       ∟ callback String 提交时传递的callback
       ∟ details Object[] 语音识别详情
        ∟ startTime Number 断句开始时间点,单位秒
        ∟ endTime Number 断句结束时间点,单位秒
        ∟ startTimeMillis Number 断句开始时间点,单位毫秒
        ∟ endTimeMillis Number 断句结束时间点,单位毫秒
        ∟ content String 语音识别内容
      ∟ voice Object 人声属性检测结果,如有需要请联系您的专属商务,未开通状态下不返回
       ∟ taskId String 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询
       ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
       ∟ callback String 提交时传递的callback
       ∟ detail Object 人声属性详情
        ∟ mainGender String 音频性别建议值,male/female
        ∟ mainAgeGroup String 识别人声年龄建议值,underage(0~18岁),adult(18岁以上)
        ∟mainAgeGroupRate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
        ∟deepfake Number 音频深度伪造检测值,1-伪造,0-真实
      ∟ quality Object 质量检测结果,如有需要请联系您的专属商务,未开通状态下不返回
       ∟ taskId String 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询
       ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
       ∟ callback String 提交时传递的callback
       ∟ silentSegments Object[] 无声断句检测结果详情
        ∟ startTime Number 断句开始时间点,单位秒
        ∟ endTime Number 断句结束时间点,单位秒
        ∟ startTimeMillis Number 断句开始时间点,单位毫秒
        ∟ endTimeMillis Number 断句结束时间点,单位毫秒

    响应体示例

    {
      "code": 200,
      "msg": "ok",
      "result": [
        {
          "antispam": {
            "taskId": "38e08da8d2574df4bd2eca9b5153df72",
            "status ": 2,
            "suggestion": 1,
            "suggestionLevel": 2,
            "resultType": 1,
            "segments": [
              {
                "startTime": 0,
                "endTime": 20,
                "content": "加我",
    	    "url":"https://as.dun.163.com/v1/audio/segment/play?Signature=455f29675707306bc700e3d9b59ce4f5&Expires=1672404623965&AccessKey=d7k9wgszvzwyg00609yg5&BeginTime=285&EndTime=300",
                "labels": [
                  {
                    "label": 200,
                    "level": 1,
                    "subLabels": [
                      {
                        "subLabel": "200009",
                        "subLabelDepth":2,
                        "secondLabel":"200009",
                        "details": {
                          "hitInfos": [
                            {
                              "value": "加我"
                            }
                          ],
                          "keywords": [
                            {
                              "word": "xxx"
                            }
                          ],
                          "libInfos": [
                            {
                              "listType": 1,
                              "entity": "xxx"
                            }
                          ]
                        }
                      }
                    ]
                  },
                  {
                    "label": 100,
                    "level": 0
                  },
                  {
                    "label": 200,
                    "level": 0
                  },
                  {
                    "label": 300,
                    "level": 0
                  },
                  {
                    "label": 400,
                    "level": 0
                  },
                  {
                    "label": 1100,
                    "level": 0
                  }
                ]
              }
            ],
            "callback": "",
            "dataId": "",
            "censorSource": 2,
            "duration": 10,
            "censorTime": 1621825885716,
            "censorLabels": []
          },
          "language": {
            "taskId": "38e08da8d2574df4bd2eca9b5153df72",
            "dataId": "",
            "callback": "",
            "details": [
              {
                "type": "en",
                "segments": [
                  {
                    "startTime": 35,
                    "endTime": 40
                  },
                  {
                    "startTime": 160,
                    "endTime": 165
                  }
                ]
              }
            ]
          },
          "asr": {
            "taskId": "38e08da8d2574df4bd2eca9b5153df72",
            "dataId": "",
            "callback": "",
            "details": [
              {
                "startTime": 0,
                "endTime": 20,
                "content": "加我"
              }
            ]
          },
          "voice": {
            "taskId": "7f03cdeaf4cf4c748a4edbe97833a9ee",
            "dataId": "",
            "callback": "",
            "detail": {
              "mainGender": "male",
              "mainAgeGroup": "adult",
              "mainAgeGroupRate": 0.9973
            }
          },
          "quality": {
            "dataId": "",
            "callback": "",
            "taskId": "7f03cdeaf4cf4c748a4edbe97833a9ee",
            "silentSegments": [
              {
                "startTime": 0,
                "endTime": 6
              },
              {
                "startTime": 6,
                "endTime": 12
              },
              {
                "startTime": 12,
                "endTime": 18
              },
              {
                "startTime": 18,
                "endTime": 19
              }
            ]
          }
        }
      ]
    }
    

    响应返回码

    响应返回码见:响应返回码

    示例代码

    服务端 SDK 接入

    推荐使用我们提供的服务端 SDK 进行接入(目前支持 Java 和 Go 两种语言),不但可以节省接入成本,实现更快速的集成,并享有灵活的请求配置选项,同时 SDK 内置了错误重试、熔断降级等功能,提升服务可用性。点击 服务端 SDK 接入指引 了解更多。

    Github Demo 地址

    Gitee Demo 地址(Github 无法访问时选择)

    HTTP API 接入

    Github Demo 地址

    Gitee Demo 地址(Github 无法访问时选择)

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