編集

次の方法で共有


Translator リソースを作成する

この記事では、Azure portal で Translator リソースを作成する方法について説明します。 Azure AI 翻訳は、クラウドベースの機械翻訳サービスであり、REST API の Azure AI サービス ファミリに含まれます。 Azure リソースは、作成するサービスのインスタンスです。 Azure AI サービスに対するすべての API 要求には、アクセスを認証するために、エンドポイント URL と読み取り専用のキーが必要です。

前提条件

開始するには、アクティブな Azure アカウントが必要です。 お持ちでない場合は、無料の 12 か月のサブスクリプションを作成できます。

リソースを作成する

Azure アカウントを使うと、次の 2 種類のリソースを使って翻訳サービスにアクセスできます。

  1. 単一サービス リソースの種類を使用すると、1 つのサービス API キーとエンドポイントにアクセスできます。

  2. マルチサービス リソースの種類を使うと、1 つの API キーとエンドポイントを使って複数の Azure AI サービスにアクセスできます。

プロジェクトとインスタンスの詳細を入力する

翻訳サービスへのアクセスに使うリソースの種類を決定したら、プロジェクトとインスタンスの詳細を入力できます。

  1. [サブスクリプション]。 使用できる Azure サブスクリプションのいずれかを選択します。

  2. [リソース グループ]。 新しいリソース グループを作成するか、同じライフサイクル、アクセス許可、ポリシーを共有する既存のリソース グループにリソースを追加することができます。

  3. [リソース リージョン] . ご自身のビジネスまたはアプリケーションが特定のリージョンを必要としない限り、 [グローバル] を選択します。 マネージド ID 認可でドキュメント翻訳機能を使用する予定の場合は、米国東部などの地理的リージョンを選択します。

  4. 名前. リソースの名前を入力します。 選択した名前は Azure 内で一意である必要があります。

    Note

    ドキュメント翻訳など、カスタム ドメイン エンドポイントを必要とする翻訳機能を使う場合は、[名前] フィールドに入力する値が、エンドポイントのカスタム ドメイン名パラメーターになります。

  5. 価格レベル。 自分のニーズに合った価格レベルを選択します。

    • 各サブスクリプションに Free レベルがあります。
    • Free レベルは有料プランと同じ機能を備えており、有効期限がありません。
    • サブスクリプションごとに利用できる Free レベル リソースは 1 つだけです。
    • ドキュメント翻訳は有料レベルでのみサポートされます。 Language Studio では、S1 と D3 のインスタンス層がサポートされます。 ドキュメント翻訳を試すだけの場合は、Standard S1 インスタンス レベルを選びます。
  6. マルチサービス リソースを作成した場合は、[基本] タブの下部にあるリンクに、サービスの適切な操作に関する技術ドキュメントが掲載されます。

  7. [確認および作成] を選択します。

  8. サービス条件を確認し、[作成] を選んでリソースをデプロイします。

  9. リソースが正常にデプロイされた後、 [リソースに移動] を選択します。

    認証キーとエンドポイント URL

    すべての Azure AI サービスの API 要求には、認証のためのエンドポイント URL と読み取り専用キーが必要です。

    • 認証キー。 自分のキーは、Translation サービスへの要求ごとに渡される一意の文字列です。 自分のキーは、クエリ文字列パラメーターを使用するか、HTTP 要求ヘッダーで指定して渡すことができます。

    • エンドポイント URL。 特定の Azure リージョンまたはエンドポイントが必要な場合を除き、API 要求ではグローバル エンドポイントを使用します。 詳細については、「ベース URL」を参照してください。 グローバル エンドポイント URL は api.cognitive.microsofttranslator.com です。

認証キーとエンドポイントを取得する

Translator リソースへの接続の認証を行うには、そのキーとエンドポイントを見つける必要があります。

  1. 新しいリソースがデプロイされた後、[リソースに移動] を選ぶか、自分のリソース ページに移動します。

  2. 左側のナビゲーション ペインの [リソース管理][キーとエンドポイント] を選びます。

  3. 自分のキーとエンドポイント URL をコピーして、メモ帳などの便利な場所に貼り付けます。

    Azure portal のスクリーンショット。Translator リソースの [キーとエンドポイント] ページが示されています。キーとエンドポイントが強調表示されています。

テキスト翻訳クライアントを作成する

テキスト翻訳では、グローバル エンドポイントとリージョン エンドポイントの両方がサポートされています。 認証キーを取得したら、テキスト翻訳サービスとやりとりするため、認証に 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>');
    

ドキュメント翻訳クライアントを作成する

Document Translation API を使って、大量のテキストと複数のドキュメントを言語間で非同期的に翻訳します。 バッチ翻訳プロセスでは、翻訳前と翻訳後のドキュメント用のストレージ コンテナーを含む Azure Blob Storage アカウントが必要です。

  1. 現在、ドキュメント翻訳は、S1 Standard サービス プラン (従量課金制) を使用する Translator (単一サービス) リソースまたは D3 ボリューム割引プランのみでサポートされています。

  2. "ドキュメント翻訳用の Translator リソースの作成について詳しくは、前提条件: ドキュメント翻訳の使用に関する記事をご覧ください。

リソースまたはリソース グループを削除する方法

警告

リソース グループを削除すると、そのグループに含まれるすべてのリソースも削除されます。

リソースを削除するには:

  1. Azure portal で [リソース グループ] を検索して選び、自分のリソース グループを選びます。

  2. 隣接するチェック ボックスをオンにして、削除するリソースを選択します。

  3. 右端近くの上部メニューから [削除] を選択します。

  4. [リソースの削除] ダイアログ ボックスに「delete」と入力します。

  5. [削除] を選択します。

リソース グループを削除するには:

  1. Azure portal でお使いのリソース グループに移動します。

  2. 上部のメニュー バーから [リソース グループの削除] を選びます。

  3. リソース グループ名を入力し、 [削除] を選択して、削除要求を確定します。

次のステップ