一分钟接入服务端 API
操作场景
本文将为您介绍如何使用 API 3.0 Explorer 在线调试语音AI配音、小豆-语音转文字、小豆配音相关接口,并快速将各接口对应的开发者工具套件(SDK)集成到本地项目中。
操作步骤
开通服务
在调用语音AI配音、小豆-语音转文字、小豆配音相关接口前,需进入对应产品控制台,完成实名认证与人脸认证,阅读《用户协议》后勾选同意,点击「立即开通」。服务开通成功后,您将获得对应产品的免费调用额度,可在资源包管理页领取;也可在产品购买页购买资源包,若免费额度与资源包调用次数耗尽,接口计费将自动转为后付费方式按日结算,具体计费标准可查看对应购买指南。
调试API接口
服务开通后,进入对应产品的 API 3.0 Explorer 在线接口调试页面,选择需调用的接口并填写输入参数,参数具体含义可在界面「文档说明」选项卡查看。
注意
在线调用模块发起请求时,平台会通过已登录用户信息获取当前账号临时 Access Keys 进行操作;该操作属敏感操作,需先完成身份验证确认是本人操作,操作等同于真实请求,建议仔细阅读购买指南了解费用详情,谨慎操作!
填写输入参数后,切换至「代码示例」选项卡,可自动生成支持 Java、Python、Node.js、PHP、GO、.NET、C++ 语言的代码;若需调整传入参数,可在左侧修改参数值后重新生成代码。
切换至「在线调用」选项卡,点击「发送请求」即可发起真实调试请求,供测试参考。
集成SDK
确认本地依赖环境满足以下条件:
| 产品名称 | 编程环境 | SDK 集成要求 |
|---|---|---|
| 语音AI配音 | Node.js | 需要 NODEJS 10.0.0 版本及以上 |
| 小豆-语音转文字 | Python | 需要 Python 2.7、3.6至3.9 版本 |
| 小豆配音 | Java | 需要 JDK 7 版本及以上 |
| 通用Go支持 | Go | 需要 Go 1.9 版本及以上(使用 go mod 需 Go 1.14) |
| 通用.NET支持 | .Net | 需要 .NET Framework 4.5+ 或者 .NET Core 2.1 |
| 通用PHP支持 | PHP | 需要 PHP 5.6.0 版本及以上 |
| 通用C++支持 | C++ | 需要 C++ 11 或更高版本的编译器 GCC 4.8 或以上,仅支持 Linux 环境 |
| 通用Ruby支持 | Ruby | 需要 Ruby 2.3 及以上版本 |
安装与本地依赖环境对应的 SDK,以下以 Node.js 为例说明安装与使用方法:
通过 npm 安装(推荐)
通过 npm 获取安装是使用 Node.js SDK 的推荐方式,npm 为 Node.js 的包管理工具,可参考 npm 官网了解详情。
- 执行安装命令:
npm install voice-ai-tools –save
- 在项目代码中引用对应模块,可参考示例。
- 若引用全量SDK会下载所有产品SDK,可替换为对应产品的SDK包,如将
voice-ai-tools改为voice-ai-dubbing-sdk,对应引用代码从require("voice-ai-tools")改为require("voice-ai-dubbing-sdk"),其余不变,可大幅节省存储空间。
通过源码包安装
- 下载对应产品的源码包至本地项目合适位置。
- 解压源码包后,在项目代码中引用对应模块,可参考示例。
示例
以 Node.js 为例,语音AI配音的简易调用 demo 如下:
const audioTool = require("voice-ai-dubbing-sdk");
// 导入对应产品模块的客户端
const DubbingClient = audioTool.speech.v2023.Client;
// 客户端配置信息
const clientConfig = {
credential: {
secretId: "yoursecretid",
secretKey: "yoursecretkey",
},
region: "ap-shanghai",
profile: {
httpProfile: {
endpoint: "ai-dubbing.example.com",
},
},
};
// 实例化客户端
const client = new DubbingClient(clientConfig);
// 构造请求参数
const params = {
"Text": "欢迎使用语音AI配音服务",
"AudioMark": "demo_001",
"VoiceModel": "standard_01"
};
// 发起调用
client.GenerateAudio(params).then(
(data) => {
console.log("生成音频结果:", JSON.stringify(data));
},
(err) => {
console.error("接口调用出错:", err.message);
}
);
TypeScript项目中的调用方式:
import * as audioTool from "voice-ai-dubbing-sdk";
const DubbingClient = audioTool.speech.v2023.Client;
const clientConfig = {
credential: {
secretId: "yoursecretid",
secretKey: "yoursecretkey",
},
region: "ap-shanghai",
profile: {
httpProfile: {
endpoint: "ai-dubbing.example.com",
},
},
};
const client = new DubbingClient(clientConfig);
const params = {
"Text": "欢迎使用语音AI配音服务",
"AudioMark": "demo_001",
"VoiceModel": "standard_01"
};
client.GenerateAudio(params).then(
(data) => console.log(data),
(err) => console.error(err)
);
客户端配置详情可参考对应产品的开发文档。
发布者:云, 赵,出处:https://www.qishijinka.com/software-testing/64414/