文档

调用问题

更新时间:
说明

更多调用问题,请前往售前咨询或搜钉钉群号23369411入群咨询专家。

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

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

QPS超过限制问题

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

产品名称

QPS

通用版翻译引擎

50

专业版翻译引擎

50

定制版翻译引擎

3

文档翻译

5

通用图片翻译

20

电商图片翻译

20

身份证翻译

10

驾照翻译

40

语种识别

50

跨境电商语言工具(商品图片智能翻译)

3

跨境电商语言工具(标题智能优化/生成)

10

跨境电商语言工具(标题质量诊断)

10

跨境电商语言工具(图片语种检测)

3

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

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

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

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

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

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

主账号如何给子账号授权

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

确定子账号1

  1. 选择权限策略

a.系统策略

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

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

    说明

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

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

添加权限1机器翻译相关系统策略如下所示,以供参考:

    权限策略名称

    备注

    说明

    AliyunMTFullAccess

    管理机器翻译(alimt)的权限

    允许访问和操作全部机器翻译的API接口以及管控台。

    AliyunMTReadOnlyAccess

    只读访问机器翻译(alimt)的权限

    允许只读访问全部机器翻译的API接口以及管控台。

b.自定义策略

i.添加自定义策略

1.选择自定义策略

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

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

ii.新建自定义策略

1.点击新建权限策略。

2.选择脚本编辑。

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

说明

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

imageimage

说明

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

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

  1. 主账号的 ID 为123456

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

则权限内容如下,

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

更详细的策略配置说明,请参考权限策略管理

如何获取机器翻译的Token

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

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

具体可参考什么是STS

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

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

image

找不到对应语言的SDK

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

image

找不到对应语言的sdk.jpeg

如何查看API key,Accesskey

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

第一张

image

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

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

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

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

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

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

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

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

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

说明

词典干预功能仅支持在控制台上使用,暂不支持API调用。

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

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

如何过滤不想翻译的字符

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

说明

标签<ALIMT ></ALIMT> 中间括起来的部分不会被翻译,请注意标签<ALIMT >,ALIMT后面有个空格

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

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

机器翻译有node的SDK吗

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

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

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

  2. 尝试变更下写法

说明

阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。

强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。本示例使用了阿里云Credentials工具托管AccessKey,来实现API访问的身份验证。具体配置操作(或者配置环境变量),请参见https://help.aliyun.com/document_detail/378659.html

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接口

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

image

标题优化 CategoryId 值问题

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

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

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

image

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

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

机器翻译如何关闭

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

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

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

  1. 点击新建权限策略。

  2. 选择脚本编辑。

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

  4. 说明

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

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

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