使用限制
為保障阿里云機(jī)器翻譯服務(wù)的穩(wěn)定以及資源的公平使用，機(jī)器翻譯開啟了API訪問的流量控制。本文主要介紹如何查看機(jī)器翻譯 API流量控制、接口使用限制，并提供API流量控制的合理化建議。
如有QPS擴(kuò)展需求，請(qǐng)前往售前咨詢或與我們聯(lián)系釘釘群號(hào)：23369411
流量控制范圍說明
機(jī)器翻譯所有API均開啟了訪問流量控制，不同接口存在不同的流量控制閾值。
接口使用限制說明
機(jī)器翻譯所有API都有使用上的限制，根據(jù)不同接口設(shè)置不同的限制類型。
什么是單用戶的API流量限制
單用戶的API流量限制是指以阿里云賬號(hào)為基準(zhǔn)，該賬號(hào)和其RAM用戶每秒或每分鐘調(diào)用此API的頻率上限。
例如，TranslateGeneral的單用戶API流量限制為50次/秒，有1個(gè)阿里云賬號(hào)，這個(gè)賬號(hào)有5個(gè)RAM用戶，他們都在調(diào)用該API，那么這6個(gè)賬號(hào)調(diào)用TranslateGeneral的頻率加起來不得超過50次/秒。
機(jī)器翻譯產(chǎn)品使用限制說明
API速率配額詳情，請(qǐng)前往配額中心查看,接口費(fèi)用說明請(qǐng)參考計(jì)費(fèi)概述。
產(chǎn)品分類 | API | API標(biāo)題 | 流量配額 | 使用限制 | 使用說明 |
文本翻譯 | 通用版文本翻譯 | 50QPS | 單次請(qǐng)求<5000字符 | 標(biāo)點(diǎn)、空格、html標(biāo)簽均會(huì)計(jì)入字符。一個(gè)漢字，英文字母，標(biāo)點(diǎn)符號(hào)等，均按照一個(gè)字符計(jì)費(fèi) | |
專業(yè)版文本翻譯 | 50QPS | 單次請(qǐng)求<5000字符 | |||
批量文本翻譯 | 50QPS | 單次請(qǐng)求<1000字符 | |||
創(chuàng)建文本異步翻譯任務(wù) | 5QPS | 單次請(qǐng)求<100萬(wàn)字符 | |||
獲取文本異步翻譯任務(wù) | 5QPS | ||||
語(yǔ)種識(shí)別 | 50QPS | 單次請(qǐng)求<5000字符 | |||
多模態(tài)翻譯 | 圖片翻譯 | 5QPS | 文件大小限制<10mb | 翻譯失敗的圖片不計(jì)入費(fèi)用 | |
證件翻譯 | 5QPS | 文件大小限制<10mb | |||
創(chuàng)建文檔翻譯 | 5QPS | 文件大小限制<50mb | |||
獲取文檔翻譯結(jié)果 | 5QPS | ||||
跨境電商多語(yǔ)言工具 | 商品圖片智能翻譯 | 3QPS | 文件大小限制：10M，像素限制：圖像最短邊不少于15px，最長(zhǎng)邊不大于8192px | ||
創(chuàng)建異步批量圖片翻譯 | 3QPS | ||||
獲取異步批量圖片翻譯結(jié)果 | 3QPS | ||||
圖片語(yǔ)種診斷 | 3QPS | ||||
標(biāo)題診斷 | 10QPS | ||||
標(biāo)題優(yōu)化 | 10QPS | ||||
標(biāo)題智能生成 | 10QPS |
流量控制規(guī)則說明
API訪問流量控制的規(guī)則說明如下：
不同接口的流量控制各自獨(dú)立計(jì)算，單個(gè)接口達(dá)到流量控制閾值時(shí)不會(huì)影響其他接口的調(diào)用，也不影響該接口在其他地域下的正常使用。
如果某一接口在第T分鐘時(shí)被流量控制，則該接口需要在第T+1分鐘時(shí)才會(huì)被允許繼續(xù)調(diào)用。
如果使用SDK或CLI等運(yùn)維方式調(diào)用API時(shí)被流量控制并報(bào)錯(cuò)，相應(yīng)的功能在阿里云云服務(wù)控制臺(tái)操作中也會(huì)被流量控制。
合理化建議
調(diào)用機(jī)器翻譯 API的請(qǐng)求在達(dá)到流量控制閾值時(shí)，會(huì)報(bào)Throttling錯(cuò)誤碼且請(qǐng)求不會(huì)被系統(tǒng)正確處理。因此您在使用時(shí)，需要考慮調(diào)用API的合理性。主要建議如下：
大批量操作。
控制QPS。
退避策略在調(diào)用接口并返回流量控制的錯(cuò)誤碼后，相同的接口請(qǐng)求需要退避策略。在退避時(shí)，同一阿里云賬號(hào)的同一接口調(diào)用可以采取1 QPS速度進(jìn)行可用性探測(cè)。