分享方式:


Azure 文字翻譯 SDK (預覽)

重要

  • 目前翻譯工具文字 SDK 處於公開預覽狀態。 根據使用者意見反應,功能、方法和流程在正式發行 (GA) 之前可能會有所變更。

Azure 文字翻譯是 Azure AI 翻譯工具服務的雲端式 REST API 功能。 文字翻譯 API 可讓您即時進行快速且精確的來源對目標文字翻譯。 文字翻譯軟體開發套件 (SDK) 是一組程式庫和工具,可讓您輕鬆地將文字翻譯 REST API 功能整合到應用程式中。 您可在 C#/.NET、Java、JavaScript 和 Python 的程式設計平台上使用文字翻譯 SDK。

支援的語言

文字翻譯 SDK 支援以下程式設計語言和平台:

語言→ SDK 版本 套件 用戶端程式庫 支援的 API 版本
.NET/C# → 1.0.0-beta.1 NuGet (英文) Azure SDK for .NET 翻譯工具 3.0 版
Java✱ → 1.0.0-beta.1 MVN 存放庫 Azure SDK for Java 翻譯工具 3.0 版
JavaScript → 1.0.0-beta.1 npm \(英文\) Azure SDK for JavaScript 翻譯工具 3.0 版
Python → 1.0.0b1 PyPi Azure SDK for Python 翻譯工具 3.0 版

✱ 已在 Windows、Linux 和 macOS 平台上測試並支援適用於 Java 的 Azure 文字翻譯 SDK。 未在其他平台上進行測試,也不支援 Android 部署。

變更記錄和版本歷程記錄

本節提供文字翻譯特徵和功能版本、變更、更新和增強功能的版本描述。

翻譯工具文字 SDK 2023 年 4 月預覽版本

此版本包括下列更新︰

  • 版本 1.0.0-beta.1 (2023-04-17)
  • 目標文字翻譯 3.0 版
  • 初始版本發行版本

套件 (NuGet)

變更記錄/版本歷程記錄

讀我檔案

範例

在應用程式中使用文字翻譯 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 金鑰:

Screenshot of the keys and endpoint location in the Azure portal.

使用全域端點 (預設)

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 Q&AStack Overflow 論壇可供開發人員社群詢問和回答有關 Azure 文字翻譯和其他服務的問題。 Microsoft 會監視論壇,並回覆社群尚未回答的問題。 若要確保我們會看到您的問題,請使用 azure-text-translation 加以標記。

下一步