http接口

功能介绍

一句话识别接口，用于短语音的同步识别。一次性上传1min以内音频，能快速返回识别结果。该接口的使用限制请参见约束与限制，详细使用指导请参见SIS服务使用简介章节。

SIS服务控制台提供了一句话识别的在线使用页面，用户无需编程即可使用服务功能。

图1 在线使用

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/asr/short-audio

请求参数

响应参数

状态码： 200

状态码： 400

请求示例

“endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。

• 上传短音频，快速返回识别结果

  POST https://{endpoint}/v1/{project_id}/asr/short-audio
  
  Request Header:
  Content-Type: application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
  
  Request body: 
  {
    "config":
    {
      "audio_format": "wav",
      "property": "chinese_16k_general",    "add_punc": "yes",
      "need_word_info": "yes"
    },
    "data": "/+MgxAAUeHpMAUkQAANhuRAC..."
  }

• 使用Python3语言上传短音频，快速返回识别结果

  # -*- coding: utf-8 -*-
  # 此demo仅供测试使用，强烈建议使用sdk。需提前安装requests，执行pip install requests
  import requests
  import base64
  import json
  
  def sasr_demo():
      url = 'https://{{endpoint}}/v1/{{project_id}}/asr/short-audio'  # endpoint和project_id需替换
      token = '用户对应region的token'
      file_path = '将要识别音频的路径'
      with open(file_path, 'rb') as f:
          data = f.read()
          base64_data = str(base64.b64encode(data), 'utf-8')
      header = {
          'Content-Type': 'application/json',
          'X-Auth-Token': token
      }
      body = {
          'data': base64_data,
          'config': {
              'property': 'chinese_16k_general',
              'audio_format': 'pcm16k16bit'
          }
      }
      resp = requests.post(url, data=json.dumps(body), headers=header)
      print(resp.text)
  
  if __name__ == '__main__':
      sasr_demo()

• 使用Java语言上传短音频，快速返回识别结果

  import java.io.BufferedReader;
  import java.io.InputStream;
  import java.io.InputStreamReader;
  import java.io.OutputStreamWriter;
  import java.net.HttpURLConnection;
  import java.net.URL;
  
  /**
   * 此demo仅供测试使用，强烈建议使用SDK
   */
  public class SasrDemo {
    public void sasrDemo() {
      try {
        // endpoint和projectId需要替换成实际信息。
        URL url = new URL("https://{{endpoint}}/v1/{{project_id}}/asr/short-audio");
        String token = "对应region的token";
        String audioBody = "8k wav格式audio对应base64编码";
        HttpURLConnection connection = (HttpURLConnection)url.openConnection();
        connection.setRequestMethod("POST");
        connection.setDoInput(true);
        connection.setDoOutput(true);
        connection.addRequestProperty("Content-Type", "application/json");
        connection.addRequestProperty("X-Auth-Token", token);
  
  
        OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(), "UTF-8");
        String body = "{\"data\":\"" +  audioBody + "\", \"config\": { \"audio_format\": \"wav\", "
          + "\"property\":\"chinese_16k_general\"}}";
        osw.append(body);
        osw.flush();
        InputStream is = connection.getInputStream();
        BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"));
        while (br.ready()) {
          System.out.println(br.readLine());
        }
      } catch (Exception e) {
        e.printStackTrace();
      }
    }
    public static void main(String[] args) {
      SasrDemo sasrDemo = new SasrDemo();
      sasrDemo.sasrDemo();
    }
  }

响应示例

状态码：200

成功响应示例

{
  "trace_id": "567e8537-a89c-13c3-a882-826321939651",
  "result":{
    "text": "欢迎使用语音云服务。",
    "score": 0.9,
    "word_info": [
            {
                "start_time": 150,
                "end_time": 570,
                "word": "欢迎"
            },
            {
                "start_time": 570,
                "end_time": 990,
                "word": "使用"
            },
            {
                "start_time": 990,
                "end_time": 1380,
                "word": "语音"
            },
            {
                "start_time": 1380,
                "end_time": 1590,
                "word": "云"
            },
            {
                "start_time": 1590,
                "end_time": 2070,
                "word": "服务"
            }
        ]
  }
}

状态码：400

失败响应示例

{ 
    "error_code":"SIS.0001", 
    "error_msg":"***" 
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。