“彩云小译API/zh”的版本间的差异

来自集智百科
跳转到: 导航搜索
申请访问令牌
 
(未显示2个用户的27个中间版本)
第1行: 第1行:
{{Languages|en|zh}}
+
<div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right">
 +
<div>
 +
[[彩云小译API/en|English]]·[[彩云小译API/ja|日本语]]·[[彩云小译API/zh|中文]]
 +
</div>
 +
<div>
 +
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]
 +
</div>
 +
</div>
  
=彩云小译 API  做什么?=
+
= 能用 彩云小译 API 做什么?=
  
 彩云小译 API 可以用来把 '''信息''' 翻译到 另外一种 指定的语言 我们可以支持 文本、网页 、pdf/docx 文档、语音 等多种形式。
+
 彩云小译 API 可以用来把'''信息'''翻译到指定的语言 我们可以支持文本、网页 、PDF/Word 文档、语音 、视频 等多种形式。
  
 您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。
+
 您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。 例如:彩云小译 API 是维基百科自动翻译的技术提供者,也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。
 +
 
 +
===维基百科内容翻译===
 +
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]
 +
===石墨文档翻译===
 +
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]
  
 
= 一分钟介绍=
 
= 一分钟介绍=
第13行: 第25行:
 
=== 申请访问令牌===
 
=== 申请访问令牌===
  
* 请发邮件至 [mailto:api@caiyunapp.com api@caiyunapp.com] 申请获得 访问令牌 。来信请 介绍 您需要用小译 API 做什么?我们会回信 把 token 发送 给您。
+
如果你要测试,可以使用 '''3975l6lr5pcbvidl6jl2''' 作为测试 Token,我们不保证该 Token 的可用性,所以如果要持续使用,还 申请正式 Token。
 +
 
 +
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号,再 发邮件至 [mailto:api@caiyunapp.com api@caiyunapp.com] 申请获得 Token 。来信请 附上您注册开放平台的邮箱,及 您需要用小译 API 做什么? 申请通过后 我们会 帮您创建 Token 并 回信给您 ,您即可在开放平台查看 Token 使用小译 API
 
* 请修改邮件标题为: "申请彩云小译 API Token",同时邮件内容请提供: 姓名,手机号,用途等说明文字。
 
* 请修改邮件标题为: "申请彩云小译 API Token",同时邮件内容请提供: 姓名,手机号,用途等说明文字。
  
第36行: 第50行:
 
fi
 
fi
  
BODY='{"source": "'\$SOURCE'", "trans_type": "'\$DIRECTION'", "request_id": "demo", "media":"text" }'
+
BODY='{"source": ["'\$SOURCE'"], "trans_type": "'\$DIRECTION'", "replaced": true, "media": "text", "request_id": "demo" }'
  
 
export PYTHONIOENCODING=utf8
 
export PYTHONIOENCODING=utf8
第65行: 第79行:
 
===python 调用===
 
===python 调用===
  
 请把 YOUR_TOKEN 设置为你的 token
+
 请把 YOUR_TOKEN 设置为你的 token ,并发请求的速度会是逐个请求的数倍,如有可能,请将长度类似的 20-40 个句子打包请求,下面是实例代码。
  
 
<source lang="python">
 
<source lang="python">
第73行: 第87行:
 
url = "http://api.interpreter.caiyunai.com/v1/translator"
 
url = "http://api.interpreter.caiyunai.com/v1/translator"
  
payload = "{\"source\":\"Lingocloud is the best translation service.\",\"trans_type\": \"en2zh\", \"request_id\": \"a11111\", \"replaced\": true,\"cached\": false}"
+
#WARNING, this token is a test token for new developers, and it should be replaced by your token
 +
token = YOUR_TOKEN
 +
 
 +
payload = {
 +
        "source" : ["Lingocloud is the best translation service.",  
 +
                    "ColorfulClouds Weather is the best weather service."],
 +
        "trans_type" : "en2zh",
 +
        "request_id" : "demo",
 +
        }
 +
 
 
headers = {
 
headers = {
    'content-type': "application/json",
+
        'content-type': "application/json",
    'x-authorization': "token YOUR_TOKEN",
+
        'x-authorization': "token " + token,
 
}
 
}
  
response = requests.request("POST", url, data=payload, headers=headers)
+
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)
  
 
print(response.text)
 
print(response.text)
print(json.loads(response.text)['target'])
+
print(json.loads(response.text)['target'][0])
  
 
</source>
 
</source>
第88行: 第111行:
 
 输出为:
 
 输出为:
 
<source lang="javascript">
 
<source lang="javascript">
{"confidence":0.9938237638,"target":"\u5c0f\u8bd1\u662f\u6700\u597d\u7684\u7ffb\u8bd1\u670d\u52a1\u3002","isdict":0,"rc":0}
+
{"confidence":0.8,"target":["\u5f69\u4e91\u5c0f\u8bd1\u662f\u6700\u597d\u7684\u7ffb\u8bd1\u670d\u52a1\u3002",
 +
"\u5f69\u4e91\u5929\u6c14\u662f\u6700\u597d\u7684\u6c14\u8c61\u670d\u52a1\u3002"],"rc":0}
  
  小译是最好的翻译服务。
+
彩云 小译是最好的翻译服务。
</source>
+
彩云天气是最好的气象服务。
  
=== 并发请求 ===
 
 
并发请求的速度会是逐个请求的数倍,如有可能,请将长度类似的 20-40 个句子打包请求,下面是并发请求的实例代码。
 
 
<source lang="python">
 
import requests
 
import json
 
 
url = "http://api.interpreter.caiyunai.com/v1/translator"
 
 
payload = "{\"source\":[\"Lingocloud is the best translation service.\", \"ColorfulClouds Weather is the best weather service.\"],\"trans_type\": \"en2zh\", \"request_id\": \"a11111\", \"replaced\": true,\"cached\": false}"
 
headers = {
 
    'content-type': "application/json",
 
    'x-authorization': "token YOUR_TOKEN",
 
}
 
 
response = requests.request("POST", url, data=payload, headers=headers)
 
 
print(response.text)
 
print(json.loads(response.text)['target'][0])
 
print(json.loads(response.text)['target'][1])
 
 
</source>
 
</source>
  
第128行: 第131行:
 
|-
 
|-
 
! 英语 en
 
! 英语 en
| <source lang="bash">en2zh</source> || - || -
+
| en2zh || - || -
 
|-
 
|-
 
! 日文 ja
 
! 日文 ja
| <source lang="bash">ja2zh</source> || - || -
+
| ja2zh || - || -
 
|}
 
|}
  

2018年11月20日 (二) 18:16的最后版本

English·日本语·中文

API spec

目录

[编辑] 能用彩云小译 API 做什么?

彩云小译 API 可以用来把信息翻译到指定的语言,我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。

您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如:彩云小译 API 是维基百科自动翻译的技术提供者,也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。

[编辑] 维基百科内容翻译

Screen Shot 2018-09-06 at 11.03.18 PM.png

[编辑] 石墨文档翻译

Screen Shot 2018-09-06 at 11.22.04 PM.png

[编辑] 一分钟介绍

下面的一分钟介绍,我们制作一个命令行工具,可以让你翻译简短的一句话。

[编辑] 申请访问令牌

  • 如果你要测试,可以使用 3975l6lr5pcbvidl6jl2 作为测试 Token,我们不保证该 Token 的可用性,所以如果要持续使用,还请申请正式 Token。
  • 请先至彩云科技开放平台注册账号,再发邮件至 api@caiyunapp.com 申请获得 Token。来信请附上您注册开放平台的邮箱,及您需要用小译 API 做什么?申请通过后我们会帮您创建 Token 并回信给您,您即可在开放平台查看 Token 使用小译 API。
  • 请修改邮件标题为: "申请彩云小译 API Token",同时邮件内容请提供: 姓名,手机号,用途等说明文字。
  • 每月翻译100万字之内都是免费的,如果您每月超过100万字,我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算,包含空格和标点)

[编辑] 文本翻译

执行下述 BASH 命令创建命令行工具 xiaoyi.sh

#!/bin/bash
tee xiaoyi.sh << END
DIRECTION=\$1
SOURCE=\$2
 
if test -f \$HOME/.xiaoyi ; then
  . \$HOME/.xiaoyi
else
  echo "Please input your token: "
  read TOKEN
  echo "TOKEN=\$TOKEN" > \$HOME/.xiaoyi
fi
 
BODY='{"source": ["'\$SOURCE'"], "trans_type": "'\$DIRECTION'", "replaced": true, "media": "text", "request_id": "demo" }'
 
export PYTHONIOENCODING=utf8
curl -s -X POST http://api.interpreter.caiyunai.com/v1/translator\
      -H 'Content-Type: application/json'\
      -H "X-Authorization: token \$TOKEN"\
      -d "\$BODY" | python -c "import sys, json; print json.load(sys.stdin)['target']"
END

再按照下面的方式执行 xiaoyi.sh 就会得到翻译结果

sh xiaoyi.sh en2zh "You know some birds are not meant to be caged, their feathers are just too bright."
你知道有些鸟不应该被关在笼子里,它们的羽毛太亮了。
sh xiaoyi.sh ja2zh "薄紅の秋の実に"
淡红色的秋天的果实

备注:第一次执行 xiaoyi.sh 时会要求输入访问令牌 Token 。

[编辑] 进阶使用

[编辑] python 调用

请把 YOUR_TOKEN 设置为你的 token,并发请求的速度会是逐个请求的数倍,如有可能,请将长度类似的 20-40 个句子打包请求,下面是实例代码。

import requests
import json
 
url = "http://api.interpreter.caiyunai.com/v1/translator"
 
#WARNING, this token is a test token for new developers, and it should be replaced by your token
token = YOUR_TOKEN
 
payload = {
        "source" : ["Lingocloud is the best translation service.", 
                     "ColorfulClouds Weather is the best weather service."], 
        "trans_type" : "en2zh",
        "request_id" : "demo",
        }
 
headers = {
        'content-type': "application/json",
        'x-authorization': "token " + token,
}
 
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)
 
print(response.text)
print(json.loads(response.text)['target'][0])

输出为:

{"confidence":0.8,"target":["\u5f69\u4e91\u5c0f\u8bd1\u662f\u6700\u597d\u7684\u7ffb\u8bd1\u670d\u52a1\u3002",
"\u5f69\u4e91\u5929\u6c14\u662f\u6700\u597d\u7684\u6c14\u8c61\u670d\u52a1\u3002"],"rc":0}
 
彩云小译是最好的翻译服务。
彩云天气是最好的气象服务。

[编辑] 支持的语言

目前支持的语言和翻译方向如下表所示

To
From
中文 zh 英语 en 日文 ja
中文 zh - zh2en zh2ja
英语 en en2zh - -
日文 ja ja2zh - -

API 即将推出自动识别语种的功能。2018年底将支持到15种以上语言,200种以上语言方向。

[编辑] 想要更多?

个人工具
名字空间
操作
导航
工具箱