365bet注册开户- 首页

logo
产品简介 产品简介
基本概念 基本概念
平台新手指引 平台新手指引
计价模式 计价模式
开发者文档下拉
开放平台计价
定制服务计价
获取访问令牌 获取访问令牌
语音合成 语音合成
开发者文档下拉
接口说明
发音人列表
在线合成 开发者文档下拉
Android SDK
iOS SDK
C++(Linux) SDK
RESTful API
Websocket API
长文本语音合成API
离线合成 开发者文档下拉
离线合成 Android SDK
离线合成 iOS SDK
XML标签
语音识别 语音识别
开发者文档下拉
音频格式说明
一句话识别 开发者文档下拉
RESTful API
Websocket API
Android SDK
iOS SDK
实时长语音识别 开发者文档下拉
Websocket API
Android SDK
iOS SDK
录音文件识别 开发者文档下拉
RESTful API
声音复刻 声音复刻
开发者文档下拉
定制模型 开发者文档下拉
RESTful API
Android SDK
iOS SDK
定制声音合成 开发者文档下拉
RESTful API
声音转换 声音转换
开发者文档下拉
发音人列表
Websocket API
Android SDK
iOS SDK
声纹识别 声纹识别
开发者文档下拉
RESTful API
协议规则 协议规则
开发者文档下拉
平台服务协议
平台通用规则
法律声明及隐私政策
服务等级协议SLA
常见问题 常见问题
开发者文档下拉
语音合成
语音识别

录音文件识别Restful API

功能介绍

录音文件识别时针对已经录制的音频文件,进行文字转写。录音文件识别是非实时的,通过接口提交录音文件或可以直接下载的文件URL,系统接收后进行识别转文字。

音频要求

  • 直接上传音频数据方式一次最多不能超过64MB
  • 通过提交音频URL方式文件大小不超过512MB
  • 单声道:wav,pcm,mp3,ogg,flac
  • 双声道:wav,mp3,ogg,flac
  • 音频采样率:8000Hz,16000Hz
  • 位深:16bits

使用方法

1. 创建账号和应用,详见平台新手指引,通过标贝开放平台/应用/服务获取client_id,client_secret

2. 发送请求获取access_token,详见获取访问令牌

3. 发送新建任务请求:发送新建任务请求,具体参数详见请求参数

4. 接收返回结果:发送请求成功后会立即收到返回响应,采用JSON格式封装,在“taskid"字段中获取任务id,具体参数详见新建任务响应结果

5. 发送查询识别结果请求:使用“taskid”发送查询识别结果请求,具体参数详见查询识别结果

6. 接收识别结果:发送请求成功后会立即收到返回响应,采用JSON格式封装,识别结果在“text"字段内,具体参数详见响应识别结果

服务地址

访问类型 说明 URL Host
外网访问 新建任务 https://openapi.data-baker.com/asr/starttask? openapi.data-baker.com
外网访问 查询结果
(主动轮询)
https://openapi.data-baker.com/asr/taskresult? openapi.data-baker.com

交互流程

1. 主动轮询 2. 回调通知

测试音频

测试音频

请求参数

1. 请求headers
参数名称 名称 是否必填 说明
access_token String Yes 通过client_id,client_secret调用授权服务获得见获取访问令牌
file_url String No 录音文件URL,外网可访问。 如未指定该参数,则把音频方与请求体中上传
callback_url String No 识别结果回调URL
如有,则识别结束后通过回调通知
否则,则通过查询结果进行轮询
channel Integer No 录音文件声道数
1:单声道
2:双声道(audio_format为mp3时支持)
audio_format String Yes 音频格式
pcm
wav
mp3
sample_rate Integer Yes 音频采样率支持
8000Hz
16000Hz
domain string no 模型名称,通用模型 "common",
英文模型"english",
默认值为“common”
add_pct string no true: 加标点,默认值
false:不添加标点
2. 请求体

当未指定file_url参数时,请将二进制音频数据放到HTTP请求体中;

当指定file_url参数时,服务端将忽略HTTP请求体,并从指定的url处下载音频文件

请求示例

curl -X POST \
-H "access_token:xxxxxxxxxx" \
-H "audio_format:wav" \
-H "sample_rate:16000" \
--data-binary "@wav_16k.wav" \
"https://openapi.data-baker.com/asr/starttask?"

Python示例代码

代码地址:Github

Python3示例如下:

#!/usr/bin/env python
# coding: utf-8

import argparse
import time

import requests
import json


# 获取access_token用于鉴权
def get_access_token(client_secret, client_id):
    grant_type = "client_credentials"
    url = "https://openapi.data-baker.com/oauth/2.0/token?grant_type={}&client_secret={}&client_id={}".format(
        grant_type, client_secret, client_id)
    response = requests.post(url)
    access_token = json.loads(response.text).get('access_token')

    return access_token


# 查询识别结果
def get_text(headers):
    url = "https://asr.data-baker.com/asr/taskresult"
    response = requests.post(url, headers=headers)
    text = json.loads(response.text).get("text")
    code = json.loads(response.text).get("code")
    if code != 20000:
        raise Exception(response.text)

    return text


# 创建识别任务,发送识别文件
def create_task(file, headers):
    url = "https://openapi.data-baker.com/asr/starttask?"
    response = requests.post(url, data=file, headers=headers)
    task_id = json.loads(response.text).get("taskid")
    code = json.loads(response.text).get("code")
    if code != 20000:
        raise Exception(response.text)

    return task_id


# 获取命令行输入参数
def get_args():
    parser = argparse.ArgumentParser(description='ASR')
    parser.add_argument('-client_secret', type=str, required=True)
    parser.add_argument('-client_id', type=str, required=True)
    parser.add_argument('-file_path', type=str, required=True)
    parser.add_argument('--audio_format', type=str, default='wav')
    parser.add_argument('--sample_rate', type=str, default='16000')
    args = parser.parse_args()

    return args


if __name__ == '__main__':
    try:
        args = get_args()

        # 获取access_token
        client_secret = args.client_secret
        client_id = args.client_id
        access_token = get_access_token(client_secret, client_id)

        # 新建任务
        file = open(args.file_path, 'rb')
        audio_format = args.audio_format
        sample_rate = args.sample_rate
        headers = {'access_token': access_token, 'audio_format': audio_format, 'sample_rate': sample_rate}
        task_id = create_task(file, headers)

        # 根据录音文件大小,等待识别结束
        time.sleep(1)

        # 查询识别结果
        recognition_headers = {'access_token': access_token, 'taskid': task_id}
        text = get_text(recognition_headers)
        print(text['left_result'])
    except Exception as e:
        print(e)

命令行执行: 默认wav格式,16000采样率

python audio_file_recognition.py -client_secret=你的client_secret -client_id=你的client_secret -file_path=test.wav

如有主要可自行修改参数

python audio_file_recognition.py -client_secret=你的client_secret -client_id=你的client_id -file_path=test.wav --audio_format=wavmple_rate=16000

PHP示例代码

C示例代码

代码地址:Github

JAVA示例代码

package com.databaker.web.asr;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import okhttp3.*;
import org.apache.commons.lang3.StringUtils;

import java.io.File;
import java.io.FileInputStream;


/**
 * 录音文件识别RESTFUL API接口调用示例
 * 附:录音文件识别RESTFUL API文档 【/specs/file/asr_file_api_restful】
 *
 * 注意:
 * 1.仅作为demo示例,失败重试、token过期重新获取、日志打印等优化工作需要开发者自行完成
 * 2.录音文件识别中的录音文件有两种提交方式:A.在header中通过音频下载链接方式提交 B.在body中通过音频文件流方式提交。服务端优先使用方式A提供的音频。
 * 3.录音文件识别是非实时接口,提供了两种方式获取结果:A.开发者提供回调接口 B.开发者主动查询进度接口。开发者可自由选择,主动查询时注意频率不要太高。
 *
 * @author data-baker
 */
public class AsrFileRestApiDemo {
    /**
     * 授权:需要在开放平台获取【https://ai.data-baker.com/】
     */
    private static final String clientId = "YOUR_CLIENT_ID";
    private static final String clientSecret = "YOUR_CLIENT_SECRET";

    /**
     * 获取token的地址信息
     */
    public static String tokenUrl = "https://openapi.data-baker.com/oauth/2.0/token?grant_type=client_credentials&client_secret=%s&client_id=%s";
    /**
     * 录音文件识别API地址
     */
    public static String asrSubmitTaskUrl = "https://openapi.data-baker.com/asr/starttask";
    /**
     * 录音文件识别API地址
     */
    public static String asrQueryTaskUrl = "https://openapi.data-baker.com/asr/taskresult";
    /**
     * 文件流方式上传音频,最大支持64M;音频URL方式上传,最大支持512M
     */
    public static Integer MAX_FILE_SIZE = 64 * 1024 * 1024;

    /**
     * 仅作为demo示例
     * 失败重试、token过期重新获取、日志打印等优化工作需要开发者自行完成
     **/
    public static void main(String[] args) {
        String accessToken = getAccessToken();
        if (StringUtils.isNotEmpty(accessToken)) {
            //支持两种上传音频方式:url或文件流;支持三种音频格式:pcm、wav、mp3
            //1.url方式
            //String audioFileInfo = "YOUR_AUDIO_FILE_URL";
            //String taskId = submitFileAsrTask(accessToken, audioFileInfo, AudioFileTypeEnum.UrlType, "mp3", 16000, "");

            //2.文件流方式
            String audioFileInfo = "YOUR_AUDIO_FILE_FULL_PATH";
            String taskId = submitFileAsrTask(accessToken, audioFileInfo, AudioFileTypeEnum.FileType, "pcm", 16000, "");

            //查询识别结果
            try {
                if (StringUtils.isNotEmpty(taskId)) {
                    Thread.sleep(10 * 1000);
                    queryFileAsrTaskResult(accessToken, taskId);
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

    /**
     * 提交录音文件识别任务
     */
    public static String submitFileAsrTask(String accessToken, String audioFileInfo, AudioFileTypeEnum fileType, String audioFormat, Integer sampleRate, String callback_url) {
        try {
            OkHttpClient client = new OkHttpClient();
            MediaType mediaType = MediaType.parse("application/octet-stream");
            //requestBody默认为空
            RequestBody requestBody = RequestBody.create(null, new byte[0]);
            //如果以文件流方式上传,文件流放在requestBody里面
            if (AudioFileTypeEnum.FileType.equals(fileType)) {
                File audioFile = new File(audioFileInfo);
                if (!audioFile.exists() || audioFile.length() > MAX_FILE_SIZE) {
                    return "";
                }
                FileInputStream in = new FileInputStream(audioFile);
                byte[] fileByte = new byte[(int) audioFile.length()];
                int realLen = in.read(fileByte);
                //确保音频文件内容全部被读取
                if (realLen == (int) audioFile.length()) {
                    requestBody = RequestBody.create(mediaType, fileByte);
                }
            }
            //构造完整request
            Request request = new Request.Builder()
                    .url(asrSubmitTaskUrl)
                    .addHeader("access_token", accessToken)
                    .addHeader("file_url", AudioFileTypeEnum.UrlType.equals(fileType) ? audioFileInfo : "")
                    .addHeader("audio_format", audioFormat)
                    .addHeader("sample_rate", String.valueOf(sampleRate))
                    .addHeader("domain", "common")
                    .addHeader("callback_url", callback_url)
                    .method("POST", requestBody)
                    .build();
            Response response = client.newCall(request).execute();
            if (response.isSuccessful()) {
                JSONObject jsonObject = JSON.parseObject(response.body().string());
                System.out.println("提交识别任务成功,任务id:" + (jsonObject == null ? "" : jsonObject.getString("taskid")));
                return jsonObject == null ? "" : jsonObject.getString("taskid");
            } else {
                System.out.println("提交识别任务失败,错误信息:" + response.body().string());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        return "";
    }

    /**
     * 查询录音文件识别任务的结果
     */
    public static void queryFileAsrTaskResult(String accessToken, String taskId) {
        try {
            OkHttpClient client = new OkHttpClient();
            //requestBody默认为空
            RequestBody requestBody = RequestBody.create(null, new byte[0]);
            Request request = new Request.Builder()
                    .url(asrQueryTaskUrl)
                    .addHeader("access_token", accessToken)
                    .addHeader("taskid", taskId)
                    .method("POST", requestBody)
                    .build();
            Response response = client.newCall(request).execute();
            if (response.isSuccessful()) {
                JSONObject jsonObject = JSON.parseObject(response.body().string());
                // 返回的结构开发者可参考接口文档【/specs/file/asr_file_api_restful】中的“响应识别结果”部分。
                // 本demo测试时使用的是单声道音频,故仅获取left_result作为示例。开发者请根据音频情况自行解析。
                if (jsonObject == null) {
                    System.out.println("查询识别任务成功,结果信息:null");
                } else {
                    jsonObject = jsonObject.getJSONObject("text");
                    System.out.println("查询识别任务成功,结果信息:" + (jsonObject == null ? "null" : jsonObject.getString("left_result")));
                }
            } else {
                System.out.println("查询识别任务失败,错误信息:" + response.body().string());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static String getAccessToken() {
        String accessToken = "";
        OkHttpClient client = new OkHttpClient();
        //request 默认是get请求
        String url = String.format(tokenUrl, clientSecret, clientId);
        Request request = new Request.Builder().url(url).build();
        JSONObject jsonObject;
        try {
            Response response = client.newCall(request).execute();
            if (response.isSuccessful()) {
                //解析
                String resultJson = response.body().string();
                jsonObject = JSON.parseObject(resultJson);
                accessToken = jsonObject.getString("access_token");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        return accessToken;
    }

    public enum AudioFileTypeEnum {
        UrlType(1),
        FileType(2);

        private int type;

        AudioFileTypeEnum(int type) {
            this.type = type;
        }
    }
}

      

新建任务响应结果

字段名 描述
trace_id 日志id,如遇到问题,可反馈此id给开发,用于跟踪问题
code 请求结果码,请参考错误码一节
info 任务结果描述,如请求失败请根据该字段内容分析问题
taskid 任务id,后面请求方可携带此taskid去查询是否识别结束
1. 请求成功
{
    "trace_id":" 1571988259683020 ",
    "code":20000,
    "info":"Success",
    "taskid":" f0c58fc9************90e3ebfdb653"
}
2. 请求失败
{
    "trace_id":" 1571988883381595 ",
    "code":40007,
    "info":"Invalid body"
}

查询识别结果

参数名称 类型 是否必填 说明
access_token String Yes 通过client_id,client_secret调用授权服务获得见获取访问令牌
taskid string yes 识别任务的taskid
curl -X POST \
-H "access_token:xxxxxxxxxx" \
-H "taskid:f0c58fc9************90e3ebfdb653" \
"https://openapi.data-baker.com/asr/taskresult" 

响应识别结果

回调通知或主动查询得到识别结果,json格式返回。
字段名 类型 描述
trace_id string 日志id,如遇到问题,可反馈此id给开发,用于跟踪问题
code int 请求结果码,请参考错误码一节
info string 任务结果描述,如请求失败请根据该字段内容分析问题
text jsonObject 识别结果,josn对象,任务失败则为空
taskid string 任务id,后面请求方可携带此taskid去查询是否识别结束

text参数:

字段名 类型 描述 内部结构
left_result_array jsonArray 左声道分段识别结果 segment_code:int, 分段任务code,暂时固定为 20000,忽略该字段
success:string, yes/no此分段是否识别成功,忽略该字段
sos:string, 音频分段开始时间点(秒)
eos:string, 音频分段结束时间点(秒)
result:string, 分段识别结果
right_result_array jsonArray 右声道分段识别结果 同上
left_result string 左声道全部识别结果
right_result string 右声道全部识别结果

识别结果示例

{
	  "trace_id":" 1571988259683020 ",
	  "code":20000,
	  "info":"Success",
	  "text":
	  {
		  "left_result_array":
		  [
			 {"sos":0.02, "eos":4,  "result":"北国风光", "success":"yes"},
			 {"sos":6,    "eos":10, "result":"千里冰封" , "success":"yes"},
			 {"sos":11,   "eos":15, "result":"万里雪飘" , "success":"yes"},
			 {"sos":17,   "eos":22, "result":"望长城内外" , "success":"yes"}
		  ],
		  "left_result":" 北国风光,千里冰封,万里雪飘,望长城内外…"
		  "right_result_array":
		  [
			  {},
			  {}
		  ],
		  "right_result":"…"
	  },
	  "taskid":" f0c58fc9************90e3ebfdb653"
}

回调通知

录音文件识别支持回调接口发送识别结果,在调用创建任务接口时,填写callback_url可以将识别结果直接发送到该接口。(如果长时间未收到回调通知,仍可以根据taskid调用识别接口进行查询)

回调通知Python3示例代码

from flask import Flask, request
import json


app = Flask(__name__)


@app.route("/", methods=['GET', 'POST'])
def get_text():
    with open('test.txt', 'w') as f:
        text = json.loads(request.get_data())['text']['left_result']
        f.write(text)
    return "finished"

将上述代码保存为server.py

命令行执行

export FLASK_APP=server
flask run -p 端口号 --host=服务器IP

回调示例

{'left_result': '欢迎使用标贝科技开放平台!', 'left_result_array': [{'eos': '4.97', 'result': '欢迎使用标贝科技开放平台!', 'segment_code': 20000, 'sos': '0.23', 'success': 'yes'}]}

错误码

code 描述 解决方案
20000 请求成功
20001 任务正在处理 等待10分钟再查询
20002 taskid无效 使用新建识别任务时返回的taskid
30001 HTTP请求参数错误 服务器内部错误,提交traceid,标贝后台进行排查。
30002 服务内部错误
30003 识别结果解析出错
30004 应用包名未知
30005 语音质量问题
30006 输入语音过长
30007 连接识别引擎失败
30008 会话id不存在
30009 Rpc调用非法
30010 redis rpop操作返回空
30011 redis rpop值不合法
30012 rpc调用识别引擎失败
30013 Redis rpop操作失败
30014 redis lpush操作失败
30015 单个语音分片过长
30016 回调url失败
50002 内部rpc调用失败
50009 其他内部错误