Azure Translator 是 Azure Translator 的雲端 REST API 功能。 文字翻譯 API 可讓您即時進行快速且精確的來源對目標文字翻譯。 文字翻譯軟體開發工具組 （SDK） 是一組連結庫和工具，可讓您輕鬆地將文字翻譯 REST API 功能整合到應用程式中。 文字翻譯 SDK 可在 C#/.NET、Java、JavaScript 和 Python 的程式設計平臺上使用。
支援的語言
文字翻譯 SDK 支援程式設計語言和平臺：
| 語言→ SDK 版本 | Package | 用戶端程式庫 | 支援的 API 版本 |
|---|---|---|---|
| .NET/C# → 1.0.0 | NuGet | 適用於 .NET 的 Azure SDK | 翻譯工具 3.0 版 |
| Java✱ → 1.0.0 | Maven 存放庫 | 適用於 Java 的 Azure SDK | 翻譯工具 3.0 版 |
| JavaScript → 1.0.0 | npm | 適用於 JavaScript 的 Azure SDK | 翻譯工具 3.0 版 |
| Python → 1.0.1 | PyPi | 適用於 Python 的 Azure SDK | 翻譯工具 3.0 版 |
✱ Azure Translator SDK for Java 已在 Windows、Linux 及 macOS 平台上測試並支援。 它不會在其他平台上進行測試，且不支援Android部署。
變更記錄和版本歷程記錄
本節提供文字翻譯特徵和功能版本、變更、更新和增強功能的版本描述。
Azure Translator in Foundry Tools Text SDK May 2024 (正式發行) 版本
此版本包括下列更新︰
- 版本 1.0.0 （2024-05-21）
- 目標文字翻譯 3.0 版
- GA 版本發布
Azure Translator in Foundry Tools Text SDK 2023年4月預覽版
此版本包括下列更新︰
- 版本 1.0.0-beta.1 （2023-04-17）
- 目標文字翻譯 3.0 版
- 初始版本釋出
在應用程式中使用文字翻譯 SDK
文字翻譯 SDK 可讓您在應用程式中使用和管理文字翻譯服務。 SDK 是以基礎文字翻譯 REST API 為基礎，可讓您輕鬆地在程式設計語言範例內使用這些 API。 以下是您針對慣用程式設計語言使用文字翻譯 SDK 的方式：
1. 安裝 SDK 用戶端程式庫
dotnet add package Azure.AI.Translation.Text --version 1.0.0-beta.1
Install-Package Azure.AI.Translation.Text -Version 1.0.0-beta.1
2. 將 SDK 用戶端程式庫匯入您的應用程式中
using Azure;
using Azure.AI.Translation.Text;
3.驗證用戶端
使用用戶端函式庫與翻譯器的互動始於建立類別的實例 TextTranslationClient。 您需要 API 金鑰和區域來具現化客戶端物件。
在 Azure 入口網站中找到文字翻譯 API 金鑰：
使用全域端點 （預設值）
string key = "<your-key>";
AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);
使用區域端點
Uri endpoint = new("<your-endpoint>");
string key = "<your-key>";
string region = "<region>";
AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential, region);
4. 建置應用程式
建立客戶端物件以與文字翻譯 SDK 互動，然後在該客戶端物件上呼叫方法來與服務互動。 SDK 同時提供同步和非同步方法。 如需詳細資訊， 請參閱 適用於 .NET/C# 的文字翻譯 範例存放庫 。
幫助選項
Microsoft 問答與 Stack Overflow 論壇供開發者社群提出並回答有關 Azure Translator 及其他服務的問題。 Microsoft 會監視論壇，並回覆社群尚未回答的問題。 若要確保我們會看到您的問題，請使用 azure-text-translation 加以標記。