文档中心 > API类目 > ICBU-商品

alibaba.icbu.text.trans (icbu文本翻译)

icbu文本翻译

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
icbu_translate_task_dto IcbuTranslateTaskDTO 必须 翻译任务dto
  • └ trans_engine
  • String
  • 必须
  • ALI_TRANS
  • 翻译引擎名称
  • └ target_language
  • String
  • 必须
  • es
  • 目标语种
  • └ app_name
  • String
  • 必须
  • xiaoman
  • 翻译使用的appName
  • └ source_text
  • String
  • 必须
  • this is a test text
  • 需要翻译的内容
  • └ format
  • String
  • 必须
  • text
  • html或者text
  • └ field_type
  • String
  • 必须
  • title
  • query、offer、title、message,feedback
  • └ param_map
  • String
  • 可选
  • {"key":"value"}
  • 业务透传参数
  • └ source_language
  • String
  • 必须
  • en
  • 翻译文案对应的语种

响应参数

名称 类型 示例值 描述
result IcbuTranslateResultDTO [] 翻译结果dto
  • error_code
  • ErrorCode
  • 失败调用的时候的错误码
  • └ code
  • String
  • 10001
  • 错误码的code
  • └ display_text
  • String
  • Params is illegal
  • 对外展示的错误信息
  • └ trace_id
  • String
  • 210764d516876720847747520e432e
  • 本次调用的唯一标识
  • └ trans_engine
  • String
  • ALI_TRANS
  • 本次翻译使用的引擎
  • └ source_text
  • String
  • this is a text
  • 需要翻译的文本
  • └ translate_result_text
  • String
  • this is a text
  • 翻译好的译文
  • └ field_type
  • String
  • title
  • 翻译业务类型(query、offer、title)
  • └ source_language
  • String
  • en
  • 原始语种
  • └ target_language
  • String
  • es
  • 目标语种
  • └ format
  • String
  • text
  • 翻译文本的格式(取值为:html、text) ,query业务只支持text,其他业务两者都支持,必填
  • └ param_map
  • String
  • aaa
  • 业务方传递的参数,原样返回,不需要的业务不必关心
  • └ app_name
  • String
  • xiaoman
  • 业务场景id
  • └ ext
  • String
  • aaa
  • 翻译相关的扩展信息,业务可以不关心
  • └ trans_char
  • Number
  • 100
  • 翻译字符数
  • └ success
  • Boolean
  • true
  • 本次翻译是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIcbuTextTransRequest req = new AlibabaIcbuTextTransRequest();
AlibabaIcbuTextTransRequest.IcbuTranslateTaskDTO obj1 = new AlibabaIcbuTextTransRequest.IcbuTranslateTaskDTO();
obj1.setTransEngine("ALI_TRANS");
obj1.setTargetLanguage("es");
obj1.setAppName("xiaoman");
obj1.setSourceText("this is a test text");
obj1.setFormat("text");
obj1.setFieldType("title");
obj1.setParamMap("{\"key\":\"value\"}");
obj1.setSourceLanguage("en");
req.setIcbuTranslateTaskDto(obj1);
AlibabaIcbuTextTransResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_icbu_text_trans_response>
    <result>
        <icbu_translate_result_d_t_o>
            <error_code>
                <code>10001</code>
                <display_text>Params is illegal</display_text>
            </error_code>
            <trace_id>210764d516876720847747520e432e</trace_id>
            <trans_engine>ALI_TRANS</trans_engine>
            <source_text>this is a text</source_text>
            <translate_result_text>this is a text</translate_result_text>
            <field_type>title</field_type>
            <source_language>en</source_language>
            <target_language>es</target_language>
            <format>text</format>
            <param_map>aaa</param_map>
            <app_name>xiaoman</app_name>
            <ext>aaa</ext>
            <trans_char>100</trans_char>
            <success>true</success>
        </icbu_translate_result_d_t_o>
    </result>
</alibaba_icbu_text_trans_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部