对话翻译API 调用说明

对话翻译

GET/POST /ai/chat/translation/and/polishment

产品描述

对话翻译产品专门为电商领域多语言对话场景研发，实现 33 种语言间任意的精确翻译。借助电商特定数据训练以提升翻译质量，并配备自定义干预功能，为电商平台和开发者提供高效的多语言市场扩展解决方案。

请求参数

参数	类型	必填	参数描述及示例值
sourceTextList	String[]	是	待翻译文本；建议不超过 50 条。 示例值：¿Cómo puedo obtener un reembolso?", "¿Qué puedo hacer por ti?
sourceLanguage	String/String[]	是	源语言代码； 采用 ISO 693-1 语言代码规范，例如“英文”的语言代码为 “en”，中文的语言代码为“zh”。 支持的语向见如下支持语向列表。 当有多个源语言时，仅支持一种非英语源语言加英语。产品将自动识别输入的非英语和英语。例如[en,es ]示例值：es
targetLanguage	String	是	目标语言代码； 采用 ISO 693-1 语言代码规范，请选择如下支持的翻译语向入参。支持的目标语向见如下支持语向列表。 示例值：de
formatType	String	是	源文本的格式类型；当前支持 text/html 类型。 示例值：text
glossary	String	否	干预词表 ID； 干预词表需要单独创建，并且其 ID 应在输入参数中提供。支持传入多个干预词表。如果传入的干预词表 ID 为空，则不对翻译结果进行干预。
extension	Object	否	扩展字段，可忽略

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/chat/translation/and/polishment");
request.addApiParameter("sourceTextList", "[\"¿Cómo puedo obtener un reembolso?\",\"¿Qué puedo hacer por ti?\"]");
request.addApiParameter("sourceLanguage", "es");
request.addApiParameter("targetLanguage", "en");
request.addApiParameter("formatType", "text");
request.addApiParameter("glossary", "test_glossory");
request.addApiParameter("extension", "{}");
IopResponse response = client.execute(request);
System.out.println(response.getBody());
Thread.sleep(10);

响应参数

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

响应示例

Java

{
  "data": {
    "usage": 57,
    "translated": [
      "How can I get a refund?",
      "What can I do for you?"
    ],
    "class": "com.aidc.service.api.client.translate.dto.CommonTranslationResponse"
  },
  "requestId": "21413d5a17193029202356783eb7e5",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "21410ad417193029202356958",
  "_trace_id_": "21413d5a17193029202356783eb7e5"
}

错误码

错误码	错误信息	描述
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	语向不支持，请输入支持的语言代码。
1008	text length exceeds the limit	输入文本长度过长