Azure Translator是翻译服务的基于云的 REST API 功能。 它使用神经机器翻译技术，跨所有 支持的语言实时实现快速准确的源到目标文本翻译。 在本概述中，你将了解如何使用文本翻译 REST API 为应用程序和工作流构建智能解决方案。
文本翻译文档包含以下文章类型：
- 快速入门。 指导你完成向服务发出请求的入门说明。
- 操作指南。 有关以更具体的方式或自定义方式访问和使用服务的说明。
- 参考文章。 REST API 文档和基于编程语言的内容。
文本翻译功能
最新的 GA 版本使用 API 版本 3.0。
语言。 返回“翻译”、“音译”和“字典查找”操作支持的语言列表 。 此请求不需要身份验证。 将以下
GET请求复制并粘贴到首选 REST API 工具或浏览器中：https://api.translator.azure.cn/languages?api-version=3.0翻译。 使用单个请求将单个源语言文本呈现为多个目标语言文本。
直译。 将源语言的字符或字母转换为目标语言的对应字符或字母。
检测. 返回源代码语言代码以及用于指示文本翻译和音译是否支持检测到的语言的布尔变量。
注释
可以使用单个 REST API 调用翻译、转译和检测文本。
字典查找。 返回源术语在目标语言中的等效字词。
字典示例。 返回源术语和目标术语对的语法结构和上下文示例。
文本翻译开发选项
使用以下资源将文本翻译添加到项目和应用程序：
| 发展选项 | Description |
|---|---|
| REST API | 使用 REST API （GA） 版本将翻译集成到应用程序中。 |
| 客户端库（SDK） | 使用各种编程语言中的可用 客户端库（SDK） 将翻译功能集成到应用程序中。 |
Authentication
每个文本翻译请求都需要身份验证标头。 支持下列方法：
| 方法 | Description |
|---|---|
| 资源密钥 | 使用 Translator 资源的密钥传递Ocp-Apim-Subscription-Key标头。 |
| 持有者令牌 | 将您的资源密钥从令牌服务中交换获取时间限制令牌，并在Authorization标头中传递它。 |
| Microsoft Entra ID | 使用托管身份或服务主体在不管理密钥的情况下获取访问令牌。 |
有关详细信息和示例，包括区域终结点和自定义终结点所需的标头， 请参阅身份验证和授权。
服务限制和定价
文本翻译执行服务限制和配额，例如每次请求的字符限制。
- 有关请求限制和配额，请参阅 服务限制 - 翻译器。
- 有关定价，请参阅 Azure Translator 定价。
故障排除
如果请求失败，请从 HTTP 状态代码和服务特定的错误代码开始。
| 症状 | 可能的原因 | 解决方案 |
|---|---|---|
401 Unauthorized |
订阅密钥无效或缺失。 | 验证该值 Ocp-Apim-Subscription-Key 是否与翻译器资源密钥匹配。 |
403 Forbidden |
密钥有效，但资源无权执行所请求的操作。 | 确认定价层支持该功能，并且资源区域与终结点匹配。 |
429 Too Many Requests |
超出请求速率限制或字符限制。 | 减少请求频率或查看服务限制中的配额 - 翻译器。 |
400 Bad Request |
格式不正确的请求正文或不支持的语言代码。 | 验证 JSON 有效负载并检查 支持的语言。 |
- 有关状态代码和错误消息的完整列表，请参阅 响应代码和消息。
文本翻译入门
按照以下步骤开始使用文本翻译：
获取访问密钥和 API 端点。 需要终结点 URL 和只读密钥进行身份验证。
请探索文本翻译快速入门，以获取以下编程语言的用例和代码示例：