語(yǔ)音翻譯 API 簡(jiǎn)介

概念解釋

語(yǔ)音翻譯：將一段源語(yǔ)言音頻文件轉(zhuǎn)換成目標(biāo)語(yǔ)言文本/語(yǔ)音，大大減輕傳統(tǒng)文本翻譯的讀寫成本，翻譯更輕松

說(shuō)明

Hi，您好，歡迎使用有道智云語(yǔ)音翻譯API接口服務(wù)。

本文檔主要針對(duì)需要集成HTTP API的技術(shù)開發(fā)工程師，詳細(xì)描述語(yǔ)音翻譯能力相關(guān)的技術(shù)內(nèi)容。

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

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

如果您對(duì)文檔內(nèi)容有任何疑問(wèn)，可以通過(guò)以下幾種方式聯(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)用密鑰；如果您還沒(méi)有，請(qǐng)按照新手指南獲取。
• 平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見(jiàn) 語(yǔ)音翻譯服務(wù)報(bào)價(jià) 。

接口說(shuō)明

語(yǔ)音翻譯API接口提供有道的語(yǔ)音翻譯服務(wù)，包含了中文和其他有道自有語(yǔ)種的互譯功能。您只需要通過(guò)調(diào)用有道語(yǔ)音翻譯API，傳入待翻譯的音頻文件，并指定要翻譯的源語(yǔ)言（支持源語(yǔ)言語(yǔ)種自動(dòng)檢測(cè)）和目標(biāo)語(yǔ)言種類，以POST方式請(qǐng)求就可以得到相應(yīng)的翻譯結(jié)果。

有道語(yǔ)音翻譯API HTTPS地址：

https://openapi.youdao.com/speechtransapi

注：上傳的語(yǔ)音文件時(shí)長(zhǎng)不能超過(guò)15s，文件大小不能超過(guò)2M。

協(xié)議須知

調(diào)用方在集成語(yǔ)音翻譯API時(shí)，請(qǐng)遵循以下規(guī)則。

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

調(diào)用API需要向接口發(fā)送以下字段來(lái)訪問(wèn)服務(wù)。

簽名生成方法如下： signType=v3； sign=sha256(應(yīng)用ID+input+salt+curtime+應(yīng)用密鑰)； 其中，input的計(jì)算方式為：input=q前10個(gè)字符 + q長(zhǎng)度 + q后10個(gè)字符（當(dāng)q長(zhǎng)度大于20）或 input=q字符串（當(dāng)q長(zhǎng)度小于等于20）；

注意:

1. 請(qǐng)先將需要識(shí)別的音頻文件轉(zhuǎn)換為 Base64 編碼。
2. 在發(fā)送HTTP請(qǐng)求之前需要對(duì)各字段做 URL encode。
3. 在生成簽名拼接 應(yīng)用ID+q+salt+應(yīng)用密鑰 字符串時(shí)，q 不需要做 URL encode，在生成簽名之后，發(fā)送 HTTP 請(qǐng)求之前才需要對(duì)要發(fā)送的 q 做URL encode。
4. 簽名和請(qǐng)求有疑問(wèn)，可以參考文檔最后的常用語(yǔ)言demo。

輸出結(jié)果

返回的結(jié)果是json格式，包含字段與FROM和TO的值有關(guān)，具體說(shuō)明如下：

示例

使用good單詞查詢作為示例進(jìn)行說(shuō)明：

發(fā)送請(qǐng)求，調(diào)用接口：

{
    "q":"xxx",    //xxx為音頻的base64編碼
    "salt":123,
    "docType":"json",
    "format":"wav",
    "channel":1,
    "sign":"ACE8373C54C82A9C793A480B55138F3E",
    "type":1,
    "version":"v1",
    "rate":16000,
    "signType":"v1",
    "appKey":"test",
    "from":"zh-CHS",
    "to":"en"
}

輸出結(jié)果與FROM和TO的值有關(guān)：

如果源語(yǔ)言和目標(biāo)語(yǔ)言一致，直接返回識(shí)別結(jié)果。

若不一致，按如下格式返回如下結(jié)果：

{
    "tSpeakUrl": "https://openapi.youdao.com/ttsapi?q=北京科技館&langType=en&sign=40133A29285AD7F85D62DC9EBFE36955&salt=1512458805233&appKey=apiTest",    //翻譯結(jié)果發(fā)音地址，翻譯成功一定存在
    "query": "北京科技館",    //識(shí)別結(jié)果，翻譯成功一定存在
    "translation": [
        "Beijing science and technology museum"
    ],    //翻譯結(jié)果
    "errorCode": "0",    //錯(cuò)誤碼。一定存在
    "dict": {
        "url": "yddict://m.youdao.com/dict?le=eng&q=%E5%8C%97%E4%BA%AC%E7%A7%91%E6%8A%80%E9%A6%86"
    },    //詞典deeplink
    "webdict": {
        "url": "http://m.youdao.com/dict?le=eng&q=%E5%8C%97%E4%BA%AC%E7%A7%91%E6%8A%80%E9%A6%86"
    },    //webdict deeplink
    "speakUrl": "https://openapi.youdao.com/ttsapi?q=%E5%8C%97%E4%BA%AC%E7%A7%91%E6%8A%80%E9%A6%86&langType=zh-CHS&sign=25FA4EFF0F453867B8D5EAD9C0EF5D07&salt=1512458805232&appKey=zhudytest123"    //源語(yǔ)言發(fā)音地址
}

支持語(yǔ)言

注意

1. 越南語(yǔ)和印尼語(yǔ)目前只支持和中文的互譯。
2. 支持自動(dòng)識(shí)別的語(yǔ)種包括：中文、英文。
3. 若列表語(yǔ)言出現(xiàn)不支持的問(wèn)題，請(qǐng)參考產(chǎn)品定價(jià)列表語(yǔ)種互譯的限制

語(yǔ)音支持

格式支持：wav格式 / mp3格式（不壓縮、pcm編碼）。

采樣率：推薦16k。

編碼：16bit位深的單聲道

服務(wù)配置

錯(cuò)誤代碼列表

音頻切換

本部分描述如何把其他格式的音頻轉(zhuǎn)成符合語(yǔ)音識(shí)別輸入要求的格式文件。

語(yǔ)音識(shí)別底層使用的是wav格式，因此推薦使用wav格式音頻。音頻格式轉(zhuǎn)換推薦使用ffmpeg。

PCM文件音頻介紹

pcm保存的是未壓縮的音頻信息,沒(méi)有頭文件

16bits編碼是指每次采樣信息用2個(gè)字節(jié)保存。

16000采樣率，是指1秒采樣16000次，常見(jiàn)的音頻是44100HZ，即一秒采樣44100次。

單聲道： 只有一個(gè)聲道。

根據(jù)這些信息，可以得出：

1ms的16采樣率音頻文件大小是 2*16 = 32字節(jié) 。

1ms的8采樣率音頻文件大小是 2*8 = 16字節(jié)，由此即可得到音頻的長(zhǎng)度。

ffmpeg簡(jiǎn)介

ffmpeg是一個(gè)自由軟件，可以運(yùn)行音頻、視頻多種格式的錄影、轉(zhuǎn)換、流功能，包含libavcodec--這是一個(gè)用于多個(gè)項(xiàng)目中的音頻、視頻的解碼器庫(kù)，以及l(fā)ibavformat--一個(gè)音頻和視頻格式轉(zhuǎn)換庫(kù)。

ffmpeg官網(wǎng)：https://www.ffmpeg.org/

ffmpeg的github地址：https://github.com/FFmpeg/FFmpeg

ffmpeg編譯參數(shù)

ffmpeg默認(rèn)支持pcm和wav（pcm編碼）格式，額外的編譯參數(shù)如下：

—enable-libopencore-amrnb 支持amr-nb(8000 采樣率) 讀寫

—enable-libopencore-amrwb 支持amr-wb(16000 采樣率) 讀取

—enable-libvo-amrwbenc 支持amr-wb(16000 采樣率) 寫入

—enable-libmp3lame 支持mp3 寫入

ffmpeg -codecs 可以查看所有的格式：

    D..... = Decoding supported  # 讀取
    .E.... = Encoding supported  # 寫入
    ..A... = Audio codec      # 音頻編碼
    ....L. = Lossy compression # 有損
    .....S = Lossless compression # 無(wú)損
    DEA..S pcm_s16le    PCM signed 16-bit little-endian
    DEA.LS wavpack      WavPack
    DEA.L. mp3          MP3 (MPEG audio layer 3)
    DEA.L. amr_nb       AMR-NB (Adaptive Multi-Rate NarrowBand)
    DEA.L. amr_wb       AMR-WB (Adaptive Multi-Rate WideBand)

主要參數(shù)

-i 設(shè)定輸入流

-f 設(shè)定格式

-ss 開始時(shí)間

wav、mp3、amr格式都自帶頭部，包含采樣率、編碼、多聲道等信息。而pcm為原始音頻信息，沒(méi)有頭部信息。wav（pcm編碼）就是pcm文件加了wav的頭部信息。

輸入wav、mp3、amr：

-i audio.wav/audio.mp3/audio.amr

輸入pcm格式：pcm需要額外告知編碼格式，采樣率，單聲道信息

-f s16le -ac 1 -ar 16000 -i 16k.pcm //單聲道、16000采樣率、16bits編碼的pcm文件

音頻參數(shù)

-ar 設(shè)定采樣率

-ac 設(shè)定聲音的channel數(shù)

-acodec 設(shè)定聲音編解碼器，未設(shè)定時(shí)則使用與輸入流相同的編解碼器

-an 不處理音頻

-ab 設(shè)置比特率（單位：bit/s,也許老版是kb/s），前面ac設(shè)置為立體聲時(shí)要以一半的比特率來(lái)設(shè)置，比如192kbps的就設(shè)置為96，轉(zhuǎn)換默認(rèn)比特率都較小，要聽(tīng)到高品質(zhì)聲音的話建議設(shè)到160kbps（80）以上。

在原始采樣率 大于或者接近16000的時(shí)候，推薦使用16000,8000采樣率會(huì)降低識(shí)別效果。

輸出wav和amr時(shí)，如果沒(méi)有指定聲音編解碼器，則會(huì)選擇默認(rèn)的編碼器。

輸出pcm：

-f s16le -ac 1 -ar 16000 16k.pcm // 單聲道 16000 采樣率 16bits編碼 pcm文件

輸出wav：

-ar 1 -ar 16000 16k.wav //單聲道 16000 采樣率 16bits編碼 pcm編碼的wav文件

amr-nb:全稱是：Adaptive Multi-Rate，自適應(yīng)多速率，是一種音頻編碼文件格式，專用于有效地壓縮語(yǔ)音頻率。amr-nb格式只能選 8000采樣率。bit rates越高音質(zhì)越好，但是文件越大

bit rates 4.75k, 5.15k, 5.9k, 6.7k, 7.4k, 7.95k, 10.2k or 12.2k

輸出 amr-wb 格式，采樣率 16000。 bit rates越高音質(zhì)越好，但是文件越大。

6600 8850 12650 14250 15850 18250 19850 23050 23850

常用參數(shù)

-y 覆蓋同名文件

-v 日志輸出 基本如-v ERROR -v quiet等

轉(zhuǎn)換命令示例

ffmpeg {常用參數(shù)} {輸入音頻參數(shù)} {輸出音頻參數(shù)}

• wav 文件轉(zhuǎn) 16k 16bits 位深的單聲道pcm文件

ffmpeg -y -i 16k.wav -acodec pcm_s16le -f s16le -ac 1 -ar 16000 16k.pcm

• pcm文件轉(zhuǎn)wav：

ffmpeg -y -f s16le -ar 16000 -ac 1 -acodec pcm_s16le 16k.pcm 16k.wav

• m4a文件轉(zhuǎn)16k 16bits 位深的單聲道pcm文件

D:\ffmpeg\bin>ffmpeg -y -i test.m4a -acodec pcm_s16le -f s16le -ac 1 -ar 16000 16k.pcm

常用語(yǔ)言 Demo

Java 示例

語(yǔ)音翻譯 Java demo

Python3 示例

語(yǔ)音翻譯 python demo

C#示例

語(yǔ)音翻譯 c# demo

PHP 示例

語(yǔ)音翻譯 php demo

go 示例

語(yǔ)音翻譯 go demo