商品文本翻译API调用说明

商品文本翻译

GET/POST /ai/text/translation/and/polishment

产品介绍

商品文本翻译产品专门为电商场景研发，实现 60 多种语向间的精确翻译。借助电商特定数据训练提升翻译质量，并配备智能品牌识别与自定义干预功能，为电商平台和开发者提供高效的多语言市场扩张解决方案。

请求参数

参数名称	类型	必填	参数描述及示例值
sourceTextList	String[]	是	翻译文本； 总字符长度不应超过1000，建议列表不超过50项。我们还提供支持大批量产品文本离线翻译的批量API。如有需要，请与我们联系。 示例值："Pen for iPad, 13 mins Fast Charging Stylus with Palm Rejection, Tilt Sensitivity, Compatible with 2018-2022 iPad Air 3/4/5, iPad Mini 5/6, iPad 6/7/8/9/10, (Black)"
sourceLanguage	String	是	源语言代码，可点击查看各语言代码； 使用 ISO 693-1 语言代码规范，例如“英文”的语言代码为 “en”，中文的语言代码为“zh”； 支持的语向见如下支持语向列表。 暂不支持语种自动检测能力。 示例值："en"
targetLanguage	String	是	目标语言代码，可点击查看各语言代码；； 使用 ISO 693-1 语言代码规范，请选择如下支持的翻译语向入参； 支持的目标语向见如下支持语向列表。 示例值："ko"
formatType	String	是	源文本的格式类型； 当前支持 text/html 类型。 示例值："text"
glossary	String	否	干预词表 ID。 干预词表 ID需要单独创建，并在输入参数中提供其 ID。可以传递多个干预词表 。如果提供的干预词表 ID 为空，则翻译结果将不会被修改。 暂不支持自助上传干预词表 ID。如有需要，请联系我们。 示例值："translation_glossary"
extension	Object	否	扩展字段； 目前 translate_scene(String) 支持商品详情描述和商品属性(description)/商品标题(title)//商品评论(review)的翻译场景。 示例值："title"

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/text/translation/and/polishment");
request.addApiParameter("sourceTextList", "[\"Pen for iPad, 13 mins Fast Charging Stylus with Palm Rejection, Tilt Sensitivity, Compatible with 2018-2022 iPad Air 3/4/5, iPad Mini 5/6, iPad 6/7/8/9/10, iPad Pro 11, iPad Pro 12.9 (Black)\"]");
request.addApiParameter("sourceLanguage", "en");
request.addApiParameter("targetLanguage", "ko");
request.addApiParameter("formatType", "text");
request.addApiParameter("glossary", "test_glossory");
request.addApiParameter("extension", "{}");
IopResponse response = client.execute(request, Protocol.TOP);
System.out.println(response.getBody());
Thread.sleep(10);

响应参数

参数名称	类型	参数描述
resCode	Number	响应代码； 200 代表调用成功，其他的响应代码可以参考错误码信息。
data	Object	返回的翻译结果结构体信息。
data.usage	Number	翻译的字符数计量。
data.translated	String[]	翻译的结果信息。
requestId	String	请求 ID；用来识别唯一一次请求调用
success	Boolean	是否成功；true 代表成功，false 代表失败。
resMessage	String	报错信息，例如“参数中包含敏感信息，请尝试其他输入”。

响应示例

Java

{
  "data": {
    "usage": 143,
    "translated": [
      "iPad용 펜, 손바닥 거부 기능이 있는 13분 고속 충전 스타일러스, 기울기 감도, 2018-2022 iPad Air 3/4/, iPad Mini 5/6, iPad 6/7/8/9/10, iPad Pro 11, iPad Pro 12.9와 호환 가능(검은색)"
    ],
    "class": "com.aidc.service.api.client.translate.dto.CommonTranslationResponse"
  },
  "requestId": "2101364017192321239846748e03d8",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "2101236717192321239867892",
  "_trace_id_": "2101364017192321239846748e03d8"
}

错误码

错误码	错误信息	描述
500	system error	系统错误。
501	rate limit exceed	当前接口已达到限流上限,请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们增加当前限制值。
700	invalid input	输入参数的格式不符合要求，resMessage 将返回详细的不符合要求的字段。
801	model failed	内部调用异常，请通过搜Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们进行故障排除。
1000	content has sensitive data, please try other input	请求参数中包含敏感信息，暂不支持处理。请尝试其他输入。
1001	content control failed, please retry	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。
1002	content risk filter failed, please contact us	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。
1007	text language is not supported	文本语言不支持，请输入正确的语言。
1100	The input text length is too long	输入文本长度过长（最大限制为4096个Token），请再次输入符合长度限制的文本。

附录

支持的语向和场景

您可以针对不同商品文本内容类型，选择支持的语向进行使用。更多的语向在持续增加中，如有需求请联系我们。点击查看支持的语向及场景

语言代码

语言代码采用 ISO 639-1 标准的两位字母表示法。对于特定语言的区域变体，遵循 RFC 5646 格式，即在语言代码后加短横线，并接上 ISO 3166 的两位国家/地区代码。例如，繁体中文的语言代码是 zh-tw。

点击查看语言代码

Notice

By using this API, you confirm that you are a legal owner of all intellectual property rights pertaining to the data and content that you provide to us via the API, or have obtained the necessary authorizations for us to receive and use the same from you. You further agree that you will not use this product or any output thereof for any unlawful, unethical, unauthorized or harmful activities.