产品文档-自然语言翻译服务 | 有道智云AI开放平台

大模型翻译简介

概念解释

输入一段文本，根据指定模型和目标语种，返回翻译结果，翻译结果以 SSE 方式流式返回。

说明

Hi，您好，欢迎使用有道智云接口服务。

本文档主要针对需要集成HTTP API的技术开发工程师，详细描述接口计费，入参，返回值等信息。

如果您有与我们商务合作的需求，可以通过以下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

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

客服QQ：1906538062

AIGC产品技术交流群：837394306

联系邮箱： zhiyun@corp.youdao.com

温馨提示：

本文档主要针对开发人员，接入测试前需要获取应用ID和应用密钥，并创建应用；如果您还没有，请按照新手指南获取。
平台向每个账户赠送50元的体验金，供用户集成前测试所用。

协议须知

调用方在集成本接口时，请遵循以下规则。

规则	描述
传输方式	HTTPS
请求方式	POST
字符编码	统一使用UTF-8 编码
请求格式	application/json
响应格式	text/event-stream

接口定义

任务提交接口：

https://openapi.youdao.com/proxy/http/llm-trans

请求参数

参数名称	类型	含义	是否必填	示例或描述
appKey	string	应用ID	是	可在应用管理查看
salt	string	随机值	是
curtime	string	时间戳（单位到秒）	是	例如：1757560399
sign	string	签名	是	参见下方的签名生成方法
i	string	待翻译文本	是	必须是UTF-8编码，限制5000字符
prompt	string	提示词	否	必须是UTF-8编码，限制1200字符、400单词
from	string	源语言	是	参考下方支持语言 (可设置为auto)
to	string	目标语言	是	参考下方支持语言 (可设置为auto)
streamType	string	流式返回类型	否	参考下方流式返回类型
handleOption	处理模式选项	模型名称	否	参考下方处理模式选项
vocabId	text	用户上传的术语表	否	用户指定的术语表ID： out_id，支持英中互译，更多语种方向请前往控制台查询
enableInterTrans	boolean	开启指定语种互译	否	开启后,会根据输入内容的语种,实现 from 和 to 语种间的互译

--签名生成方法如下(v3)

sign=sha256(appKey+input+salt+curtime+应用密钥)；
其中，
1. 当 i 长度小于等于20时，input=i;
2. 当 i 长度大于20时，input=i前10个字符 + i长度 + i后10个字符；

支持语言

支持以下语种的互译

语言	语言代码
中文	zh-CHS
英语	en
韩语	ko
日语	ja
法语	fr
俄语	ru
西班牙语	es
葡萄牙语	pt
印地语	hi
阿拉伯语	ar
丹麦语	da
德语	de
芬兰语	fi
意大利语	it
马来语	ms
荷兰语	nl
瑞典语	sv
泰语	th
乌克兰语	uk
越南语	vi
繁体中文	zh-CHT
波斯尼亚语	bs
加泰隆语	ca
爱沙尼亚语	et
匈牙利语	hu
印度尼西亚语	id
挪威语	no
波兰语	pl
罗马尼亚语	ro
土耳其语	tr
世界语	eo
菲律宾语	tl
哈萨克语	kk
高棉语	km
缅甸语	my
尼泊尔语	ne
藏语	bo
维语	ug
书面挪威语	nob
新挪威语	nno
粤语	yue
自动识别	auto

当from=auto时，会对原文进行语言检测。
当to=auto时，默认翻译为中文，如果原文是中文，默认翻译为英文。

流式返回类型

streamType 取值	含义	备注
increment	译文文本按照“增量形式”返回	默认按此方式返回
full	译文文本按照“全量形式”返回
all	同时返回“增量形式”、“全量形式”译文

响应结果

响应结果中会包含多条如下结果的消息，直到翻译结束

字段	类型	含义
code	String	错误码，参见最下方的错误码表
message	String	错误信息
requestId	String	本次请求唯一标识
successful	boolean	本条消息是否成功
data	Object	翻译结果
data.transFull	String	全量翻译结果，当 streamType为full或all时生效
data.transIncre	String	增量翻译结果，当 streamType为increment或all时生效
data.langType	String	翻译结果的语种

增量返回示例

{"code":"0","message":"success","data":{"transIncre":"Hello","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":",","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":" I","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":"'m","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":" very","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":" glad","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":" to","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":" meet","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":" you","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}
{"code":"0","message":"success","data":{"transIncre":"!","langType":"en"},"requestId":"1762951633928-57553213756784383-607","successful":true}

全量返回示例

{"code":"0","message":"success","data":{"transFull":"Hi","langType":"en"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi,","langType":"en"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice","langType":"en"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to","langType":"en"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to meet","langType":"en"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to meet you","langType":"en"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to meet you!","langType":"en"},"requestId":"1762951947136-700704342024750-326","successful":true}

错误返回

{"code":"400","message":"'i'不能为空;","requestId":"1762952113361-700870567400125-470","successful":false}

curl 调用示例

curl --location --request POST 'https://openapi.youdao.com/proxy/http/llm-trans' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'appKey=30a9947ce556b8e3' \
--data-urlencode 'salt=09d703a3-e79d-41b9-ab92-2a19f9426cec' \
--data-urlencode 'signType=v3' \
--data-urlencode 'sign=66215f51c43fe4d357a74cd73b3af6792a08a5d5734de88563f5f072b9c2bee0' \
--data-urlencode 'curtime=1762952138' \
--data-urlencode 'i=你好，很高兴认识你！' \
--data-urlencode 'handleOption=0' \
--data-urlencode 'from=auto' \
--data-urlencode 'to=en' \
--data-urlencode 'streamType=full' \

处理模式选项

handleOption取值	含义
0	有道子曰翻译pro版本(14B)处理请求，通用pro翻译模型仅提供翻译功能，参数中的 prompt 仅对通用翻译模型(handleOption=0/3)生效
3	有道子曰翻译lite版本(1.5B)处理请求，lite翻译模型仅提供翻译功能，参数中的 prompt 仅对通用翻译模型(handleOption=0/3)生效

服务配置

支持语种	支持的 qps
详见语种列表	10

API错误代码列表

状态码	状态码含义
0	成功
1	未知错误，请联系客服
101	缺少必填的参数，首先确保必填参数齐全，然后，确认参数书写是否正确。
108	应用ID无效，注册账号，登录后台创建应用并完成绑定，可获得应用ID和应用密钥等信息
110	当前应用ID没有权限访问此服务，需要在控制台给当前应用ID开通此服务
112	请求的服务不存在
202	签名检验失败
206	因为时间戳无效导致签名校验失败
207	重放请求
902000	大模型翻译调用失败

常用语言 Demo

Java 示例

暂无

python3 示例

python demo

go 示例

暂无

大模型翻译简介 ​

概念解释 ​

说明 ​

协议须知 ​

接口定义 ​

任务提交接口： ​

请求参数 ​

--签名生成方法如下(v3) ​

支持语言 ​

流式返回类型 ​

响应结果 ​

增量返回示例 ​

全量返回示例 ​

错误返回 ​

curl 调用示例 ​

处理模式选项 ​

服务配置 ​

API错误代码列表 ​

常用语言 Demo ​

Java 示例 ​

python3 示例 ​

go 示例 ​