语音合成 一分钟接入服务端 API

这里说明如何使用 API 3.0 Explorer 在线调试语音合成相关接口,并快速将该接口对应的腾讯云开发者工具套件(SDK)集成到本地项目中。

相关产品
语音合成 产品页,含版本规格、价格与购买入口。

一、开通语音合成服务

在调用语音合成相关接口前,你需要进入 语音合成控制台,进行实名认证和人脸认证,认证完成后,阅读《用户协议》后勾选“我已阅读并同意《用户协议》”,然后单击立即开通。

服务开通成功后,你将获得各项服务对应的免费调用额度,可在 资源包管理页 领取。同时你也可以在 语音合成购买页 中购买对应语音合成服务的资源包,若免费额度以及资源包调用次数耗尽,接口计费将自动转为后付费方式按日进行结算,具体计费标准可查看 购买指南。

二、调试语音合成接口

语音合成服务开通成功后,进入语音合成 API 3.0 Explorer 在线接口调试页面,选择需要调用的接口,并填写输入参数。输入参数在 API 3.0 Explorer 界面的“文档说明”选项卡中可以查看对应接口输入参数的具体含义。

填写输入参数后,选择“代码示例”选项卡,可以看到自动生成的不同编程语言代码(可支持 Java、Python、Node.js、PHP、GO、.NET、C++ 语言),生成代码中的部分字段信息和填写内容是关联的,如需调整传入参数,可在左侧修改参数值后重新生成代码。

选择“在线调用”选项卡,单击发送请求可进行真实请求,供你调试、参考。

三、集成语音合成 SDK

确认本地依赖环境满足以下条件:

编程环境 SDK 集成要求
Node.js 需要 NODEJS 10.0.0 版本及以上
Python 需要 Python 2.7、3.6至3.9版本
Java 需要 JDK 7 版本及以上
Go 需要 Go 1.9 版本及以上(如使用 go mod 需要 Go 1.14)
.Net 需要 .NET Framework 4.5+ 或者 .NET Core 2.1
PHP 需要 PHP 5.6.0 版本及以上
C++ 需要 C++ 11 或更高版本的编译器 GCC 4.8 或以上版本。暂时仅支持 Linux 环境,不支持 Windows 环境
Ruby 需要 Ruby 2.3 及以上版本

安装与本地依赖环境对应的腾讯云语音合成 SDK,下面将以 Node.js 为例说明 SDK 安装、使用的方法。

四、通过 npm 安装(推荐)

通过 npm 获取安装是使用 NODEJS SDK 的推荐方法,npm 是 NODEJS 的包管理工具。关于 npm 详细可参考 npm 页面。

1. 执行以下安装命令:

npm install tencentcloud-sdk-nodejs –save

2. 在你的代码中引用对应模块代码,可参考示例。

3. 如上引用方式会将腾讯云所有产品 sdk 下载到本地,可以将 tencentcloud-sdk-nodejs换成 tencentcloud-sdk-nodejs-tts等,即可引用特定产品的 sdk,代码中可将 require("tencentcloud-sdk-nodejs") 改为require("tencentcloud-sdk-nodejs-tts"),其余不变,可参考示例,可大大节省存储空间。

五、通过源码包安装

1. 前往 GitHub 代码托管地址,下载源码压缩包。

2. 解压源码包到你项目合适的位置。

3. 在你的代码中引用对应模块代码,可参考示例。

六、示例

SDK 安装完成后,可在你的项目代码中引用 API 3.0 Explorer 自动生成的代码, 以 Node.js 为例,简易 demo 示例如下:

const tencentcloud = require("tencentcloud-sdk-nodejs");// 导入对应产品模块的client models。const TtsClient = tencentcloud.tts.v20190823.Client;const clientConfig = { // 腾讯云认证信息 credential: { secretId: "SecretId", secretKey: "SecretKey", }, // 产品地域 region: "ap-beijing", profile: { httpProfile: { endpoint: "tts.tencentcloudapi.com", }, },};// 实例化要请求产品(以tts为例)的client对象const client = new TtsClient(clientConfig);// 通过client对象调用想要访问的接口,需要传入请求对象以及响应回调函数const params = { "Text": "欢迎使用腾讯云语音合成", "SessionId": "f7efe047-2ada-4759-b588-3f0faab8c53e", "VoiceType": 101007};client.TextToVoice(params).then( (data) => { console.log(data); }, (err) => { console.error("error", err); });

在支持 typescript 项目中,采用如下方式调用:

import * as tencentcloud from "tencentcloud-sdk-nodejs"// 导入对应产品模块的client models。const TtsClient = tencentcloud.tts.v20190823.Clientconst clientConfig = { // 腾讯云认证信息 credential: { secretId: "SecretId", secretKey: "SecretKey", }, // 产品地域 region: "ap-beijing", profile: { httpProfile: { endpoint: "tts.tencentcloudapi.com", }, },}// 实例化要请求产品(以tts为例)的client对象const client = new TtsClient(clientConfig)// 通过client对象调用想要访问的接口,需要传入请求对象以及响应回调函数const params = { "Text": "欢迎使用腾讯云语音合成", "SessionId": "f7efe047-2ada-4759-b588-3f0faab8c53e", "VoiceType": 101007}client.TextToVoice(params).then( (data) => { console.log(data); }, (err) => { console.error("error", err); })

实例化 Client 的入参支持 clientConfig 数据结构和说明,详请可参见 ClientConfig。

赞 (0)
上一篇 4天前
下一篇 4天前