自然語言翻譯服務(wù)
大模型翻譯 文本翻譯 圖片翻譯 語音翻譯 實時語音翻譯 文檔翻譯(開發(fā)版) 網(wǎng)頁翻譯視覺智能服務(wù)
通用文字識別 手寫體文字識別 表格識別 整題識別（含公式） PDF轉(zhuǎn)WORD 自定義模板文字識別 圖像處理 圖像算法 實況OCR智能語音服務(wù)
語音合成 短語音識別 長語音轉(zhuǎn)寫 實時語音識別 語音評測 語音助手智慧學(xué)習(xí)服務(wù)
英語作文批改 中文作文批改 題目識別切分 試卷手寫體擦除 精品題庫 學(xué)業(yè)大數(shù)據(jù)平臺 漢字拼音標(biāo)注 英文文本潤色 小P老師
Hi，您好，歡迎使用有道智云個性化語音調(diào)用接口服務(wù)。
本文檔主要針對需要集成HTTP API的技術(shù)開發(fā)工程師，詳細(xì)描述個性化語音調(diào)用相關(guān)的技術(shù)內(nèi)容。
如果您有與我們商務(wù)合作的需求，可以通過以下方式聯(lián)系我們：
商務(wù)郵箱： AIcloud_Business@corp.youdao.com
如果您對文檔內(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
溫馨提示：
個性化語音調(diào)用服務(wù)，用戶可迅速使用自己定制的語音合成服務(wù)。
服務(wù)主要分模型定制和模型調(diào)用兩部分。
調(diào)用方在集成個性化語音調(diào)用服務(wù)API時，請遵循以下規(guī)則。
| 規(guī)則 | 描述 |
|---|---|
| 傳輸方式 | HTTPS |
| 請求方式 | GET或POST |
| 字符編碼 | 統(tǒng)一使用UTF-8 編碼 |
| 請求格式 | 表單 |
| 響應(yīng)格式 | JSON |
個性化語音定制調(diào)用地址：
https://openapi.youdao.com
模型訓(xùn)練成功以后，如果要合成的內(nèi)容為文本，調(diào)用此接口。
| 參數(shù)名稱 | 類型 | 含義 | 是否必填 | 示例 |
|---|---|---|---|---|
| appKey | String | 應(yīng)用ID | True | 可在 應(yīng)用管理 查看 |
| salt | String | UUID（唯一識別通用碼） | True | UUID |
| curtime | String | 時間戳（秒） | True | 秒 |
| sign | String | 簽名 | True | sha256(應(yīng)用ID+salt+curtime+應(yīng)用密鑰) |
| signType | String | 簽名版本 | False | v4 (目前僅支持v4) |
| version | String | 接口版本 | False | v1 (目前僅支持v1) |
| docType | String | 服務(wù)器響應(yīng)類型 | False | json (目前僅支持json) |
| modelId | String | 模型ID | True | M_CC164FF7040141CD88C96B59B90EC695 |
| q | String | 待合成的文本 （必須是UTF-8編碼，長度不超過1000字符，需要進(jìn)行urlencode編碼） | True | 比如："您好" |
| format | String | 音頻格式(支持mp3,wav格式，默認(rèn)mp3) | True | mp3或wav |
| rate | String | 合成音頻采樣率(支持8000, 16000, 44100。默認(rèn)44100) | True | 16000 |
| speed | String | 語速（取值：0.5-2.0，默認(rèn)1.0） | True | 1.0 |
| volume | String | 音量 （取值： 0.5-5.0，默認(rèn)1.0） | True | 0.5 |
需要根據(jù)Content-Type的值確定是否合成成功：
如果合成成功，正常返回為二進(jìn)制語音文件，具體的header信息 Content-Type:audio/x-wav
如果合成失敗，會返回json結(jié)果，具體的header信息 Content-Type:application/json, 可以根據(jù)（模型錯誤碼）確定出現(xiàn)的問題。
模型訓(xùn)練成功以后，如果要合成的內(nèi)容為文本，調(diào)用此接口。
| 參數(shù)名稱 | 類型 | 含義 | 是否必填 | 示例 |
|---|---|---|---|---|
| appKey | String | 應(yīng)用ID | True | 可在 應(yīng)用管理 查看 |
| salt | String | UUID（唯一識別通用碼） | True | UUID |
| curtime | String | 時間戳（秒） | True | 秒 |
| sign | String | 簽名 | True | sha256(應(yīng)用ID+salt+curtime+應(yīng)用密鑰) |
| signType | String | 簽名版本 | False | v4 (目前僅支持v4) |
| version | String | 接口版本 | False | v1 (目前僅支持v1) |
| docType | String | 服務(wù)器響應(yīng)類型 | False | json (目前僅支持json) |
| modelId | String | 模型ID | True | M_CC164FF7040141CD88C96B59B90EC695 |
| file | MultipartFile | 待合成的音頻文件 (2秒-120秒) | True | 音頻文件 |
需要根據(jù)Content-Type的值確定是否合成成功：
如果合成成功，正常返回為二進(jìn)制語音文件，具體的header信息 Content-Type:audio/x-wav
如果合成失敗，會返回json結(jié)果，具體的header信息 Content-Type:application/json, 可以根據(jù)（合成錯誤碼）確定出現(xiàn)的問題。
| 類型 | 類型描述 |
|---|---|
| vc | 語音轉(zhuǎn)語音,輸入音頻,輸出定制化音色音頻 |
| tts | 文本轉(zhuǎn)語音,輸入文本,輸出定制化音色音頻 |
| 輸出格式 | 單次最大請求字符數(shù) | 單次最大請求時長 | 支持語言 |
|---|---|---|---|
| wav | 1000 | 2s - 2min | 中文 |
| 錯誤碼 | 錯誤碼含義 |
|---|---|
| 101 | 缺少必填的參數(shù)，首先確保必填參數(shù)齊全，然后，確認(rèn)參數(shù)書寫是否正確。 |
| 102 | 不支持的語言類型 |
| 103 | 翻譯文本過長 |
| 104 | 不支持的API類型 |
| 105 | 不支持的簽名類型 |
| 106 | 不支持的響應(yīng)類型 |
| 107 | 不支持的傳輸加密類型 |
| 108 | 應(yīng)用ID無效，注冊賬號，登錄后臺創(chuàng)建應(yīng)用和實例并完成綁定，可獲得應(yīng)用ID和應(yīng)用密鑰等信息 |
| 109 | batchLog格式不正確 |
| 110 | 無相關(guān)服務(wù)的有效實例，應(yīng)用沒有綁定服務(wù)。注：某些服務(wù)的結(jié)果發(fā)音需要tts服務(wù)，需要在控制臺創(chuàng)建語音合成實例綁定應(yīng)用后方能使用。 |
| 111 | 開發(fā)者賬號無效 |
| 112 | 請求服務(wù)無效 |
| 113 | q不能為空 |
| 114 | 不支持的圖片傳輸方式 |
| 115 | 語音包異常：不存在或者已刪除或者不屬于當(dāng)前devId |
| 116 | modelId 無效 |
| 201 | 解密失敗，可能為DES,BASE64,URLDecode的錯誤 |
| 202 | 簽名檢驗失敗 |
| 203 | 訪問IP地址不在可訪問IP列表 |
| 205 | 請求的接口與應(yīng)用的平臺類型不一致，確保接入方式（Android SDK、IOS SDK、API）與創(chuàng)建的應(yīng)用平臺類型一致。 |
| 206 | 因為時間戳無效導(dǎo)致簽名校驗失敗 |
| 207 | 重放請求 |
| 303 | 服務(wù)端的其它異常 |
| 401 | 賬戶已經(jīng)欠費停 |
| 402 | offlinesdk不可用 |
| 403 | 無權(quán)限 |
| 404 | 資源不存在 |
| 405 | auth服務(wù)不可用 |
| 117 | 鑒權(quán)失敗 |
| 110 | 無相關(guān)服務(wù)的有效實例 |
| 303 | 服務(wù)端異常 |
| 2004 | 合成字符過大 |
| 2301 | 合成失敗 |
| 2302 | 合成次數(shù)不足 |
| 2303 | 文件不能為空 |
| 2304 | 文件錯誤 |
| 2305 | 文件格式錯誤 |
| 2306 | modelId 無效 |
| 2307 | packetId 無效 |
| 2308 | 文件大小錯誤 |
