全部产品
Search

搜索本产品

    Python Demo

    文档中心
    下载PDF

    Python Demo

    更新时间： 2020-11-03

    提示:

    • 在使用SDK之前，请先确保已阅读了 接口说明文档。
    • 本文档中的SDK只适用于7月5日新发布的2.0版语音服务，如果您是之前开通的，要使用此SDK需要新开通2.0版服务。

    SDK说明

    录音文件识别的Python Demo使用了阿里云Python SDK的CommonRequest用来提交录音文件识别请求和识别结果查询，采用的是RPC风格的POP API调用。阿里云Python SDK的详细介绍请阅读阿里云Python SDK 使用手册，Python SDK CommonRequest的使用方法请阅读 使用CommonRequest进行调用。

    SDK 安装

    录音文件识别Python Demo只需安装阿里云Python SDK的核心库。阿里云Python SDK的安装支持Python 2.6.x, 2.7.x 和 3.x及以上环境，并提供pip和GitHub两种安装方式。

    使用pip安装（推荐）

    说明： 执行以下命令，通过pip安装Python SDK，版本为2.13.3：

    1. pip install aliyun-python-sdk-core==2.13.3

    说明：文档会定期更新最新可支持录音文件识别的SDK版本，您已经安装使用的SDK版本可继续使用。

    调用步骤

    1. 创建并初始化AcsClient示例，鉴权使用了阿里云账号的AccessKey ID和AccessKey Secret（获取方法请阅读 开通服务 一节）。
    2. 创建录音文件识别请求，并设置请求参数。
    3. 提交录音文件识别请求，处理服务端返回的响应，获取任务ID。
    4. 创建识别结果查询请求，设置查询参数为任务ID。
    5. 轮询识别结果。

    Demo 示例

    录音文件说明： Demo中使用的录音文件为PCM编码格式16000Hz采样率，管控台设置的模型为通用模型；如果使用其他录音文件，请填入对应的编码格式和采样率，并在管控台设置对应的模型，模型设置请阅读管理项目一节。

    nls-sample-16k.wav

    示例

    1. # -*- coding: utf8 -*-
    3. import json
    4. import time
    5. from aliyunsdkcore.acs_exception.exceptions import ClientException
    6. from aliyunsdkcore.acs_exception.exceptions import ServerException
    7. from aliyunsdkcore.client import AcsClient
    8. from aliyunsdkcore.request import CommonRequest
    10. def fileTrans(akId, akSecret, appKey, fileLink) :
    11.     # 地域ID，常量内容，请勿改变
    12.     REGION_ID = "ap-southeast-1"
    13.     PRODUCT = "nls-filetrans"
    14.     DOMAIN = "filetrans.ap-southeast-1.aliyuncs.com"
    15.     API_VERSION = "2019-08-23"
    16.     POST_REQUEST_ACTION = "SubmitTask"
    17.     GET_REQUEST_ACTION = "GetTaskResult"
    19.     # 请求参数key
    20.     KEY_APP_KEY = "appkey"
    21.     KEY_FILE_LINK = "file_link"
    22.     KEY_VERSION = "version"
    23.     KEY_ENABLE_WORDS = "enable_words"
    24.     # 是否开启智能分轨
    25.     KEY_AUTO_SPLIT = "auto_split"
    26.     # 响应参数key
    27.     KEY_TASK = "Task"
    28.     KEY_TASK_ID = "TaskId"
    29.     KEY_STATUS_TEXT = "StatusText"
    30.     KEY_RESULT = "Result"
    31.     # 状态值
    32.     STATUS_SUCCESS = "SUCCESS"
    33.     STATUS_RUNNING = "RUNNING"
    34.     STATUS_QUEUEING = "QUEUEING"
    37.     # 创建AcsClient实例
    38.     client = AcsClient(akId, akSecret, REGION_ID)
    40.     # 提交录音文件识别请求
    41.     postRequest = CommonRequest()
    42.     postRequest.set_domain(DOMAIN)
    43.     postRequest.set_version(API_VERSION)
    44.     postRequest.set_product(PRODUCT)
    45.     postRequest.set_action_name(POST_REQUEST_ACTION)
    46.     postRequest.set_method('POST')
    48.     # 新接入请使用4.0版本，已接入(默认2.0)如需维持现状，请注释掉该参数设置
    49.     # 设置是否输出词信息，默认为false，开启时需要设置version为4.0
    50.     task = {KEY_APP_KEY : appKey, KEY_FILE_LINK : fileLink, KEY_VERSION : "4.0", KEY_ENABLE_WORDS : False}
    51.     # 开启智能分轨，如果开启智能分轨 task中设置KEY_AUTO_SPLIT : True
    52.     # task = {KEY_APP_KEY : appKey, KEY_FILE_LINK : fileLink, KEY_VERSION : "4.0", KEY_ENABLE_WORDS : False, KEY_AUTO_SPLIT : True}
    53.     task = json.dumps(task)
    55.     print(task)
    57.     postRequest.add_body_params(KEY_TASK, task)
    59.     taskId = ""
    60.     try :
    61.         postResponse = client.do_action_with_exception(postRequest)
    62.         postResponse = json.loads(postResponse)
    63.         print (postResponse)
    65.         statusText = postResponse[KEY_STATUS_TEXT]
    66.         if statusText == STATUS_SUCCESS :
    67.             print ("录音文件识别请求成功响应！")
    68.             taskId = postResponse[KEY_TASK_ID]
    69.         else :
    70.             print ("录音文件识别请求失败！")
    71.             return
    72.     except ServerException as e:
    73.         print (e)
    74.     except ClientException as e:
    75.         print (e)
    78.     # 创建CommonRequest，设置任务ID
    79.     getRequest = CommonRequest()
    80.     getRequest.set_domain(DOMAIN)
    81.     getRequest.set_version(API_VERSION)
    82.     getRequest.set_product(PRODUCT)
    83.     getRequest.set_action_name(GET_REQUEST_ACTION)
    84.     getRequest.set_method('GET')
    86.     getRequest.add_query_param(KEY_TASK_ID, taskId)
    88.     # 提交录音文件识别结果查询请求
    89.     # 以轮询的方式进行识别结果的查询，直到服务端返回的状态描述符为"SUCCESS"、"SUCCESS_WITH_NO_VALID_FRAGMENT"，
    90.     # 或者为错误描述，则结束轮询。
    91.     statusText = ""
    92.     while True :
    93.         try :
    94.             getResponse = client.do_action_with_exception(getRequest)
    95.             getResponse = json.loads(getResponse)
    96.             print (getResponse)
    98.             statusText = getResponse[KEY_STATUS_TEXT]
    99.             if statusText == STATUS_RUNNING or statusText == STATUS_QUEUEING :
    100.                 # 继续轮询
    101.                 time.sleep(10)
    102.             else :
    103.                 # 退出轮询
    104.                 break
    105.         except ServerException as e:
    106.             print (e)
    107.         except ClientException as e:
    108.             print (e)
    111.     if statusText == STATUS_SUCCESS :
    112.         print ("录音文件识别成功！")
    113.     else :
    114.         print ("录音文件识别失败！")
    116.     return
    121. accessKeyId = "您的AccessKey Id"
    122. accessKeySecret = "您的AccessKey Secret"
    123. appKey = "您的appkey"
    124. fileLink = "https://aliyun-nls.oss-cn-hangzhou.aliyuncs.com/asr/fileASR/examples/nls-sample-16k.wav"
    126. # 执行录音文件识别
    127. fileTrans(accessKeyId, accessKeySecret, appKey, fileLink)
    免费试用 免费试用