帮助与文档 > 产品文档 > 自然语言翻译服务 > API文档 > 大模型翻译
大模型翻译

大模型翻译简介

概念解释

输入一段文本,根据指定模型和目标语种,返回翻译结果,翻译结果以 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 处理模式选项 模型名称 参考下方 处理模式选项
--签名生成方法如下(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
自动识别 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时生效

增量返回示例

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

全量返回示例

{"code":"0","message":"success","data":{"transFull":"Hi"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi,"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to meet"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to meet you"},"requestId":"1762951947136-700704342024750-326","successful":true}
{"code":"0","message":"success","data":{"transFull":"Hi, nice to meet you!"},"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)生效

API错误代码列表

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

常用语言 Demo

Java 示例

暂无

python3 示例

python demo

go 示例

暂无