一个人工智能的服务从微软Azure,使您能够轻松地进行实时文本翻译。
介绍
微软翻译文本API提供了一个基于json的Web API。它提供了:
- 任何受支持的语言之间的翻译其他语言支持。
- 在一个请求中翻译多种语言。
- 音译将文本从一个脚本到另一个相同的脚本语言。
- 在一个请求中语言检测、翻译、音译。
- 字典查找替代术语的翻译,发现back-translations和示例显示术语在一定的环境中使用。
- 丰富的语言检测。
基础url
翻译文本云API提供以下:
| 描述 | 地区 | 基URL |
|---|---|---|
| Azure | 全球 | api.cognitive.microsofttranslator.com |
| Azure | 欧洲 | api-eur.cognitive.microsofttranslator.com |
身份验证
订阅翻译文本API, Azure认知服务的一部分,并使用您的订阅从Azure门户进行身份验证。您可以遵循的步骤https://docs.microsoft.com/en-us/azure/cognitive-services/translator/translator-text-how-to-signup。
最简单的方式是通过你的Azure密钥使用http请求头的翻译服务Ocp-Apim-Subscription-Key。
如果你喜欢使用一个短暂的认证,你可以用你的密钥获取授权牌从牌服务。在这种情况下,你将授权令牌传递给使用的翻译服务授权请求头。获得授权令牌,做一个帖子要求以下网址:
| 环境 | 身份验证服务的URL |
|---|---|
| Azure | https://api.cognitive.microsoft.com/sts/v1.0/issueToken |
以下是示例请求获得令牌与一生的10分钟,给定一个秘密密钥:
/ /通过密钥使用头卷发——头Ocp-Apim-Subscription-Key: <你>的数据”““https://api.cognitive.microsoft.com/sts/v1.0/issueToken”/ /传递密钥使用查询字符串参数curl -数据”““https://api.cognitive.microsoft.com/sts/v1.0/issueToken?Subscription-Key= <你>”一个成功的请求返回纯文本的编码访问令牌响应体。有效的令牌传递给翻译服务作为持票人令牌授权。
授权:无记名< Base64-access_token >身份验证令牌有效期为10分钟。令牌时应该重用对翻译进行多个调用api。如果你请求翻译API在一段时间,你必须请求一个新的访问令牌定期在令牌到期之前,例如每9分钟。
总而言之,一个客户端请求翻译API将包括一个授权头从下表:
| 头 | 描述 |
|---|---|
| Ocp-Apim-Subscription-key | 使用与认知服务订阅如果你传递密钥。Azure密钥的值是您订阅的翻译文本的API。 |
| 授权 | 使用与认知服务订阅如果你传递身份验证令牌。值是不记名令牌:持票人<标记>。 |
一体化的订阅
最后一个身份验证选项是使用认知订阅服务的一体化。这允许您使用一个密钥对多个服务请求进行身份验证。
当你使用一个一体化的密钥,你必须包括两个认证头和你的请求。第一个通过了密钥,第二个指定区域与你的订阅。Ocp-Api-Subscription-KeyOcp-Apim-Subscription-Region
如果你通过密钥在查询字符串参数Subscription-Key,那么你必须指定地区的查询参数Subscription-Region。
如果你使用不记名的令牌,你必须从区域端点获取令牌:https:// <你所在地区>.api.cognitive.microsoft.com/sts/v1.0/issueToken。
可用的地区是:australiaeast,brazilsouth,canadacentral,centralindia,centraluseuap,eastasia,eastus,eastus2,japaneast,northeurope,southcentralus,southeastasia,uksouth,westcentralus,westeurope,westus,westus2。
区域一体化的文本API需要订阅。
错误
标准错误的响应是一个JSON对象名称/值对错误。也是一个JSON对象的属性值:
代码:server-defined错误代码。消息错误的:给人类可读的字符串表示。
例如,一个客户免费试用订阅收到以下错误一旦免费配额筋疲力尽:
{"错误":{“代码”:403000年,“消息”:“订阅已超过它的免费配额。”} }输入您的订阅键尝试微软翻译。
选择授权按钮,输入您的微软翻译订阅键,或你的所有在一个认知服务订阅的关键。如果您使用的是所有在一个认知服务关键你也需要输入您的订阅。
可用的地区是:
australiaeast,brazilsouth,canadacentral,centralindia,centraluseuap,eastasia,eastus,eastus2,japaneast,northeurope,southcentralus,southeastasia,uksouth,westcentralus,westeurope,westus,westus2。