個(gè)性化音色定制

說明

Hi，您好，歡迎使用有道智云個(gè)性化語音定制接口服務(wù)。

本文檔主要針對(duì)需要集成HTTP API的技術(shù)開發(fā)工程師，詳細(xì)描述個(gè)性化語音定制相關(guān)的技術(shù)內(nèi)容。

如果您有與我們商務(wù)合作的需求，可以通過以下方式聯(lián)系我們：

商務(wù)郵箱： AIcloud_Business@corp.youdao.com

如果您對(duì)文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(lián)系我們：

客服QQ：1906538062

智云翻譯技術(shù)交流QQ 1群: 652880659

智云翻譯技術(shù)交流QQ 2群: 669384425

智云翻譯技術(shù)交流QQ 3群: 807539209

智云翻譯技術(shù)交流QQ 4群: 936752411

聯(lián)系郵箱： zhiyun@corp.youdao.com

溫馨提示：

• 本文檔主要針對(duì)開發(fā)人員，接入測(cè)試前需要獲取應(yīng)用ID和應(yīng)用密鑰；如果您還沒有，請(qǐng)按照 新手指南 獲取。
• 平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用。

接口說明

個(gè)性化語音定制服務(wù)，基于網(wǎng)易有道的語音識(shí)別技術(shù)，通過上傳少量錄音，訓(xùn)練語音引擎定制自己聲音模型，賦予產(chǎn)品聲音形象，可在讀小說、播音主持、講故事、客服服務(wù)等場(chǎng)景應(yīng)用。 服務(wù)主要分模型定制和模型調(diào)用兩部分。

協(xié)議須知

調(diào)用方在集成個(gè)性化語音定制服務(wù)API時(shí)，請(qǐng)遵循以下規(guī)則。

接口調(diào)用參數(shù)

個(gè)性化語音定制調(diào)用地址：

https://openapi.youdao.com

音頻格式

格式支持：wav（不壓縮，pcm編碼，采樣率：推薦16k ，編碼：16bit位深的單聲道）

模型定制階段

創(chuàng)建語音包接口

• 接口uri：/customVoice/packet/create

• 請(qǐng)求方式：POST

• 接口說明：

  創(chuàng)建語音包接口，通過語音包收集錄音，定制個(gè)性化音色模型

  接口參數(shù)：

• 響應(yīng)結(jié)果

{
"errorCode":"0",//錯(cuò)誤碼
"msg":"success",//信息說明
"result":{
    "packetId":"P_24A59791123C49A9B498DCD1972803B3"//返回的語音包ID
  }
}

環(huán)境音檢測(cè)

• 接口uri：/customVoice/packet/measureNoise

• 請(qǐng)求方式：POST

• 接口說明：

  語音包錄音前可以進(jìn)行環(huán)境音檢測(cè)

• 接口參數(shù)：

• 響應(yīng)結(jié)果

{
    "errorCode":"0",//錯(cuò)誤碼
    "msg":"success",//信息說明
    "result":{
        "passTest":true, //是否通過檢測(cè)
        "decibel": 30  //分貝
            }
}

語音評(píng)測(cè)接口

• 接口uri：/customVoice/packet/evaluateRecording

• 請(qǐng)求方式：POST

• 接口說明：

  錄制語音，通過評(píng)測(cè)的音頻會(huì)賦予recordId并則錄入語音包

• 接口參數(shù)：

例子：

• 高定（quality=2）20句文案如下：

  小鴨子讓它坐在自己的背上，順利上了岸 小鴨子正在水里捉魚，忽然聽見小公雞喊救命 烏鴉把小石子放進(jìn)瓶子里，水漸漸升高 瓶子里水不多，瓶口又小，烏鴉喝不著水 一只烏鴉口渴了，到處找水喝 愛心的深層含義就是保護(hù)所有的動(dòng)植物 荷葉像個(gè)碧綠的大圓盤。荷花在它之間冒出來 要是碰上陰雨天，大樹也會(huì)來幫忙 北極星是盞指路燈，它永遠(yuǎn)高掛在北方 中午它在南邊，地上的樹影指向北方 桂樹還沒有開花，但風(fēng)中已經(jīng)飄來甜絲絲的香氣 老師穿著長袍，頭發(fā)胡子全白了，看上去很有學(xué)問 杭州昨日正式入夏，較常年略早，昨天陽光早早上崗 安靜的連一根針掉下來的聲音都聽得見 我低著頭走出書店，腳站得有些麻木，我卻渾身輕松 它小巧玲瓏，一雙透亮靈活的眼睛下面，長著一張又尖又長的嘴 當(dāng)蒲公英盛開的時(shí)候，這片草地就變成金色的了 那鮮艷的民族服裝，把學(xué)校打扮得更加絢麗多彩 人們佩服孔子和老子的學(xué)問，也敬重他們的品行 盡管它這樣機(jī)靈，還是難以逃脫翠鳥銳利的眼睛

• 響應(yīng)結(jié)果

{
"errorCode":"0",//錯(cuò)誤碼
"msg":"success",//信息說明
"result":{
    "recordingId":"V_7FFDF89DC01F40CFA8A478D7E3231WV9", //音頻合格，錄入語音包時(shí)有返回值
    "score": "99.03", //評(píng)測(cè)得分
    "guidance": , // 評(píng)測(cè)建議
    "correctMessage": [], // 錯(cuò)誤發(fā)音句中index
    "packetId": "P_3F9AB85F37CE497B9A1483848ACCF56C" //語音包ID
         }
}

啟動(dòng)訓(xùn)練

• 接口uri：/customVoice/model/launch

• 請(qǐng)求方式：POST

• 接口說明：

  啟動(dòng)訓(xùn)練,語音包中的錄音數(shù)量達(dá)標(biāo)后,可以啟動(dòng)訓(xùn)練定制語音合成模型

• 接口參數(shù)：

• 響應(yīng)結(jié)果

{
"errorCode":"0",//錯(cuò)誤碼
"msg":"success",//信息說明
"result": {	
    "estimateSeconds":10 //剩余時(shí)間 秒
        "modelList":[
          {
            "modelId":"M_A0852354A2ED4BB19DE759F1B80C6E37", //模型id 啟動(dòng)成功返回
            "createTime":"2023-04-23 13:59:43", // 創(chuàng)建時(shí)間 啟動(dòng)成功返回
            "taskId":"T_6381E68890C843488FD9569217EFA36A", // 訓(xùn)練任務(wù)id 啟動(dòng)成功返回
            "modelType":"vc", //模型類型
            "modelStatus":"started", //模型狀態(tài)（"started":訓(xùn)練啟動(dòng),"failed":啟動(dòng)失?。?            "failedReason":"" // 失敗原因 啟動(dòng)失敗返回
          }
                     ]
            }
}

查詢訓(xùn)練狀態(tài)

• 接口uri：/customVoice/model/checkStatus

• 請(qǐng)求方式：GET

• 接口說明： 查詢當(dāng)前訓(xùn)練任務(wù)狀態(tài)

• 接口參數(shù)：

• 響應(yīng)結(jié)果

{
"errorCode":"0",//錯(cuò)誤碼
"msg":"success",//信息說明
"result": {
    "taskId":"T_D2560E2DCF6E435EA7BEDD88AC88B9CC", // 訓(xùn)練任務(wù)id	
    "estimateSeconds":"10", //剩余時(shí)間 秒
    "packetId":"P_24A59791123C49A9B498DCD1972803B3",//語音包id
        "modelId":"M_A0852354A2ED4BB19DE759F1B80C6E37",//模型id
    "status":"1" //訓(xùn)練狀態(tài) 0:開始,1:完成,2:終止,3:失敗,4:語音包創(chuàng)建
            }
}

刪除語音包

• 接口uri：/customVoice/packet/delete

• 請(qǐng)求方式：POST

• 接口說明： 刪除指定語音包，同時(shí)會(huì)刪除包含錄音及訓(xùn)練模型

• 接口參數(shù)：

• 響應(yīng)結(jié)果

{
"errorCode":"0",//錯(cuò)誤碼
"msg":"success",//信息說明
"result": null
}

查詢語音包詳情

• 接口uri：/customVoice/packet/detail

• 請(qǐng)求方式：GET

• 接口說明： 查詢所有創(chuàng)建的語音包基本信息

• 接口參數(shù)：

• 響應(yīng)結(jié)果

{
"errorCode":"0",//錯(cuò)誤碼
"msg":"success",//信息說明
"result": {
    "name":"名稱", // 語音包名稱	
    "description":"描述", //語音包描述
    "recordingCount":5, //包含錄音數(shù)
    "createTime":"2022-08-22 14:33:10", //語音包創(chuàng)建時(shí)間
        "packetId":"", // 語音包id
    "voiceList":[
        {
            "order":1, //錄音序號(hào)
            "audioUrl":"", //音頻鏈接
            "text":"", //評(píng)測(cè)文本
        },
        ...
                ]
          }
}

服務(wù)配置

訓(xùn)練任務(wù)狀態(tài)碼

訓(xùn)練錯(cuò)誤代碼