异步审核

1. 功能介绍

异步审核音频内容中的不良信息和违法违规内容，给出审核结果和处理建议。调用方提交审核语音片段并指定需要检测的类型后，服务器处理将通过回调方式返回检测结果。相对于同步审核，异步审核可接受的处理数据更多，耗时也会响应增大。

检测类型及对应标签如下：

2. 使用限制

3. 接口说明

3.1 提交检测

使用HTTP POST方式发起审核请求

表. body数据结构

表. 请求data

表. extra

响应结果

响应内容为json对象，详细定义如下

3.2 结果回调

服务器处理完毕后，会通过调用时填写的callback地址，把结果返回给调用方。

回调方式 ：https post

回调路径 ：提交检测时填写的callback地址

回调首部 ：为防止结果被篡改，在header增加一个checksum项用于校验内容是否合法。

说明：

checksum串生成方法如下：提交检测时携带参数sequence与结果body拼凑成字符串，通过SHA256算法生成checksum。

回调内容 ：http body为json对象，详细定义如下

表 data

表 result

表 porn-segment

表 antispam-segment

表. antispam-extraData

3.3 结果查询

服务器处理完毕，会采用callback方式回调，建议优先使用回调方式接收处理结果；如果调用方有需要，可以通过以下查询接口，查到处理状态和结果。

查询响应

响应内容为JSON对象，详细定义如下

4. 调用示例

4.1 提交检测请求

# -*- coding: utf-8 -*-
#! python3.5

import requests
import uuid
import base64

host = "https://ai.jocloud.com"

appid = 123456789                         # 您的业务ID
restful_id = '********************'       # 您的证书ID
restful_secret = '********************'   # 您的证书秘钥
traceid = str(uuid.uuid4())
dataid = str(uuid.uuid4())

# url
url = host + '/app/%s/v1/audio/async/submit?traceId=%s' % (appid, traceid)
callback = 'http://127.0.0.1/check?dataid=%s' % dataid

# headers
headers = {
    "content-type": "application/json"
}

auth = base64.b64encode(("%s:%s" % (restful_id, restful_secret)).encode('utf-8'))
headers['token'] = 'Base ' + auth.decode()

# content
values = {
    'actions': ['porn'],
    'data': [
        {
            'dataType': 'URL',
            'content': 'http://static.s3.huajiao.com/Object.access/hj-video/NjJhYWU0OTZmOTY5ZDZkM2UxZDBjZDE0MWNkMjljMDcubXAz',
            'dataId': dataid,
            'context': {'uid': 12345}
        }
    ],
    'callback': callback,
    'sequence': 'test'
}

# request
res = requests.post(url, json=values, headers=headers)
print('code=%s, data=%s\n' % (res.status_code, res.text))

请求响应

{
  "code": 200,
  "message": "OK",
  "traceId": "ff1ec05d-46e7-4235-9c46-cd44b684f043",
  "requestId": "d9f3171b-bd1f-48b1-b663-b232e4ed156b",
  "timestamp": 1584088487
}

4.2 结果查询

发起查询

# -*- coding: utf-8 -*-
#! python3.5

import requests
import uuid
import base64

host = "https://ai.jocloud.com"

appid = 123456789                         # 您的业务ID
restful_id = '********************'       # 您的证书ID
restful_secret = '********************'   # 您的证书秘钥
requestId = 'd9f3171b-bd1f-48b1-b663-b232e4ed156b'# 填写检测请求响应结果携带的requestId
traceid = str(uuid.uuid4())
dataid = str(uuid.uuid4())
# url
url = host + '/app/%s/v1/audio/async/results?traceId=%s&requestId=%s' % (appid, traceid, requestId)

# headers
headers = {
    "content-type": "application/json"
}
auth = base64.b64encode(("%s:%s" % (restful_id, restful_secret)).encode('utf-8'))
headers['token'] = 'Base ' + auth.decode()

# request
res = requests.get(url, headers=headers)
print('code=%s, data=%s\n' % (res.status_code, res.text))

请求响应

{
  "code": 200,
  "data": [
    {
      "code": 200,
      "message": "OK",
      "context": { "uid": 12345 },
      "dataId": "69c5b065-d0bf-47c5-84cc-252f6dbf6979",
      "results": [
        {
          "code": 200,
          "message": "OK",
          "action": "porn",
          "label": "moan",
          "rate": 0.7400000095367432,
          "suggestion": "review",
          "duration": 10,
          "segment": [
            {
              "begin": 0,
              "end": 10,
              "score": 74
            }
          ]
        }
      ],
      "taskId": "36c1f70f-89ae-47c3-ba97-40b0a82af7d7"
    }
  ],
  "message": "OK",
  "requestId": "d9f3171b-bd1f-48b1-b663-b232e4ed156b",
  "status": "completed",
  "timestamp": 1584088487,
  "traceId": "f257b637-692c-4033-85aa-ad2ebbc50a89"
}

5. 更新历史