短語(yǔ)音同步檢測(cè)提供基于HTTP和HTTPS協(xié)議的同步音頻檢測(cè)接口，該接口可以實(shí)時(shí)將語(yǔ)音的內(nèi)容轉(zhuǎn)換為文字，并返回給您內(nèi)容審核的結(jié)果以及風(fēng)險(xiǎn)標(biāo)簽，幫助您提高審核效率。本文介紹了調(diào)用短語(yǔ)音同步檢測(cè)接口（/green/voice/syncscan）進(jìn)行語(yǔ)音內(nèi)容審核的方法。
使用說明
業(yè)務(wù)接口：/green/voice/syncscan，表示語(yǔ)音同步檢測(cè)。
您可以調(diào)用該接口創(chuàng)建語(yǔ)音同步檢測(cè)任務(wù)。關(guān)于如何構(gòu)造HTTP請(qǐng)求，請(qǐng)參見請(qǐng)求結(jié)構(gòu)；您也可以直接選用已構(gòu)造好的HTTP請(qǐng)求，更多信息，請(qǐng)參見SDK概覽。
說明 語(yǔ)音檢測(cè)默認(rèn)識(shí)別中文普通話，如需識(shí)別其他語(yǔ)種（例如，英語(yǔ)、日語(yǔ)、西班牙語(yǔ)、阿拉伯語(yǔ)、法語(yǔ)、印尼語(yǔ)、越南語(yǔ)）或方言（粵語(yǔ)、四川話、湖北話、陜西話、山西話、河南話、東北話、天津話、甘肅話、貴州話、云南話、江西話、廣西話、云南話、湖南話、山東話、蘇州話、浙江話、上海話、閩南語(yǔ)），請(qǐng)聯(lián)系商務(wù)經(jīng)理。
- 計(jì)費(fèi)信息：
該接口為收費(fèi)接口。關(guān)于計(jì)費(fèi)方式，請(qǐng)參見內(nèi)容安全產(chǎn)品定價(jià)。
- 音頻文件要求：
- 支持的音頻文件大小小于20 MB。
- 支持的語(yǔ)音文件時(shí)長(zhǎng)小于1分鐘。
- 支持的音頻文件格式：MP3、WAV、AAC、WMA、OGG、M4A、M3U8。
- 支持以下包含音頻的視頻文件格式：AVI、FLV、MP4、MPG、ASF、WMV、MOV、RMVB、RM。
QPS限制
本接口的單用戶QPS限制為50次/秒。超過限制，API調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。
請(qǐng)求參數(shù)
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| bizType | String | 否 | default | 該字段用于標(biāo)識(shí)您的業(yè)務(wù)場(chǎng)景。您可以通過內(nèi)容安全控制臺(tái)創(chuàng)建業(yè)務(wù)場(chǎng)景（具體操作，請(qǐng)參見自定義機(jī)審標(biāo)準(zhǔn)）。 |
| scenes | StringArray | 是 | antispam | 檢測(cè)場(chǎng)景，唯一取值：antispam。 |
| tasks | JSONArray | 是 | 指定檢測(cè)對(duì)象，JSON數(shù)組中的每個(gè)元素是一個(gè)檢測(cè)任務(wù)結(jié)構(gòu)體。最多支持100個(gè)元素，即每次提交100條內(nèi)容進(jìn)行檢測(cè)，支持100個(gè)元素的前提是需要將并發(fā)任務(wù)調(diào)整到100個(gè)以上。關(guān)于每個(gè)元素的具體結(jié)構(gòu)描述，請(qǐng)參見task。 |
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| clientInfo | JSONObject | 否 | {"userId":"120234234","userNick":"Mike","userType":"others"} | 客戶端信息，請(qǐng)參見公共參數(shù)中的公共查詢參數(shù)。 服務(wù)器會(huì)把全局的clientInfo和此處獨(dú)立的clientInfo合并。 說明 獨(dú)立的clientInfo優(yōu)先級(jí)更高。 |
| dataId | String | 否 | abc_123 | 檢測(cè)對(duì)象對(duì)應(yīng)的數(shù)據(jù)ID。 由大小寫英文字母、數(shù)字、下劃線（_）、短劃線（-）、英文句號(hào)（.）組成，不超過128個(gè)字符，可以用于唯一標(biāo)識(shí)您的業(yè)務(wù)數(shù)據(jù)。 |
| url | String | 是 | http://aliyundoc.com/test.mp3 | 檢測(cè)對(duì)象的URL。
|
返回?cái)?shù)據(jù)
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| code | Integer | 200 | 錯(cuò)誤碼，和HTTP狀態(tài)碼一致。 更多信息，請(qǐng)參見公共錯(cuò)誤碼。 |
| msg | String | OK | 請(qǐng)求消息的響應(yīng)消息。 |
| dataId | String | abc_123 | 檢測(cè)對(duì)象對(duì)應(yīng)的數(shù)據(jù)ID。 說明 如果在檢測(cè)請(qǐng)求參數(shù)中傳入了dataId，則此處返回對(duì)應(yīng)的dataId。 |
| taskId | String | vc_f_1OsjIYTukH@4@AXkIQ9xxx-1ov52Y | 檢測(cè)任務(wù)的ID。 |
| url | String | http://aliyundoc.com/test.mp3 | 檢測(cè)對(duì)象的URL。
|
| results | JSONArray | 檢測(cè)成功（code=200）時(shí)，返回的檢測(cè)結(jié)果。返回結(jié)果中包含一個(gè)或多個(gè)元素。每個(gè)元素是個(gè)結(jié)構(gòu)體，具體結(jié)構(gòu)描述見result。 |
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| scene | String | antispam | 檢測(cè)場(chǎng)景，和調(diào)用請(qǐng)求中的場(chǎng)景對(duì)應(yīng)。唯一取值：antispam。 |
| label | String | customized | 檢測(cè)結(jié)果的分類。取值：
|
| suggestion | String | block | 建議您執(zhí)行的后續(xù)操作，取值：
|
| rate | Float | 99.91 | 置信度分?jǐn)?shù)，取值范圍：0（表示置信度最低）~100（表示置信度最高）。 如果suggestion為pass，則置信度越高，表示內(nèi)容正常的可能性越高；如果suggestion為review或block，則置信度越高，表示內(nèi)容違規(guī)的可能性越高。 重要 建議您參考suggestion和label（或者部分接口返回的sublabel）結(jié)果用于內(nèi)容違規(guī)判定。 |
| details | JSONArray | 語(yǔ)音對(duì)應(yīng)的文本詳情，每一句文本對(duì)應(yīng)一個(gè)元素，可以包含一個(gè)或者多個(gè)元素。關(guān)于每個(gè)元素的結(jié)構(gòu)描述，請(qǐng)參見detail。 |
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| startTime | Integer | 0 | 句子開始的時(shí)間戳，單位：秒。 |
| endTime | Integer | 4065 | 句子結(jié)束的時(shí)間戳，單位：秒。 |
| text | String | 惡心的 | 語(yǔ)音轉(zhuǎn)換成文本的結(jié)果。 |
| label | String | politics | 檢測(cè)結(jié)果的分類。取值：
|
| persons | JSONArray | [{"name":"敏感人名A"}] | 聲紋識(shí)別結(jié)果，如果命中了敏感人物的聲紋，則會(huì)返回該字段。 具體結(jié)構(gòu)如下：
說明 默認(rèn)不返回該字段。如果有需要，請(qǐng)聯(lián)系商務(wù)經(jīng)理。 |
| keyword | String | 惡心 | 如果命中了用戶自定義關(guān)鍵詞，返回命中的關(guān)鍵詞。 |
| libName | String | test | 如果命中了用戶自定義關(guān)鍵詞，返回關(guān)鍵詞所在的詞庫(kù)。 |
示例
請(qǐng)求示例
http(s)://[Endpoint]/green/voice/syncscan
&<公共請(qǐng)求參數(shù)>{
"scenes":[
"antispam"
],
"tasks":[
{
"dataId":"abcd-123",
"url":"http://aliyundoc.com/test.mp3"
}
]
}返回示例
{
"msg":"OK",
"code":200,
"data":[
{
"code":200,
"dataId":"abcd-123",
"results":[
{
"rate":99.91,
"suggestion":"block",
"details":[
{
"libName":"test",
"startTime":0,
"endTime":4065,
"label":"customized",
"text":"惡心的",
"keyword":"惡心"
},
{
"startTime":4430,
"endTime":10065,
"label":"normal",
"persons": [
{
"name": "敏感人名A"
}
],
"text":"哈哈哈"
},
{
"libName":"語(yǔ)音",
"startTime":11670,
"endTime":14685,
"label":"customized",
"text":"大甩賣",
"keyword":"甩賣"
},
{
"startTime":14685,
"endTime":16065,
"label":"ad",
"text":"12345"
}
],
"label":"customized"
}
],
"taskId":"vc_f_1OsjIYTukH@4@AXkIQ9xxx-1ov52Y"
}
],
"requestId":"5A7A6198-6960-4DDC-B67E-58A111A4B20F"
}