Translator リソースを作成する

開始するには、アクティブな 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 をコピーして、メモ帳などの便利な場所に貼り付けます。

   

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

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

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

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

5. 削除を選択します。

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

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

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

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