为保障阿里云机器翻译服务的稳定以及资源的公平使用,机器翻译开启了API访问的流量控制。本文主要介绍如何查看机器翻译 API流量控制、接口使用限制,并提供API流量控制的合理化建议。
如有QPS扩展需求,请前往售前咨询或与我们联系钉钉群号:23369411
流量控制范围说明
机器翻译所有API均开启了访问流量控制,不同接口存在不同的流量控制阈值。
接口使用限制说明
机器翻译所有API都有使用上的限制,根据不同接口设置不同的限制类型。
什么是单用户的API流量限制
单用户的API流量限制是指以阿里云账号为基准,该账号和其RAM用户每秒或每分钟调用此API的频率上限。
例如,TranslateGeneral的单用户API流量限制为50次/秒,有1个阿里云账号,这个账号有5个RAM用户,他们都在调用该API,那么这6个账号调用TranslateGeneral的频率加起来不得超过50次/秒。
机器翻译产品使用限制说明
产品分类 | API | API标题 | 流量配额 | 使用限制 | 使用说明 |
文本翻译 | 通用版文本翻译 | 50QPS | 单次请求<5000字符 | 标点、空格、html标签均会计入字符。一个汉字,英文字母,标点符号等,均按照一个字符计费 | |
专业版文本翻译 | 50QPS | 单次请求<5000字符 | |||
批量文本翻译 | 50QPS | 单次请求<1000字符 | |||
语种识别 | 50QPS | 单次请求<5000字符 | |||
多模态翻译 | 图片翻译 | 5QPS | 文件大小限制<10mb | 翻译失败的图片不计入费用 | |
证件翻译 | 5QPS | 文件大小限制<10mb | |||
创建文档翻译 | 5QPS | 文件大小限制<50mb | |||
获取文档翻译结果 | 5QPS | ||||
跨境电商多语言工具 | 商品图片智能翻译 | 3QPS | 文件大小限制:10M,像素限制:图像最短边不少于15px,最长边不大于8192px | ||
创建异步批量图片翻译 | 3QPS | ||||
获取异步批量图片翻译结果 | 3QPS | ||||
图片语种诊断 | 3QPS | ||||
标题诊断 | 10QPS | ||||
标题优化 | 10QPS | ||||
标题智能生成 | 10QPS |
流量控制规则说明
API访问流量控制的规则说明如下:
不同接口的流量控制各自独立计算,单个接口达到流量控制阈值时不会影响其他接口的调用,也不影响该接口在其他地域下的正常使用。
如果某一接口在第T分钟时被流量控制,则该接口需要在第T+1分钟时才会被允许继续调用。
如果使用SDK或CLI等运维方式调用API时被流量控制并报错,相应的功能在阿里云云服务控制台操作中也会被流量控制。
合理化建议
调用机器翻译 API的请求在达到流量控制阈值时,会报Throttling错误码且请求不会被系统正确处理。因此您在使用时,需要考虑调用API的合理性。主要建议如下:
大批量操作。
控制QPS。
退避策略在调用接口并返回流量控制的错误码后,相同的接口请求需要退避策略。在退避时,同一阿里云账号的同一接口调用可以采取1 QPS速度进行可用性探测。