文本翻译

简介

HI,您好,欢迎使用腾讯AI开放平台文本翻译API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师,详细描述文本翻译能力相关的技术内容。

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

官方交流一群:581197347

官方交流二群:705874401

官方交流三群:415349651

联系邮箱:aicamp@tencent.com

接口能力

接口名称 接口描述 API地址
文本翻译(AI Lab) 对文本进行翻译,支持多种语言之间互译 https://api.ai.qq.com/fcgi-bin/nlp/nlp_texttrans
文本翻译(翻译君) 对文本进行翻译,支持多种语言之间互译 https://api.ai.qq.com/fcgi-bin/nlp/nlp_texttranslate

更多更强大的接口能力正在开发中,并逐步开放,敬请期待!

协议须知

调用方集成语种识别API时,请遵循以下规则。

规则 描述
传输方式 HTTPS
请求方法 GET或POST
字符编码 统一采用UTF-8编码
响应格式 统一采用JSON格式
接口鉴权 签名机制,详情请阅接口鉴权

一、文本翻译(AI Lab)

1. 接口描述

文本翻译接口提供自动翻译能力,可以帮您快速完成一段文本的翻译,支持中、英、德、法、日、韩、西、粤语种。

2. 请求参数

参数名称 是否必选 数据类型 数据约束 示例数据 描述
app_id int 正整数 1000001 应用标识(AppId)
time_stamp int 正整数 1493468759 请求时间戳(秒级)
nonce_str string 非空且长度上限32字节 fa577ce340859f9fe 随机字符串
sign string 非空且长度固定32字节 签名信息,详见接口鉴权
type int 正整数 0 翻译类型,默认为0,详细见下文
text string UTF-8编码,非空且长度上限1024字节 今天天气怎么样 待翻译文本

3. 响应参数

参数名称 是否必选 数据类型 描述
ret int 返回码; 0表示成功,非0表示出错
msg string 返回信息;ret非0时表示出错时错误原因
data object 返回数据;ret为0时有意义
+ type int API请求中的翻译类型
+ org_text string API请求中的待翻译文本
+ trans_text string 翻译后文本

4. 参考示例

假设示例请求数据如下。具体调用方式见SDK及文档

参数名称 参数数据 描述
app_id 1000001 仅供参考
type 0 仅供参考
text 今天天气怎么样 使用UTF-8编码
time_stamp 实时计算
nonce_str 实时计算
sign 实时计算

假设应用密钥为:a95eceb1ac8c24ee28b70f7dbba912bf

下面使用PHP实现该HTTP API调用,其中getReqSigndoHttpPost可以从接口鉴权获取。

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'type'       => '0',
    'text'       => '今天天气怎么样',
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/nlp/nlp_texttrans';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果(注意使用UTF-8编码):

{
  "ret": 0,
  "msg": "ok",
  "data": {
      "type": 0,
      "org_text": "今天天气怎么样",
      "trans_text": "What's the weather like today"
  }
}

5. 翻译类型定义

翻译类型 描述
0 自动识别(中英文互转)
1 中文翻译成英文
2 英文翻译成中文
3 中文翻译成西班牙文
4 西班牙文翻译成中文
5 中文翻译成法文
6 法文翻译成中文
7 英文翻译成越南语
8 越南语翻译成英文
9 中文翻译成粤语
10 粤语翻译成中文
11 中文翻译成韩文
13 英文翻译成德语
14 德语翻译成英文
15 中文翻译成日文
16 日文翻译成中文

二、文本翻译(翻译君)

1. 接口描述

文本翻译接口提供自动翻译能力,可以帮您快速完成一段文本的翻译,支持多种语言之间的互译。

2. 请求参数

参数名称 是否必选 数据类型 数据约束 示例数据 描述
app_id int 正整数 1000001 应用标识(AppId)
time_stamp int 正整数 1493468759 请求时间戳(秒级)
nonce_str string 非空且长度上限32字节 fa577ce340859f9fe 随机字符串
sign string 非空且长度固定32字节 签名信息,详见接口鉴权
text string UTF-8编码,非空且长度上限1024字节 今天天气怎么样 待翻译文本
source string 两位小写字母 zh 源语言缩写,详细见下文
target string 两位小写字母 en 目标语言缩写,详细见下文

3. 响应参数

参数名称 是否必选 数据类型 描述
ret int 返回码; 0表示成功,非0表示出错
msg string 返回信息;ret非0时表示出错时错误原因
data object 返回数据;ret为0时有意义
+ source_text string API请求中的待翻译文本
+ target_text string 翻译后文本

4. 参考示例

假设示例请求数据如下。

参数名称 参数数据 描述
app_id 1000001 仅供参考
source zh 仅供参考
target en 仅供参考
text 今天天气怎么样 使用UTF-8编码
time_stamp 实时计算
nonce_str 实时计算
sign 实时计算

假设应用密钥为:a95eceb1ac8c24ee28b70f7dbba912bf

下面使用PHP实现该HTTP API调用,其中getReqSigndoHttpPost可以从接口鉴权获取。

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'source'     => 'zh',
    'target'     => 'en',
    'text'       => '今天天气怎么样',
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/nlp/nlp_texttranslate';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果(注意使用UTF-8编码):

{
  "ret": 0,
  "msg": "ok",
  "data": {
      "source_text": "今天天气怎么样",
      "target_text": "What's the weather like today"
  }
}

5. 支持语言定义

语言 缩写
中文 zh
英文 en
日文 jp
韩文 kr
法文 fr
西班牙文 es
意大利文 it
德文 de
土耳其文 tr
俄文 ru
葡萄牙文 pt
越南文 vi
印度尼西亚文 id
马来西亚文 ms
泰文 th
自动识别(中英互译) auto
源语言 支持目标语言
en zh, fr, es, it, de, tr, ru, pt, vi, id, ms, th
zh en, fr, es, it, de, tr, ru, pt, vi, id, ms, th, jp, kr
fr en, zh, es, it, de, tr, ru, pt
es en, zh, fr, it, de, tr, ru, pt
it en, zh, fr, es, de, tr, ru, pt
de en, zh, fr, es, it, tr, ru, pt
tr en, zh, fr, es, it, de, ru, pt
ru en, zh, fr, es, it, de, tr, pt
pt en, zh, fr, es, it, de, tr, ru
vi en, zh
id en, zh
ms en, zh
th en, zh
jp zh
kr zh
AI开放平台公众号
关注公众号

打造升级AI项目
推送全球AI热点