企业数字化转型的过程中,API发挥着至关重要的作用。随着企业业务规模的扩大和系统复杂性的增加,如何管理好API将成为企业面临的关键挑战。
为了应对这一迫切需求,一个全面覆盖API全生命周期管理的得力工具显得尤为重要,它能够显著帮助企业提升API的研发与管理效率,华为云CodeArts API正是这样一位助力企业数字化转型的好帮手。
01
案例简介
开发者将在云主机中,基于CodeArts API设计语音合成接口,基于API Explorer调试接口,并利用CodeArts IDE实现数据流转换为音频。
在此过程中,开发者可体验API设计、开发、调试等全生命周期,对华为云产品API体系及API开放能力有全面了解,并最终完成应用创建,全程实践约15分钟。
02
配置开发者空间
免费领取开发者空间
华为云为全球开发者打造专属开发者空间,汇聚了华为优质开发资源及工具,让每一位开发者拥有一台云主机。
在华为开发者空间,每位开发者每年可享有数百小时的云主机使用时长,5GB的云存储空间和场景化沙箱资源,以及海量的技术赋能课程与专业开发者认证内容。
点击文末“阅读原文”即可领取。
进入开发者空间点击云主机(beta体验)
点击“添加云主机”
点击“立即进入”
点击“下一步”
继续点击“下一步”
点击“进入桌面”
等待机器准备进度条加载完成,点击“打开云桌面”即可使用
03
CodeArts API设计语音合成接口
进入CodeArts API官网
进入CodeArts API官网:https://developer.huaweicloud.com/develop/codeartsapi.html
打开左边工具栏-Firefox网络浏览器,输入网页版体验地址并登录
创建项目
1.登录后点击页面右上角的“创建项目”按钮。
2.在创建项目弹窗中输入项目名称:语音合成,并点击保存
3.提示保存成功,点击API设计页签,进入到API设计页面
设计接口
1.点击页面上的“新建API接口”卡片
2.显示新建标签页
3.输入接口的URL:/tts
4.输入接口名称:语音合成
5.下拉滚动条到请求参数区域,点击请求体“Body”页签,选择“raw”,默认选择“JSON”格式。
6.显示请求体的数据结构模板,默认根节点类型为“object”。
7.点击根节点最右侧的“+”操作
8.页面上在根节点下新增一条参数(可以通过滚动条左右拖动)。
9.将参数名param2修改为text,描述param2修改为待合成的文本。
10.下拉页面,看到返回响应区域。
11.同样点击根节点最右侧的“+”操作(可以通过滚动条拖动到最右侧),在根节点下显示一条新的参数
12.将参数名param2修改为result,将描述修改为合成结果。
13.点击右上角的保存按钮
14.保存成功,设计完成
04
API Explorer调试语音合成接口
语音合成(API Explorer部分)
1.进入API Explorer后台:https://console.huaweicloud.com/apiexplorer/#/openapi/SIS/debug?api=RunTts
生成语音格式为wav,采样率:8000,标准女音,语速0,音色0
2.生成语音格式为wav,采样率:16000,标准男声,语速0,音色0
3.生成语音格式为mp3,采样率:8000,标准女音,语速100,音色100
4.生成语音格式为mp3,采样率:16000,标准男声,语速100,音色100
5.生成语音格式为pcm,采样率:16000,标准男声,语速100,音色100
05
CodeArts IDE实现数据流转换为音频
实现数据流转换为音频
1.将实验用Demo工程上传到CodeArts IDE
打开右侧工具栏-Firefox网络浏览器,输入并访问Demo工程下载链接:
https://sandbox-expriment-files.obs.cn-north-1.myhuaweicloud.com/2601/CodeArtsProject.zip
对下载好的文件进行解压(目录:主文件夹/下载),右键提取到此处。
打开CodeArts IDE,左上角点击“工程”->“打开工程”,选择刚刚解压出来的文件夹,打开。预计等待1分钟左右的时间,工程模型同步成功。
2.在华为云控制台新增访问秘钥,配置AK/SK
登录华为云控制台:https://console.huaweicloud.com/iam/?agencyId=599e2ee1492f48e9b69a0a682d435fb8®ion=cn-north-4&locale=zh-cn#/mine/accessKey
选择“我的凭证”->“访问秘钥”->新增访问秘钥
注:如果已经有AK/SK秘钥,不需要新增访问秘钥
创建秘钥成功后点击“立即下载”,即可获得“credentials.csv”文件,里面可以查看到AK(Access Key Id)和SK(Secret Access Key)
进入工程,src/main/resources下选择credentials.properties,将AK/SK配置上
3.将API Explorer上调试成功的流数据文件配置到APIResponse.json中
在2.1语音合成章节,我们在API Explorer完成接口的调试
https://console.huaweicloud.com/apiexplorer/#/openapi/SIS/debug?api=RunTts
最终生成:“SIS_RunTts_ResponseBody_xxxxxxxxxxxxx.json”文件,打开json文件,复制响应体内容(如果响应体内容没有超出限制,直接点击右侧的复制按钮即可)
打开工程,进入src/main/resources中,选择APIResponse.json,将json文件的内容复制到APIResponse.json中。
4.配置pom.xml:
在pom.xml中如图所示,增加如下配置:
执行:“should_return_audio_when_response_json”,生成mps格式音频文件
找到test目录下的测试类SisServiceTest.java,点击找到方法“should_return_audio_when_response_json()”,点击执行测试,最后可以看到目录下生成的音频文件。
目录下生成“devkit.mps”文件,实验结束
戳“阅读原文”,免费领取开发者空间。

