文件翻译请求

POST

接口描述

接口请求域名： tmt.tencentcloudapi.com 。

提交文档原文内容，输出任务ID，支持原文为单一语种文档（如出现多语言文档，仅支持以选定的源语言相关内容翻译）,文件格式有pdf、docx、pptx、xlsx，支持的文本格式有txt、xml、html、markdown、properties。任务翻译数据可保存7天，7天后不再返回任务数据。请注意保存。

默认接口请求频率限制：20次/秒。

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
FailedOperation	操作失败。
FailedOperation.InsertErr	数据插入错误。
FailedOperation.RequestAiLabErr	内部请求错误。
FailedOperation.UserNotRegistered	服务未开通，请在腾讯云官网机器翻译控制台开通服务。

请求参数

Header 参数

X-TC-Action

string

必需

操作的接口名称。本接口取值：FileTranslate。

示例值:

FileTranslate

X-TC-Timestamp

integer

必需

当前 UNIX 时间戳，可记录发起 API 请求的时间。例如 1529223702。注意：如果与服务器时间相差超过5分钟，会引起签名过期错误。

默认值:

1529223702

X-TC-Version

string

必需

操作的 API 的版本。本接口取值：2018-03-21。

默认值:

2018-03-21

Authorization

string

必需

HTTP 标准身份认证头部字段，例如： TC3-HMAC-SHA256 Credential=AKIDEXAMPLE/Date/service/tc3_request, SignedHeaders=content-type;host, Signature=fe5f80f77d5fa3beca038a248ff027d0445342fe2855ddc963176630326f1024 其中， - TC3-HMAC-SHA256：签名方法，目前固定取该值； - Credential：签名凭证，AKIDEXAMPLE 是 SecretId；Date 是 UTC 标准时间的日期，取值需要和公共参数 X-TC-Timestamp 换算的 UTC 标准时间日期一致；service 为产品名，通常为域名前缀，例如域名 cvm.tencentcloudapi.com 意味着产品名是 cvm。本产品取值为 tmt； - SignedHeaders：参与签名计算的头部信息，content-type 和 host 为必选头部； - Signature：签名摘要，计算过程详见文档。

X-TC-Token

string

可选

安全凭证服务所颁发的临时安全凭证中的 Token，使用时需要将 SecretId 和 SecretKey 的值替换为临时安全凭证中的 TmpSecretId 和 TmpSecretKey。使用长期密钥时不能设置此 Token 字段。

X-TC-Language

string

可选

指定接口返回的语言，仅部分接口支持此参数。取值：zh-CN，en-US。zh-CN 返回中文，en-US 返回英文。

默认值:

zh-CN

Body 参数application/json

Source

string

源语言

必需

zh：简体中文；zh-HK：繁体中文；zh-TW：繁体中文；zh-TR：繁体中文；en：英语；ar：阿拉伯语；de：德语；es：西班牙语；fr：法语；it：意大利语；ja：日语；pt：葡萄牙语；ru：俄语；ko：韩语；km：高棉语；lo：老挝语

Target

string

目标语言

必需

各源语言的目标语言支持列表如下：zh（简体中文）： en （英语）、 ar (阿拉伯语）、 de （德语）、 es（西班牙语）、fr（法语）、 it（意大利语）、 ja （日语）、 pt （葡萄牙语）、 ru（俄语）、 ko（韩语）、 km（高棉语）、 lo（老挝语）。zh-HK（繁体中文）：en （英语）、 ar (阿拉伯语）、 de （德语）、 es（西班牙语）、fr（法语）、 it（意大利语）、 ja （日语）、 pt （葡萄牙语）、 ru（俄语）、 ko（韩语）、 km（高棉语）、 lo（老挝语）。zh-TW（繁体中文）：en （英语）、 ar (阿拉伯语）、 de （德语）、 es（西班牙语）、fr（法语）、 it（意大利语）、 ja （日语）、 pt （葡萄牙语）、 ru（俄语）、 ko（韩语）、 km（高棉语）、 lo（老挝语）。zh-TR 繁体中文 : en （英语）、 ar (阿拉伯语）、 de （德语）、 es（西班牙语）、fr（法语）、 it（意大利语）、 ja （日语）、 pt （葡萄牙语）、 ru（俄语）、 ko（韩语）、 km（高棉语）、 lo（老挝语）。en （英语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、 zh-TR(繁体中文）、 ar (阿拉伯语）、 de （德语）、 es（西班牙语）、fr（法语）、 it（意大利语）、 ja （日语）、 pt （葡萄牙语）、 ru（俄语）、 ko（韩语）、 km（高棉语）、 lo（老挝语）。ar（阿拉伯语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。de（德语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。es（西班牙语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。fr（法语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。it（意大利语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。ja（日语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。pt（葡萄牙语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。ru（俄语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。ko（韩语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。km（高棉语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）。lo（老挝语）：zh（简体中文）、zh-HK（繁体中文）、 zh-TW（繁体中文)、zh-TR(繁体中文）

DocumentType

string

文档类型

必需

可支持以下几种：pdf、docx、pptx、xlsx、txt、xml、html、markdown、properties

SourceType

integer

数据来源

可选

0：url，1：直接传文件编码后数据

Url

string

需要翻译文件的url

可选

BasicDocumentType

string

原始文档类型

可选

CallbackUrl

string

回调url

可选

Data

string

文件数据

可选

当SourceType 值为1时必须填写，为0可不写。要base64编码(采用python语言时注意读取文件应该为string而不是byte，以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。数据要小于5MB。

示例

{
  "Source": "zh",
  "Target": "en",
  "DocumentType": "pdf",
  "Data": "eGNmYXNkZmFzZmFzZGZhc2RmCg==",
  "SourceType": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://tmt.tencentcloudapi.com' \
--header 'X-TC-Action: FileTranslate' \
--header 'X-TC-Timestamp;' \
--header 'X-TC-Version;' \
--header 'Authorization;' \
--header 'X-TC-Token;' \
--header 'X-TC-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Source": "zh",
    "Target": "en",
    "DocumentType": "pdf",
    "Data": "eGNmYXNkZmFzZmFzZGZhc2RmCg==",
    "SourceType": 1
}'

返回响应

🟢200成功

application/json

Body

Response

object

必需

RequestId

string

必需

Data

object (Task)

必需

示例

{
  "Response": {
    "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03",
    "Data": {
      "TaskId": "1396665"
    }
  }
}

文件翻译结果查询

语种识别

文件翻译请求

接口描述#

错误码#

请求参数

示例代码

返回响应

接口描述

错误码