使用限制

为保障阿里云机器翻译服务的稳定以及资源的公平使用,机器翻译开启了API访问的流量控制。本文主要介绍如何查看机器翻译 API流量控制、接口使用限制,并提供API流量控制的合理化建议。

说明

如有QPS扩展需求,请前往售前咨询或与我们联系钉钉群号:23369411

流量控制范围说明

机器翻译所有API均开启了访问流量控制,不同接口存在不同的流量控制阈值。

接口使用限制说明

机器翻译所有API都有使用上的限制,根据不同接口设置不同的限制类型。

什么是单用户的API流量限制

单用户的API流量限制是指以阿里云账号为基准,该账号和其RAM用户每秒或每分钟调用此API的频率上限。

例如,TranslateGeneral的单用户API流量限制为50次/秒,有1个阿里云账号,这个账号有5个RAM用户,他们都在调用该API,那么这6个账号调用TranslateGeneral的频率加起来不得超过50次/秒。

机器翻译产品使用限制说明

说明

API速率配额详情,请前往配额中心查看,接口费用说明请参考计费概述

产品分类

API

API标题

流量配额

使用限制

使用说明

文本翻译

TranslateGeneral

通用版文本翻译

50QPS

单次请求<5000字符

标点、空格、html标签均会计入字符。一个汉字,英文字母,标点符号等,均按照一个字符计费

Translate

专业版文本翻译

50QPS

单次请求<5000字符

GetBatchTranslate

批量文本翻译

50QPS

单次请求<1000字符

GetDetectLanguage

语种识别

50QPS

单次请求<5000字符

多模态翻译

TranslateImage

图片翻译

5QPS

文件大小限制<10mb

翻译失败的图片不计入费用

TranslateCertificate

证件翻译

5QPS

文件大小限制<10mb

CreateDocTranslateTask

创建文档翻译

5QPS

文件大小限制<50mb

GetDocTranslateTask

获取文档翻译结果

5QPS

跨境电商多语言工具

GetImageTranslate

商品图片智能翻译

3QPS

文件大小限制:10M,像素限制:图像最短边不少于15px,最长边不大于8192px

CreateImageTranslateTask

创建异步批量图片翻译

3QPS

GetImageTranslateTask

获取异步批量图片翻译结果

3QPS

GetImageDiagnose

图片语种诊断

3QPS

GetTitleDiagnose

标题诊断

10QPS

GetTitleGenerate

标题优化

10QPS

GetTitleIntelligence

标题智能生成

10QPS

流量控制规则说明

API访问流量控制的规则说明如下:

  • 不同接口的流量控制各自独立计算,单个接口达到流量控制阈值时不会影响其他接口的调用,也不影响该接口在其他地域下的正常使用。

  • 如果某一接口在第T分钟时被流量控制,则该接口需要在第T+1分钟时才会被允许继续调用。

  • 如果使用SDK或CLI等运维方式调用API时被流量控制并报错,相应的功能在阿里云云服务控制台操作中也会被流量控制。

合理化建议

调用机器翻译 API的请求在达到流量控制阈值时,会报Throttling错误码且请求不会被系统正确处理。因此您在使用时,需要考虑调用API的合理性。主要建议如下:

  • 大批量操作。

  • 控制QPS。

  • 退避策略在调用接口并返回流量控制的错误码后,相同的接口请求需要退避策略。在退避时,同一阿里云账号的同一接口调用可以采取1 QPS速度进行可用性探测。