文件翻譯 SDK
文件翻譯是 Azure AI 翻譯工具服務的雲端式 REST API 功能。 文件翻譯 API 能以支援的語言和各種檔案格式，以非同步方式快速準確地進行來源到目標的完整文件翻譯。 文件翻譯軟體開發套件 (SDK) 是一組程式庫和工具，可讓您輕鬆地將文件翻譯 REST API 功能整合到應用程式中。
支援的語言
文件翻譯 SDK 支援下列程式設計語言：
| 語言→ SDK 版本 | 套件 | 用戶端程式庫 | 支援的 API 版本 |
|---|---|---|---|
| 🆕 .NET/C# → 2.0.0-beta.1 | NuGet (英文) | Azure SDK for .NET | 文件翻譯 api-version=2024-05-01 |
| 🆕 Python → 1.1.0b1 | PyPi | Azure SDK for Python | 文件翻譯 api-version=2024-05-01 |
變更記錄和版本歷程記錄
本節針對文件翻譯的特性和功能發行、變更、更新和增強，提供了以版本為基礎的描述。
版本 2.0.0-beta.1
2024-05-07
變更記錄/版本歷程記錄
讀我檔案
範例
在您的應用程式中使用文件翻譯 SDK
文件翻譯 SDK 可讓您在應用程式中使用和管理翻譯服務。 SDK 建置於基礎文件翻譯 REST API 上，可在您的程式設計語言範例內使用。 請選擇您慣用的程式設計語言：
1.安裝 SDK 用戶端程式庫
dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta.1
Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1
2.將 SDK 用戶端程式庫匯入您的應用程式中
3.驗證用戶端
建立 DocumentTranslationClient 物件的執行個體以與文件翻譯 SDK 互動，然後在該用戶端物件上呼叫方法以與服務互動。
DocumentTranslationClient 是使用文件翻譯用戶端程式庫的主要介面。 它提供同步和非同步方法來執行作業。
非同步批次轉譯
private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";
DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));
同步單一文件翻譯
private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";
SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
4.建置應用程式
非同步批次轉譯
文件翻譯批次介面需要下列輸入：
- 將檔案上傳至 Azure Blob 儲存體來源容器 (sourceUri)。
- 提供可將已翻譯文件寫入的目標容器(targetUri)。
- 包含目標語言代碼 (targetLanguage)。
Uri sourceUri = new Uri("<your-source container-url");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";
DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)
同步單一文件翻譯
說明選項
Microsoft Q&A 和 Stack Overflow 論壇可供開發人員社群詢問和回答有關 Azure 文字翻譯和其他服務的問題。 Microsoft 會監視論壇，並回覆社群尚未回答的問題。
提示
若要確定我們看到您的Microsoft Q&A 問題，請使用標記 microsoft-translator。
若要確保我們看到您的 Stack Overflow 問題，請使用 Azure AI Translator 加以標記。