调用问题

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

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

QPS超过限制问题

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

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

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

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

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

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

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

主账号如何给子账号授权

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

2. 选择权限策略

1. 系统策略

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

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

说明

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

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

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

2. 自定义策略

   1. 添加自定义策略

      1. 选择自定义策略。

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

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

   2. 新建自定义策略

      1. 点击新建权限策略。

      2. 选择脚本编辑。

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

说明

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



说明

自定义权限策略示例代码：

例如，权限内容要求如下，

主账号的 ID 为123456

允许调用机器翻译通用版接口

则权限内容如下，

{
    "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

在控制台的Access管理内，可以查看ID以及key

机器翻译可以像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

1. 检查aliyun-java-sdk-core和aliyun-java-sdk-alimt版本是否正常

2. 尝试变更下写法

3. DefaultProfile profile = DefaultProfile.getProfile( "cn-hangzhou", // 地域ID accessKeyId, // 阿里云账号的AccessKey ID accessKeySecret); // 阿里云账号Access Key Secret IAcsClient client = new DefaultAcsClient(profile); // 创建API请求并设置参数 TranslateGeneralRequest generalRequest = new TranslateGeneralRequest(); 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格式吗

目前不支持。

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

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

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

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

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

调用异步图片翻译API接口，仅跨境电商语言工具（商品图片智能翻译）支持。

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

标题优化 CategoryId 值问题

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

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

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

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

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

机器翻译如何关闭

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

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

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

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

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