输入一段文本,根据指定模型和目标语种,返回翻译结果,翻译结果以 SSE 方式流式返回。
Hi,您好,欢迎使用有道智云接口服务。
本文档主要针对需要集成HTTP API的技术开发工程师,详细描述接口计费,入参,返回值等信息。
如果您有与我们商务合作的需求,可以通过以下方式联系我们:
商务邮箱: AIcloud_Business@corp.youdao.com
如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:
客服QQ:1906538062
AIGC产品技术交流群 :837394306
联系邮箱: zhiyun@corp.youdao.com
温馨提示:
调用方在集成本接口时,请遵循以下规则。
| 规则 | 描述 |
|---|---|
| 传输方式 | 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 | 处理模式选项 | 模型名称 | 否 | 参考下方 处理模式选项 |
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 --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)生效 |
| 状态码 | 状态码含义 |
|---|---|
| 0 | 成功 |
| 1 | 未知错误,请联系客服 |
| 101 | 缺少必填的参数,首先确保必填参数齐全,然后,确认参数书写是否正确。 |
| 108 | 应用ID无效,注册账号,登录后台创建应用并完成绑定,可获得应用ID和应用密钥等信息 |
| 110 | 当前应用ID没有权限访问此服务,需要在控制台给当前应用ID开通此服务 |
| 112 | 请求的服务不存在 |
| 202 | 签名检验失败 |
| 206 | 因为时间戳无效导致签名校验失败 |
| 207 | 重放请求 |
| 902000 | 大模型翻译调用失败 |
暂无
暂无