建立翻譯工具資源

在本文中,您將了解如何在 Azure 入口網站中建立翻譯工具資源。 Azure AI 翻譯工具是雲端式機器翻譯服務,屬於 Azure AI 服務系列。 Azure 資源是您所建立的服務執行個體。 Azure AI 服務的所有 API 要求都需要有端點 URL 和唯讀金鑰才能驗證存取。

必要條件

若要開始,您需要使用中的 Azure 帳戶。 如果您沒有帳戶,您可以建立免費 12 個月的訂用帳戶

建立資源

透過您的 Azure 帳戶,您可以透過兩種不同的資源類型來存取翻譯工具服務:

  1. 單一服務資源類型可讓您存取單一服務 API 金鑰和端點。

  2. 多服務資源類型可讓您使用單一 API 金鑰和端點來存取多個 Azure AI 服務。

完成專案和執行個體詳細資料

決定要使用哪個資源類型來存取翻譯工具服務之後,您可以輸入專案和執行個體的詳細資料。

  1. 訂用帳戶。 選取您可用的一個 Azure 訂用帳戶。

  2. 資源群組。 您可以建立新的資源群組,或將資源新增至共用相同生命週期、權限和原則的預先存在資源群組。

  3. 資源區域。 除非您的業務或應用程式需要特定區域,否則請選擇 [全域]。 如果您計劃搭配受控識別驗證使用文件翻譯功能,請選擇一個地理區域,例如 [美國東部]。

  4. 名稱. 輸入資源的名稱。 您所選擇的名稱在 Azure 中必須是唯一的。

    注意

    如果您在使用需要自訂網域端點的翻譯工具功能 (例如: 文件翻譯),您在名稱欄位中輸入的值將會是端點的自訂網域名稱參數。

  5. 定價層。 選取符合您需求的定價層

    • 每個訂用帳戶都有一個免費層。
    • 免費層與付費方案的特色和功能相同,而且不會過期。
    • 每個訂用帳戶只有一個免費層資源。
    • 只有付費層才支援文件翻譯。 Language Studio 支援 S1 和 D3 執行個體層。 如果您要嘗試文件翻譯,選取標準 S1 執行個體層。
  6. 如果您建立多服務資源,[基本] 索引標籤底部的連結會提供服務適當作業的相關技術文件。

  7. 選取 [檢閱 + 建立] 。

  8. 檢閱服務條款,然後選取 [建立] 以部署資源。

  9. 成功部署資源之後,請選取 [移至資源]

    驗證金鑰和端點 URL

    所有 Azure AI 服務 API 要求都需要端點 URL 和唯讀金鑰以進行驗證。

    • 驗證金鑰。 您的金鑰是每個要求傳遞至翻譯服務的唯一字串。 您可以透過查詢字串參數傳遞您的金鑰,或在 HTTP 要求標頭中進行指定。

    • 端點 URL。 除非您需要特定的 Azure 區域或自訂端點,否則請使用 API 要求中的全域端點。 如需詳細資訊,請參閱 基礎 URL。 全域端點 URL 是 api.cognitive.microsofttranslator.com

取得驗證金鑰和端點

若要驗證您與翻譯工具資源的連線,您必須尋找其金鑰和端點。

  1. 部署新資源之後,請選取 [移至資源] 或直接瀏覽至資源頁面。

  2. 在左側瀏覽窗格中,於資源管理下選取 [金鑰和端點]

  3. 將金鑰和端點 URL 複製並貼上至方便的位置,例如記事本。

    Azure 入口網站的螢幕擷取畫面,其中顯示翻譯工具資源的 [金鑰和端點] 頁面。金鑰和端點會反白顯示。

建立文字翻譯用戶端

文字翻譯同時支援 全域和區域端點。 一旦您擁有 驗證金鑰,您必須使用 AzureKeyCredential 驗證,建立 TextTranslationClient 的執行個體,才能與文字翻譯服務互動:

  1. 若要使用全域資源端點建立 TextTranslationClient,您需要資源 API 金鑰:

      AzureKeyCredential credential = new('<apiKey>');
      TextTranslationClient client = new(credential);
    
  2. 若要使用區域資源端點建立 TextTranslationClient,您需要資源 API 金鑰,以及資源所在區域的名稱:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential, '<region>');
    

建立文件翻譯用戶端

使用文件翻譯 API,以非同步方式跨語言翻譯大量的文字和多個文件。 批次翻譯流程需要具有來源和翻譯文件儲存體容器的 Azure Blob 儲存體帳戶。

  1. 文件翻譯僅在使用 S1 標準服務方案 (隨用隨付) 或 D3 大量折扣方案的翻譯工具 (單一服務) 資源中受到支援。

  2. 「如需為文件翻譯建立翻譯工具資源的詳細資訊,請參閱 必要條件:使用文件翻譯」。

如何刪除資源或資源群組

警告

刪除資源群組同時會刪除該群組中內含的所有資源。

若要刪除資源:

  1. 在 Azure 入口網站選取 [資源群組],然後選取您的資源群組。

  2. 選取相鄰的核取方塊,以選取要刪除的資源。

  3. 從右邊緣附近的上方功能表中選取 [刪除]

  4. 在 [刪除資源] 對話方塊中,輸入 [刪除]

  5. 選取 [刪除]

刪除資源群組:

  1. 在 Azure 入口網站中移至您的資源群組。

  2. 從頂端功能表中選取 [刪除資源群組]

  3. 輸入資源群組名稱並選取 [刪除],以確認刪除要求。

後續步驟