短音频识别（一句话识别）接口设计方案

 

短音频识别（一句话识别）接口设计方案

 

功能介绍

用于短语音的同步识别。一次性上传整个音频，响应中即返回识别结果。

URI

POST /v1/asr/short-audio

请求头

参数名称	类型	必须	说明
PACKAGE-NAME	string	是	包名
PACKAGE-SIGN	string	是	签名
API-KEY	string	是	根据包名生成的key
APP-KEY	string	是	app_key平台分配

 

请求示例：

{ "app_key": "10025"     "config": {         "encoding": "LINEAR16",         "sampleRateHertz": 16000,         "languageCode": "en-US",     },     "data": "/+MgxAAUeHpMAUkQAANhuRAC...", "timestamp": 1231234213,     "nonce": "acbf"     "sig":"feafefaefaefef" }

 

响应示例：

{ "code":"SIS.0001", "result":{ "text": "欢迎使用语音云服务。", "score": 0.9 }, "message":"***" }

 

请求消息

参数名	是否必选	参数类型	说明
app_key	是	String	app_key平台分配
config	是	Object	配置信息，请参考表 config数据结构。
data	是	String	语音数据，Base64编码，要求Base64编码后大小不超过4M，音频时长不超过1分钟。
timestamp	是	Integer	时间戳（秒）当前时间戳，5分钟后过期
nonce	是	String	随机字符串（4位）
sig	是	String	生成后的验证码

 

config数据结构

参数名	是否必选	参数类型	说明
encoding	是	String	支持语音的格式，请参考表encoding取值范围。
sampleRateHertz	是	Integer	采样率，参照encoding取值范围，并根据当前音频保存格式设置。
languageCode	是	String	包含所提供音频的语言和区域/语言区域以用于语音识别。语言代码必须是 BCP-47 标识符。 请参照支持语言列表。

采样率

您可以在请求配置的sampleRateHertz字段中指定音频的采样率，并且它必须与相关音频内容或音频流的采样率相一致。支持的采样率为 8000 Hz 到 48000 Hz。FLAC或WAV文件的采样率可以根据文件头而不是sampleRateHertz字段确定。

对源素材进行编码时，如果可以选择，请使用16000Hz 的采样率采集音频。低于此值可能损害语音识别的准确性，但更高的采样率对语音识别质量并没有明显影响。

但是，如果您的音频数据已经录制完毕，但并非采用16000Hz的采样率，请勿将音频重新采样为16000Hz。例如，大多数传统电话音频使用 8000 Hz 的采样率，这可能会产生不够准确的结果。但如果您必须使用此类音频，请将其以原生采样率提供给Speech API。

encoding取值范围

encoding取值	说明
FLAC	信息流要求使用 16 位或 24 位的位深。FLAC既是一种音频编解码器，也是一种音频文件格式。如需使用FLAC编码转录音频文件，您必须提供.FLAC格式的文件，该格式带有一个包含元数据的文件头。
LINEAR16	16 位线性脉冲编码调制 (PCM) 编码 支持含有LINEAR16的WAV文件。
MULAW	8 位 PCM 编码。 支持含有MULAW的WAV文件。
AMR	采样率必须为 8000 Hz
AMR_WB	采样率必须为 16000 Hz
OGG_OPUS	采样率必须为 8000 Hz、12000 Hz、16000 Hz、24000 Hz 或 48000 Hz 之一
SPEEX_WITH_HEADER_BYTE	采样率必须为 16000 Hz

响应消息

参数名	是否必选	参数类型	说明
code	否	String	1000表示成功 其他表示失败 错误信息提示
message	否	String	返回请求信息。
result	是	Object	调用成功表示识别结果。请参考表 result 数据结构。

 

result 数据结构

参数名	是否必选	参数类型	说明
text	是	String	调用成功表示识别出的内容。
score	是	Float	调用成功表示识别出的置信度，取值范围：0~1。

 

 

支持语言列表

语言	BCP-47
南非荷兰语（南非）	af-ZA
南非荷兰语（南非）	af-ZA
阿尔巴尼亚语（阿尔巴尼亚）	sq-AL
阿尔巴尼亚语（阿尔巴尼亚）	sq-AL
阿姆哈拉语（埃塞俄比亚）	am-ET
阿姆哈拉语（埃塞俄比亚）	am-ET
阿拉伯语（阿尔及利亚）	ar-DZ
阿拉伯语（阿尔及利亚）	ar-DZ
阿拉伯语（巴林）	ar-BH
阿拉伯语（巴林）	ar-BH
阿拉伯语（埃及）	ar-EG
阿拉伯语（埃及）	ar-EG
阿拉伯语（伊拉克）	ar-IQ
阿拉伯语（伊拉克）	ar-IQ
阿拉伯语（以色列）	ar-IL
阿拉伯语（以色列）	ar-IL
阿拉伯语（约旦）	ar-JO
阿拉伯语（约旦）	ar-JO
阿拉伯语（科威特）	ar-KW
阿拉伯语（科威特）	ar-KW
阿拉伯语（黎巴嫩）	ar-LB
阿拉伯语（黎巴嫩）	ar-LB
阿拉伯语（摩洛哥）	ar-MA
阿拉伯语（摩洛哥）	ar-MA
阿拉伯语（阿曼）	ar-OM
阿拉伯语（阿曼）	ar-OM
阿拉伯语（卡塔尔）	ar-QA
阿拉伯语（卡塔尔）	ar-QA
阿拉伯语（沙特阿拉伯）	ar-SA
阿拉伯语（沙特阿拉伯）	ar-SA
阿拉伯语（巴勒斯坦国）	ar-PS
阿拉伯语（巴勒斯坦国）	ar-PS
阿拉伯语（突尼斯）	ar-TN
阿拉伯语（突尼斯）	ar-TN
阿拉伯语（阿拉伯联合酋长国）	ar-AE
阿拉伯语（阿拉伯联合酋长国）	ar-AE
阿拉伯语（也门）	ar-YE
阿拉伯语（也门）	ar-YE
亚美尼亚语（亚美尼亚）	hy-AM
亚美尼亚语（亚美尼亚）	hy-AM
阿塞拜疆语（阿塞拜疆）	az-AZ
阿塞拜疆语（阿塞拜疆）	az-AZ
巴斯克语（西班牙）	eu-ES
巴斯克语（西班牙）	eu-ES
孟加拉语（孟加拉）	bn-BD
孟加拉语（孟加拉）	bn-BD
孟加拉语（印度）	bn-IN
孟加拉语（印度）	bn-IN
波斯尼亚语（波斯尼亚和黑塞哥维那）	bs-BA
波斯尼亚语（波斯尼亚和黑塞哥维那）	bs-BA
保加利亚语（保加利亚）	bg-BG
保加利亚语（保加利亚）	bg-BG
缅甸语（缅甸）	my-MM
缅甸语（缅甸）	my-MM
加泰罗尼亚语（西班牙）	ca-ES
加泰罗尼亚语（西班牙）	ca-ES
中文粤语（香港繁体）	yue-Hant-HK
中文粤语（香港繁体）	yue-Hant-HK
中文普通话（中国简体）	zh (cmn-Hans-CN)
中文普通话（中国简体）	zh (cmn-Hans-CN)
中文普通话（台湾繁体）	zh-TW (cmn-Hant-TW)
中文普通话（台湾繁体）	zh-TW (cmn-Hant-TW)
克罗地亚语（克罗地亚）	hr-HR
克罗地亚语（克罗地亚）	hr-HR
捷克语（捷克共和国）	cs-CZ
捷克语（捷克共和国）	cs-CZ
丹麦语（丹麦）	da-DK
丹麦语（丹麦）	da-DK
荷兰语（比利时）	nl-BE
荷兰语（比利时）	nl-BE
荷兰语（荷兰）	nl-NL
荷兰语（荷兰）	nl-NL
英语（澳大利亚）	en-AU
英语（澳大利亚）	en-AU
英语（加拿大）	en-CA
英语（加拿大）	en-CA
英语（加纳）	en-GH
英语（加纳）	en-GH
英语（香港）	en-HK
英语（香港）	en-HK
英语（印度）	en-IN
英语（印度）	en-IN
英语（爱尔兰）	en-IE
英语（爱尔兰）	en-IE
英语（肯尼亚）	en-KE
英语（肯尼亚）	en-KE
英语（新西兰）	en-NZ
英语（新西兰）	en-NZ
英语（尼日利亚）	en-NG
英语（尼日利亚）	en-NG
英语（巴基斯坦）	en-PK
英语（巴基斯坦）	en-PK
英语（菲律宾）	en-PH
英语（菲律宾）	en-PH
英语（新加坡）	en-SG
英语（新加坡）	en-SG
英语（南非）	en-ZA
英语（南非）	en-ZA
英语（坦桑尼亚）	en-TZ
英语（坦桑尼亚）	en-TZ
英语（英国）	en-GB
英语（英国）	en-GB
英语（英国）	en-GB
英语（英国）	en-GB
英语（美国）	en-US
英语（美国）	en-US
英语（美国）	en-US
英语（美国）	en-US
英语（美国）	en-US
爱沙尼亚语（爱沙尼亚）	et-EE
爱沙尼亚语（爱沙尼亚）	et-EE
菲律宾语（菲律宾）	fil-PH
菲律宾语（菲律宾）	fil-PH
芬兰语（芬兰）	fi-FI
芬兰语（芬兰）	fi-FI
法语（比利时）	fr-BE
法语（比利时）	fr-BE
法语（加拿大）	fr-CA
法语（加拿大）	fr-CA
法语（法国）	fr-FR
法语（法国）	fr-FR
法语（瑞士）	fr-CH
法语（瑞士）	fr-CH
加利西亚语（西班牙）	gl-ES
加利西亚语（西班牙）	gl-ES
格鲁吉亚语（格鲁吉亚）	ka-GE
格鲁吉亚语（格鲁吉亚）	ka-GE
德语（奥地利）	de-AT
德语（奥地利）	de-AT
德语（德国）	de-DE
德语（德国）	de-DE
德语（瑞士）	de-CH
德语（瑞士）	de-CH
希腊语（希腊）	el-GR
希腊语（希腊）	el-GR
古吉拉特语（印度）	gu-IN
古吉拉特语（印度）	gu-IN
希伯来语（以色列）	iw-IL
希伯来语（以色列）	iw-IL
印地语（印度）	hi-IN
印地语（印度）	hi-IN
匈牙利语（匈牙利）	hu-HU
匈牙利语（匈牙利）	hu-HU
冰岛语（冰岛）	is-IS
冰岛语（冰岛）	is-IS
印度尼西亚语（印度尼西亚）	id-ID
印度尼西亚语（印度尼西亚）	id-ID
意大利语（意大利）	it-IT
意大利语（意大利）	it-IT
意大利语（瑞士）	it-CH
意大利语（瑞士）	it-CH
日语（日本）	ja-JP
日语（日本）	ja-JP
爪哇语（印度尼西亚）	jv-ID
爪哇语（印度尼西亚）	jv-ID
卡纳达语（印度）	kn-IN
卡纳达语（印度）	kn-IN
高棉语（柬埔寨）	km-KH
高棉语（柬埔寨）	km-KH
韩语（韩国）	ko-KR
韩语（韩国）	ko-KR
老挝语（老挝）	lo-LA
老挝语（老挝）	lo-LA
拉脱维亚语（拉脱维亚）	lv-LV
拉脱维亚语（拉脱维亚）	lv-LV
立陶宛语（立陶宛）	lt-LT
立陶宛语（立陶宛）	lt-LT
马其顿语（北马其顿）	mk-MK
马其顿语（北马其顿）	mk-MK
马来语（马来西亚）	ms-MY
马来语（马来西亚）	ms-MY
马拉雅拉姆语（印度）	ml-IN
马拉雅拉姆语（印度）	ml-IN
马拉地语（印度）	mr-IN
马拉地语（印度）	mr-IN
蒙古语（蒙古）	mn-MN
蒙古语（蒙古）	mn-MN
尼泊尔语（尼泊尔）	ne-NP
尼泊尔语（尼泊尔）	ne-NP
博克马尔挪威语（挪威）	no-NO
博克马尔挪威语（挪威）	no-NO
波斯语（伊朗）	fa-IR
波斯语（伊朗）	fa-IR
波兰语（波兰）	pl-PL
波兰语（波兰）	pl-PL
葡萄牙语（巴西）	pt-BR
葡萄牙语（巴西）	pt-BR
葡萄牙语（葡萄牙）	pt-PT
葡萄牙语（葡萄牙）	pt-PT
旁遮普语（果鲁穆奇语，印度）	pa-Guru-IN
旁遮普语（果鲁穆奇语，印度）	pa-Guru-IN
罗马尼亚语（罗马尼亚）	ro-RO
罗马尼亚语（罗马尼亚）	ro-RO
俄语（俄罗斯）	ru-RU
俄语（俄罗斯）	ru-RU
俄语（俄罗斯）	ru-RU
俄语（俄罗斯）	ru-RU
塞尔维亚语（塞尔维亚）	sr-RS
塞尔维亚语（塞尔维亚）	sr-RS
僧伽罗语（斯里兰卡）	si-LK
僧伽罗语（斯里兰卡）	si-LK
斯洛伐克语（斯洛伐克）	sk-SK
斯洛伐克语（斯洛伐克）	sk-SK
斯洛文尼亚语（斯洛文尼亚）	sl-SI
斯洛文尼亚语（斯洛文尼亚）	sl-SI
西班牙语（阿根廷）	es-AR
西班牙语（阿根廷）	es-AR
西班牙语（玻利维亚）	es-BO
西班牙语（玻利维亚）	es-BO
西班牙语（智利）	es-CL
西班牙语（智利）	es-CL
西班牙语（哥伦比亚）	es-CO
西班牙语（哥伦比亚）	es-CO
西班牙语（哥斯达黎加）	es-CR
西班牙语（哥斯达黎加）	es-CR
西班牙语（多米尼加共和国）	es-DO
西班牙语（多米尼加共和国）	es-DO
西班牙语（厄瓜多尔）	es-EC
西班牙语（厄瓜多尔）	es-EC
西班牙语（萨尔瓦多）	es-SV
西班牙语（萨尔瓦多）	es-SV
西班牙语（危地马拉）	es-GT
西班牙语（危地马拉）	es-GT
西班牙语（洪都拉斯）	es-HN
西班牙语（洪都拉斯）	es-HN
西班牙语（墨西哥）	es-MX
西班牙语（墨西哥）	es-MX
西班牙语（尼加拉瓜）	es-NI
西班牙语（尼加拉瓜）	es-NI
西班牙语（巴拿马）	es-PA
西班牙语（巴拿马）	es-PA
西班牙语（巴拉圭）	es-PY
西班牙语（巴拉圭）	es-PY
西班牙语（秘鲁）	es-PE
西班牙语（秘鲁）	es-PE
西班牙语（波多黎各）	es-PR
西班牙语（波多黎各）	es-PR
西班牙语（西班牙）	es-ES
西班牙语（西班牙）	es-ES
西班牙语（美国）	es-US
西班牙语（美国）	es-US
西班牙语（美国）	es-US
西班牙语（美国）	es-US
西班牙语（乌拉圭）	es-UY
西班牙语（乌拉圭）	es-UY
西班牙语（委内瑞拉）	es-VE
西班牙语（委内瑞拉）	es-VE
巽他语（印度尼西亚）	su-ID
巽他语（印度尼西亚）	su-ID
斯瓦希里语（肯尼亚）	sw-KE
斯瓦希里语（肯尼亚）	sw-KE
斯瓦希里语（坦桑尼亚）	sw-TZ
斯瓦希里语（坦桑尼亚）	sw-TZ
瑞典语（瑞典）	sv-SE
瑞典语（瑞典）	sv-SE
泰米尔语（印度）	ta-IN
泰米尔语（印度）	ta-IN
泰米尔语（马来西亚）	ta-MY
泰米尔语（马来西亚）	ta-MY
泰米尔语（新加坡）	ta-SG
泰米尔语（新加坡）	ta-SG
泰米尔语（斯里兰卡）	ta-LK
泰米尔语（斯里兰卡）	ta-LK
泰卢固语（印度）	te-IN
泰卢固语（印度）	te-IN
泰语（泰国）	th-TH
泰语（泰国）	th-TH
土耳其语（土耳其）	tr-TR
土耳其语（土耳其）	tr-TR
乌克兰语（乌克兰）	uk-UA
乌克兰语（乌克兰）	uk-UA
乌尔都语（印度）	ur-IN
乌尔都语（印度）	ur-IN
乌尔都语（巴基斯坦）	ur-PK
乌尔都语（巴基斯坦）	ur-PK
乌兹别克语（乌兹别克斯坦）	uz-UZ
乌兹别克语（乌兹别克斯坦）	uz-UZ
越南语（越南）	vi-VN
越南语（越南）	vi-VN
祖鲁语（南非）	zu-ZA
祖鲁语（南非）	zu-ZA