【摘要】 基于 CodeArts API 設計語音合成接口，基于 API Explorer 調試接口，并利用 CodeArts IDE 實現數據流轉換為音頻

案例簡介

開發者將在云主機中，基于 CodeArts API 設計語音合成接口，基于 API Explorer 調試接口，并利用 CodeArts IDE 實現數據流轉換為音頻。在此過程中，開發者可體驗 API 設計、開發、調試等全生命周期，對華為云產品 API 體系及 API 開放能力有全面了解，并最終完成應用創建，全程實踐約 15 分鐘。

配置開發者空間

華為云為全球開發者打造專屬開發者空間，匯聚了華為優質開發資源及工具，讓每一位開發者擁有一臺云主機。

在華為開發者空間，每位開發者每年可享有數百小時的云主機使用時長，5GB 的云存儲空間和場景化沙箱資源，以及海量的技術賦能課程與專業開發者認證內容。

點此領取：https://auth.huaweicloud.com/authui/login.html?service=https%3A%2F%2Fdeveloper.huaweicloud.com%2Fspace%2Flogin-forword.html%3FforwardUrl%3Dhttps%253A%252F%252Fdeveloper.huaweicloud.com%252Fspace%252Fhome%26module%3Dhuaweideveloper&locale=zh-cn#/login

1.進入開發者空間，點擊“云主機（beta 體驗）”

2.點擊“添加云主機”

3.點擊“立即進入”

4.點擊“下一步”

5.繼續點擊“下一步”

6.點擊“進入桌面”

7.等待機器準備進度條加載完成至 100%，預計等待 1 分鐘，然后點擊“打開云桌面”即可使用

通過 CodeArts API 設計語音合成接口

3.1 進入 CodeArts API 官網，打開左邊工具欄-Firefox 網絡瀏覽器，輸入網頁版體驗地址并登錄

https://developer.huaweicloud.com/develop/codeartsapi.html

3.2 創建項目

3.2.1 登錄后點擊頁面右上角的“創建項目”按鈕

3.2.2 在創建項目彈窗中輸入項目名稱：語音合成，并點擊保存

3.2.3 提示保存成功，點擊 API 設計頁簽，進入到 API 設計頁面

3.3 設計接口

3.3.1 點擊頁面上的“新建 API 接口”卡片

3.3.2 顯示新建標簽頁

3.3.3輸入接口的 URL：/tts

3.3.4輸入接口名稱：語音合成

3.3.5下拉滾動條到請求參數區域，點擊請求體“Body”頁簽，選擇“raw”，默認選擇“JSON”格式。

3.3.6顯示請求體的數據結構模板，默認根節點類型為“object”

3.3.7點擊根節點最右側的“+”操作

3.3.8頁面上在根節點下新增一條參數（可以通過滾動條左右拖動）

3.3.9將參數名 param2 修改為 text，描述 param2 修改為待合成的文本

3.3.10 下拉頁面，看到返回響應區域

3.3.11 同樣點擊根節點最右側的“+”操作（可以通過滾動條拖動到最右側），在根節點下顯示一條新的參數

3.3.12 將參數名 param2 修改為result，將描述修改為合成結果

3.3.13 點擊右上角的保存按鈕

3.3.14 保存成功，設計完成

通過 API Explorer 調試語音合成接口，生成 5 段數據流

4.1 語音合成（API Explorer 部分）：

鏈接：https://console.huaweicloud.com/apiexplorer/#/openapi/SIS/debug?api=RunTts

4.1.1 生成語音格式為 wav，采樣率：8000，標準女音，語速 0，音色 0

圖 1.1.1wav 標準女音

4.1.2 生成語音格式為 wav，采樣率：16000，標準男聲，語速 0，音色 0

圖 1..12wav 標準男音

4.1.3 生成語音格式為 mp3，采樣率：8000，標準女音，語速 100，音色 100

圖 1.1.3 mp3 標準女音

4.1.4 生成語音格式為 mp3，采樣率：16000，標準男聲，語速 100，音色 100

圖 1.1.4 mp3 標準男聲

4.1.5 生成語音格式為 pcm，采樣率：16000，標準男聲，語速 100，音色 100

圖 1.1.5標準男聲

在開發者空間基于華為云自研 CodeArts IDE，實現數據流轉換為音頻的功能

5.1 實現數據流轉換為音頻

5.1.1 將實驗用 Demo 工程上傳到 CodeArts IDE

打開右側工具欄-Firefox 網絡瀏覽器，輸入并訪問 Demo 工程下載鏈接：

https://sandbox-expriment-files.obs.cn-north-1.myhuaweicloud.com/2601/CodeArtsProject.zip

對下載好的文件進行解壓（目錄：主文件夾/下載），右鍵提取到此處

打開 CodeArts IDE，左上角點擊“工程”->“打開工程”，選擇剛剛解壓出來的文件夾，打開：

預計等待 1 分鐘左右的時間，工程模型同步成功：

5.1.2 在華為云控制臺新增訪問秘鑰，配置 AK/SK

1）登錄華為云控制臺：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）

2）進入工程，src/main/resources 下選擇 credentials.properties，將 AK/SK 配置上

5.1.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 中。

5.1.4 配置 pom.xml：

在 pom.xml 中如圖所示，增加如下配置：

17

17

17

5.1.5 執行“should_return_audio_when_response_json”，生成 mps 格式音頻文件：

找到 test 目錄下的測試類 SisServiceTest.java，點擊找到方法“should_return_audio_when_response_json（）”，點擊執行測試，最后可以看到目錄下生成的音頻文件。

目錄下生成“devkit.mps”文件，實驗結束。

審核編輯 黃宇