腾讯云智聆口语评测Python SDK-教育服务解决方案
环境依赖
安装 Python2.7，3.6~3.9版本，Python官网。
安装 SDK
使用 pip 安装Python SDK，可以选择安装所有依赖或本产品相关依赖。更多内容前往Github 仓库 或者 Gitee 仓库 。所有依赖相关依赖
pip install --upgrade tencentcloud-sdk-python
pip install --upgrade tencentcloud-sdk-python-common tencentcloud-sdk-python-soe tencentcloud-sdk-python-sts
使用 SDK
可通过控制台生成代码进行调用或者参考下方示例，密钥获取可参考快速入门。
本地音频文件评测
发音数据传输附带初始化：直接调用发音数据传输接口附带初始化过程完成一次性评测。
# -*- coding: utf-8 -*-# 发音数据传输接口附带初始化过程（https://cloud.tencent.com/document/product/884/32605）import jsonimport osimport uuidimport base64
from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptionfrom tencentcloud.soe.v20180724 import soe_client, models
# 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密# 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305# 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取cred = credential.Credential("SecretId", "SecretKey")# 实例化soe的client对象client = soe_client.SoeClient(cred, "")
# 实例化发音数据传输接口请求对象req = models.TransmitOralProcessWithInitRequest()
# 请求参数赋值SessionId = str(uuid.uuid1()) # 使用uuid作为请求SessionId# 读取音频文件，music_file = "SOEMUSIC/apple.mp3" # 音频文件地址with open(music_file, "rb") as f: base64_data = base64.b64encode(f.read()).decode() # 读取音频文件byte数据转成base64格式
params = { "SeqId": 1, "IsEnd": 1, "VoiceFileType": 3, "VoiceEncodeType": 1, "UserVoiceData": base64_data, "SessionId": SessionId, "RefText": "{::cmd{F_TDET=true}}山", "WorkMode": 1, "EvalMode": 1, "ServerType": 1, "ScoreCoeff": 1.0}req.from_json_string(json.dumps(params))try: # 通过client对象调用TransmitOralProcessWithInit方法发起请求 resp = client.TransmitOralProcessWithInit(req) # 输出json格式的字符串回包 print(resp.to_json_string())
except TencentCloudSDKException as err: print(err)
评测超时处理
如果本地文件过大，可能会导致评测超时。可以选用如下方案：1. 流式分片传输：将发音数据进行分片处理，减少每次评测的时间。2. 异步查询：使用异步功能将发音数据先上传，然后使用查询功能查询结构。流式分片传输异步查询
from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptionfrom tencentcloud.soe.v20180724 import soe_client, modelsimport uuidimport jsonimport osimport base64import math
# 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密# 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305# 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取cred = credential.Credential("SecretId", "SecretKey")# 实例化soe的client对象client = soe_client.SoeClient(cred, "")
# 实例化发音数据传输接口请求对象req = models.TransmitOralProcessWithInitRequest()
# 请求参数赋值SessionId = str(uuid.uuid1()) # 使用uuid作为请求SessionIdslice_num = 100 * 1024 # 分片大小， 1 * 1024即为1k
# 读取音频文件，使用本地音频文件录音替换apple.mp3music_file = "SOEMUSIC/para.mp3"with open(music_file, "rb") as f: content = f.read() content_len = len(content)# 分片数量计算pkg_num = math.ceil(content_len / slice_num)# 开始分片并传输for j in range(int(pkg_num)): last_index = content_len if j + 1 == pkg_num else (j + 1) * slice_num IsEnd = 1 if j + 1 == pkg_num else 0 send_content = content[j * slice_num:last_index] base64_data = base64.b64encode(send_content).decode() params = { "SeqId": j + 1, "IsEnd": IsEnd, "VoiceFileType": 3, "VoiceEncodeType": 1, "UserVoiceData": base64_data, "SessionId": SessionId, "RefText": "apple", "WorkMode": 1, "EvalMode": 0, "ServerType": 0, "ScoreCoeff": 1.0 } req.from_json_string(json.dumps(params)) try: # 通过client对象调用TransmitOralProcessWithInit方法发起请求 resp = client.TransmitOralProcessWithInit(req) # 输出json格式的字符串回包 print(resp.to_json_string())
except TencentCloudSDKException as err: print(err) break
# -*- coding: utf-8 -*-# 发音数据传输接口附带初始化过程（https://cloud.tencent.com/document/product/884/32605）import jsonimport osimport timeimport uuidimport base64
from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptionfrom tencentcloud.soe.v20180724 import soe_client, models
# 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密# 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305# 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取cred = credential.Credential("SecretId", "SecretKey")# 实例化soe的client对象client = soe_client.SoeClient(cred, "")
# 实例化发音数据传输接口请求对象req = models.TransmitOralProcessWithInitRequest()
# 请求参数赋值SessionId = str(uuid.uuid1()) # 使用uuid作为请求SessionId# 读取音频文件，music_file = "SOEMUSIC/para.mp3" # 音频文件地址with open(music_file, "rb") as f: base64_data = base64.b64encode(f.read()).decode() # 读取音频文件byte数据转成base64格式
params = { "SeqId": 1, "IsEnd": 1, "VoiceFileType": 3, "VoiceEncodeType": 1, "UserVoiceData": base64_data, "SessionId": SessionId, "RefText": "apple", "WorkMode": 1, "EvalMode": 2, "ServerType": 0, "ScoreCoeff": 1.0, "IsAsync": 1
}req.from_json_string(json.dumps(params))
# 异步查询for i in range(60): try: # 通过client对象调用TransmitOralProcess方法发起请求 resp = client.TransmitOralProcessWithInit(req) # 输出json格式的字符串回包 print(resp.to_json_string()) json_resp = resp.to_json_string() # 获取结果 status = json.loads(json_resp)["Status"] # 查看评测状态 if status == "Finished": # 判断是否评测结束 break else: params["IsQuery"] = 1 # 查询 time.sleep(1) print("查询结果") except TencentCloudSDKException as err: print(err) break
使用方法说明
1，SessionID :使用 uuid 来作为 SessionID，用于区分不同的音频。2，base64转换：读取本地音频文件，转换成 base64数据进行评测。3，流式分片 base64转换：读取本地音频文件，将音频进行分片，转换成 base64数据进行评测。4，轮询查询：使用 json 反序列化，获取评测结果，判断是否查询到最终结果。SessionIDbase64转换流式分片轮询查询
import uuid #python自带SessionId = str(uuid.uuid1()) # 使用uuid作为请求SessionId
import base64 #python自带with open("apple.mp3", "rb") as f: #使用二进制读取音频文件apple.mp3，请自行替换成本地音频文件地址 base64_data = base64.b64encode(f.read).decode() #音频byte数据转base64
with open(music_file, "rb") as f: content = f.read() content_len = len(content)# 分片数量计算pkg_num = math.ceil(content_len / slice_num)# 开始分片并传输for j in range(int(pkg_num)): last_index = content_len if j + 1 == pkg_num else (j + 1) * slice_num IsEnd = 1 if j + 1 == pkg_num else 0 send_content = content[j * slice_num:last_index] base64_data = base64.b64encode(send_content).decode()
# 异步查询for i in range(60): try: # 通过client对象调用TransmitOralProcess方法发起请求 resp = client.TransmitOralProcessWithInit(req) # 输出json格式的字符串回包 print(resp.to_json_string()) json_resp = resp.to_json_string() # 获取结果 status = json.loads(json_resp)["Status"] # 查看评测状态 if status == "Finished": # 判断是否评测结束 break else: params["IsQuery"] = 1 # 查询 time.sleep(1) print("查询结果") except TencentCloudSDKException as err: print(err) break
临时授权凭证
客户端 SDK 需要使用获取联合身份临时访问凭证生成临时密钥，保障密钥安全性。
# -*- coding: utf-8 -*-# 获取联合身份临时访问凭证（https://cloud.tencent.com/document/product/1312/48195）import jsonimport os
from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptionfrom tencentcloud.sts.v20180813 import sts_client, models
# 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密# 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305# 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取cred = credential.Credential("SecretId", "SecretKey")# 实例化sts的client对象client = sts_client.StsClient(cred, "ap-beijing")
# 实例化获取联合身份临时访问凭证请求对象req = models.GetFederationTokenRequest()# 请求参数赋值# soe:TransmitOralProcessWithInit 最小权限原则params = { "Name": "soe", "Policy": "{\"version\": \"2.0\",\"statement\": {\"effect\": \"allow\", \"action\":[\"soe:TransmitOralProcessWithInit\"],\"resource\": \"*\"}}"}req.from_json_string(json.dumps(params))try: # 通过client对象调用GetFederationToken方法发起请求 resp = client.GetFederationToken(req) # 输出json格式的字符串回包 print(resp.to_json_string())
except TencentCloudSDKException as err: print(err)
腾讯云官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
发表评论