在本文中,您將了解如何在 Azure 入口網站中建立翻譯工具資源。 Azure AI 翻譯工具是雲端式機器翻譯服務,屬於 Azure AI 服務系列。 Azure 資源是您所建立的服務執行個體。 Azure AI 服務的所有 API 要求都需要有端點 URL 和唯讀金鑰才能驗證存取。
建立翻譯工具資源
必要條件
若要開始,您需要使用中的 Azure 帳戶。 如果您沒有帳戶,您可以建立免費 12 個月的訂用帳戶。
建立資源
透過您的 Azure 帳戶,您可以透過兩種不同的資源類型來存取翻譯工具服務:
完成專案和執行個體詳細資料
決定要使用哪個資源類型來存取翻譯工具服務之後,您可以輸入專案和執行個體的詳細資料。
訂用帳戶。 選取您可用的一個 Azure 訂用帳戶。
資源群組。 您可以建立新的資源群組,或將資源新增至共用相同生命週期、權限和原則的預先存在資源群組。
資源區域。 除非您的業務或應用程式需要特定區域,否則請選擇 [全域]。 如果您計劃搭配受控識別驗證使用文件翻譯功能,請選擇一個地理區域,例如 [美國東部]。
名稱. 輸入資源的名稱。 您所選擇的名稱在 Azure 中必須是唯一的。
注意
如果您在使用需要自訂網域端點的翻譯工具功能 (例如: 文件翻譯),您在名稱欄位中輸入的值將會是端點的自訂網域名稱參數。
定價層。 選取符合您需求的定價層:
- 每個訂用帳戶都有一個免費層。
- 免費層與付費方案的特色和功能相同,而且不會過期。
- 每個訂用帳戶只有一個免費層資源。
- 只有付費層才支援文件翻譯。 Language Studio 支援 S1 和 D3 執行個體層。 如果您要嘗試文件翻譯,選取標準 S1 執行個體層。
如果您建立多服務資源,[基本] 索引標籤底部的連結會提供服務適當作業的相關技術文件。
選取 [檢閱 + 建立] 。
檢閱服務條款,然後選取 [建立] 以部署資源。
成功部署資源之後,請選取 [移至資源]。
驗證金鑰和端點 URL
所有 Azure AI 服務 API 要求都需要端點 URL 和唯讀金鑰以進行驗證。
驗證金鑰。 您的金鑰是每個要求傳遞至翻譯服務的唯一字串。 您可以透過查詢字串參數傳遞您的金鑰,或在 HTTP 要求標頭中進行指定。
端點 URL。 除非您需要特定的 Azure 區域或自訂端點,否則請使用 API 要求中的全域端點。 如需詳細資訊,請參閱 基礎 URL。 全域端點 URL 是
api.cognitive.microsofttranslator.com
。
取得驗證金鑰和端點
若要驗證您與翻譯工具資源的連線,您必須尋找其金鑰和端點。
部署新資源之後,請選取 [移至資源] 或直接瀏覽至資源頁面。
在左側瀏覽窗格中,於資源管理下選取 [金鑰和端點]。
將金鑰和端點 URL 複製並貼上至方便的位置,例如記事本。
建立文字翻譯用戶端
文字翻譯同時支援 全域和區域端點。 一旦您擁有 驗證金鑰,您必須使用 AzureKeyCredential
驗證,建立 TextTranslationClient
的執行個體,才能與文字翻譯服務互動:
若要使用全域資源端點建立
TextTranslationClient
,您需要資源 API 金鑰:AzureKeyCredential credential = new('<apiKey>'); TextTranslationClient client = new(credential);
若要使用區域資源端點建立
TextTranslationClient
,您需要資源 API 金鑰,以及資源所在區域的名稱:AzureKeyCredential credential = new('<apiKey>'); TextTranslationClient client = new(credential, '<region>');
建立文件翻譯用戶端
使用文件翻譯 API,以非同步方式跨語言翻譯大量的文字和多個文件。 批次翻譯流程需要具有來源和翻譯文件儲存體容器的 Azure Blob 儲存體帳戶。
文件翻譯僅在使用 S1 標準服務方案 (隨用隨付) 或 D3 大量折扣方案的翻譯工具 (單一服務) 資源中受到支援。
「如需為文件翻譯建立翻譯工具資源的詳細資訊,請參閱 必要條件:使用文件翻譯」。
如何刪除資源或資源群組
警告
刪除資源群組同時會刪除該群組中內含的所有資源。
若要刪除資源:
在 Azure 入口網站選取 [資源群組],然後選取您的資源群組。
選取相鄰的核取方塊,以選取要刪除的資源。
從右邊緣附近的上方功能表中選取 [刪除]。
在 [刪除資源] 對話方塊中,輸入 [刪除] 。
選取 [刪除]。
刪除資源群組:
在 Azure 入口網站中移至您的資源群組。
從頂端功能表中選取 [刪除資源群組]。
輸入資源群組名稱並選取 [刪除],以確認刪除要求。