文档首页 > > API参考> API> 机器翻译服务接口说明> 文本翻译

文本翻译

分享
更新时间: 2020/04/15 GMT+08:00

功能介绍

文本翻译是为了实现语种间的转换。对于用户输入原始语种的文本,转换为目标语种的文本。

具体Endpoint请参见终端节点

机器翻译服务当前为公测免费阶段,用户可以在管理控制台申请公测资格进行免费调用。

URI

  • URI格式
    POST /v1/{project_id}/machine-translation/text-translation
  • 参数说明
    表1 URI参数说明

    参数名

    必选

    说明

    project_id

    来自公有云的Project ID,用于资源隔离。获取方式请参见获取项目ID

请求消息

请求参数说明请参见 表2
表2 请求参数说明

参数名

参数类型

必选

说明

text

String

仅支持utf-8编码,长度不超过1000字符。

from

String

翻译原语言,具体取值见下表。

to

String

翻译目标语言,具体取值见下表。

scene

String

默认为“common”,当前只有通用场景。

表3 支持的语言列表

语言(from)

语言(to)

说明

zh

en

中文翻译为英文。

en

zh

英文翻译为中文。

auto

en

自动识别原文语种,若支持翻译为英文,则将原文语种翻译成英文。

auto

zh

自动识别原文语种,若支持翻译为中文,则将原文语种翻译成中文。

响应消息

响应参数说明请参见 表4
表4 响应参数说明

参数名

参数类型

说明

src_text

String

调用成功时表示翻译原文,编码格式为UTF-8。

调用失败时无此字段。

translated_text

String

调用成功时表示调用结果,编码格式为UTF-8。

调用失败时无此字段。

from

String

调用成功时表示源语种(源语种输入为auto时,显示语种识别结果),编码格式为UTF-8。

调用失败时无此字段。

to

String

调用成功时表示目标语种,编码格式为UTF-8。

调用失败时无此字段。

error_code

String

调用失败时的错误码,具体请参见错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例
    POST https://{endpoint}/v1/{project_id}/machine-translation/text-translation
       
    Request Header:  
        Content-Type:application/json
        X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
    
    Request Body:
        {
            "text": "欢迎使用机器翻译服务",
            "from": "zh",
            "to": "en",
            "scene":"common"
        }  
  • 成功响应示例
    {
        "src_text": "欢迎使用机器翻译服务",
        "translated_text": "Welcome to use machine translation services",
        "from": "zh",
        "to": "en"
    }
  • 失败响应示例
    {
        "error_code": "NLP.0101",
        "error_msg": "Authentication failed. Verify the token."
    }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问