调用问题

机器翻译除文本翻译外是否提供其他形式的翻译

目前支持文本翻译、图片翻译（包含图片翻译和证件翻译）、文档翻译（word、ppt、excel等多种格式）接口，此外提供面向非开发者的在线翻译平台，适用于普通用户直接使用文档、图片、视频翻译。

QPS超过限制问题

QPS达到限制，调用接口就会报错。各产品QPS限制如下表，如有扩展需求，请与我们联系钉钉群号：23369411

机器翻译是否提供定制化翻译服务

如有需求，可联系我方客服人员：mt_support@list.alibaba-inc.com或钉钉加群：23369411

机器翻译支持输入一种语言输出多种翻译后语言吗

机器翻译不支持输入一种语言输出多种翻译后语言，若需要可以调多次接口实现。

子账号调用机器翻译API碰到授权问题，应该如何操作

子账号授权操作步骤在RAM访问控制的权限管理中新建权限策略（https://ram.console.aliyun.com/policies）

主账号如何给子账号授权

1. 登录RAM访问控制--身份管理--用户栏，选择需要授权的子账号，点击添加权限按钮。

2. 选择权限策略

a.系统策略

i.选择系统策略，并在下方输入框中输入mt，系统将自动匹配出机器翻译相关的系统策略。

ii.在权限策略名称列表下单击需要添加的权限策略，添加至右侧已选择权限列表。

说明

子账号需通过RAM用户名密码登录

1.文本框中输入mt、2.选择需要添加的权限策略、3.添加至右侧已选择权限列表、4.点击确定

机器翻译相关系统策略如下所示，以供参考：

权限策略名称	备注	说明
AliyunMTFullAccess	管理机器翻译（alimt）的权限	允许访问和操作全部机器翻译的API接口以及管控台。
AliyunMTReadOnlyAccess	只读访问机器翻译（alimt）的权限	允许只读访问全部机器翻译的API接口以及管控台。

b.自定义策略

i.添加自定义策略

1.选择自定义策略。

2.在权限策略名称列表中找到需要添加的自定义策略，添加至右侧已选择权限列表。

3.若在权限策略名称列表中未找到需要添加的自定义策略，可手动新建自定义策略。

ii.新建自定义策略

1.点击新建权限策略。

2.选择脚本编辑。

3.根据需要创建相应的权限策略。

{
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "alimt:TranslateGeneral",
            "Resource": "acs:alimt:*:123456:*"
        }
    ],
    "Version": "1"
}

如何获取机器翻译的Token

• 有权限的RAM用户可以使用自己的访问密钥调用AssumeRole接口，以获取某个RAM角色的STS Token

• 进行角色SSO时，通过调用AssumeRoleWithSAML接口，以获取某个RAM角色的STS Token

具体可参考什么是STS

测试中心调用图片翻译接口超时/机器翻译接口超时

用户没有开通对应服务，用户需要先在产品详情页/机器翻译控制台开通服务，才可以调用接口。

找不到对应语言的SDK

先找到需要调用的API，点击调用指南文档上面的调试按钮进入OpenAPI，然后在其中找到需要使用的开发语言。

如何查看API key，Accesskey

登录阿里云控制台，鼠标悬浮在页面右上方的头像，在弹出的菜单中选择AccessKey管理，可以查看Access Key。更多信息，请参见创建AccessKey。

机器翻译可以像google那样自动检测语言类型吗

文本翻译可将源语言设置为auto，自动检测源语言，图片翻译不支持该功能。

文本翻译如何批量翻译多项内容

1. 可以使用批量翻译，具体可参考机器批量翻译调用指南。

2. 可以将内容组装到一起，自己定义一个分割词，翻译完了之后，自己在业务上进行分割。

文本翻译单次请求是否有字符数限制

文本翻译单次的文本串长度不能超过5000字符，计算是否超长是通过Java语言的String.length() <=5000计算的。批量文本翻译，单条字符长度不能超过1000字符，一次最多可翻译50条。超过字符长度限制后会出现超时，返回报错信息。如果字符长度超出上限，建议使用文档翻译。

如何对译文的结果进行干预

在翻译的原文中会有很多专有名词、术语、非译单词、缩写词、代码等元素，阿里机器翻译为了让用户可以自行设定原文中的术语或非译元素，我们为您提供了机器翻译结果前处理功能，您可以将预先准备好的术语或词典上传到干预平台，对机器翻译的部分结果进行干预输出。具体使用方式详见词典干预使用指南。

机器翻译能否自动识别源语种

仅文本翻译支持该功能，可以调用语种识别接口，具体可参考语种识别产品介绍，也可在调用翻译接口时将源语种代码设置为auto

如何过滤不想翻译的字符

在原文中加一个标签，把不需要翻译的字符括起来，使其出现在目标译文中，该段原文不会被翻译但仍会计费，标签格式为：I'am a <ALIMT > boy </ALIMT>.

机器翻译可以翻译整个网站吗

文本翻译支持html格式，具体可参考机器翻译通用版调用指南。

机器翻译有node的SDK吗

目前机器翻译支持node的升级版TypeScript的SDK，具体可参考TypeScript SDK。

Java SDK 调用出现报错，SDK.InvalidRegionId

DefaultProfile profile = DefaultProfile.getProfile(
        "cn-hangzhou", // 地域ID
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();// 从环境变量读取访问凭证  
IAcsClient client = new DefaultAcsClient(profile);
TranslateGeneralRequest generalRequest = new TranslateGeneralRequest();// 创建API请求并设置参数
generalRequest.setMethod(MethodType.POST); // 设置请求方式，POST
generalRequest.setFormatType("text");  //翻译文本的格式
generalRequest.setSourceLanguage("zh");  //源语言
generalRequest.setSourceText(URLEncoder.encode("你好","UTF-8"));  //原文
generalRequest.setTargetLanguage("en");  //目标语言
System.out.println(JSON.toJSON(eCommerceResponse));                 

图片翻译API图片大小限制

大小：10M， 图片长宽限制：最小15px， 最大8192px 长宽比不超过10:1。

文档翻译支持PDF格式吗

文档翻译支持pdf格式。

音视频翻译是否支持API调用

音视频翻译目前不支持API调用，可以使用音视频翻译在线编辑平台进行翻译，具体可参考音视频翻译在线编辑平台使用指南。

音视频里面的中文语音可以直接翻译为英文语音吗

中文语音无法直接翻译为英文语音，只支持将中文语音翻译为英文字幕。

图片翻译内容过多造成超时翻译失败

可以调用异步图片翻译API接口。

商品图片智能翻译里的商品实体文字过滤服务在哪里

标题优化 CategoryId 值问题

CategoryId 的值根据Platform 参数的值来确定，Platform 如果是AE这种阿里内部平台就传商品对应种类ID，如果是阿里外部平台可以传默认值0

标题智能生成的请求参数说明

这里是AE的底层类目ID， 需要调用ae的开放接口看下；如果是阿里外部平台可以传默认值0，可以直接传0。

机器翻译开通的区域有哪些

国内站开通区域只有杭州，国际站开通区域有杭州和新加坡。

机器翻译如何关闭

考虑到一键关闭会导致客户的业务受到影响，所以机器翻译服务无法关闭。

如不需要继续使用，可登录机器翻译控制台，检查机器翻译里面的内容，完成数据备份后全部删除，具体设置参见账号注销。

另外可以使用以下替代方案，来达到关闭机器翻译服务或者防止被盗用的目的：

1. 点击新建权限策略。

2. 选择脚本编辑。

3. 根据需要创建相应的权限策略。

说明

自定义权限策略可以指定某个或某几个具体的API。

4. 机器翻译服务是按照使用量进行计费的，不使用/不调用就不会产生费用。另外机器翻译国内站产品按小时出账，出账后如果欠费将会立即停止服务；

5. 对于开发者，是通过API调用的机器翻译能力，可以在访问控制-用户页面，禁用或删除调用接口时使用的子账号的AccessKey ID。或是在AccessKey管理页面，禁用或删除调用接口时使用的主账号的AccessKey ID。