建立 翻譯工具 資源

在本文中,您將了解如何在 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>');
    

如何刪除資源或資源群組

警告

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

若要刪除資源:

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

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

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

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

  5. 選取 [刪除]

刪除資源群組:

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

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

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

後續步驟