クイックスタート: Azure portal を使用して Cognitive Services リソースを作成する

このクイックスタートを使用して、Cognitive Services リソースを作成します。 Azure portal で Cognitive Services リソースを作成すると、アプリケーションの認証を行うためのエンドポイントとキーが得られます。

Azure Cognitive Services は、開発者が直接的な人工知能 (AI) またはデータ サイエンスのスキルや知識がなくてもコグニティブかつインテリジェントなアプリケーションを構築できる、クラウドベースの AI サービスです。 これらは、REST API とクライアント ライブラリ SDK を通じて、一般的な開発言語で利用できます。 開発者は Azure Cognitive Services を使用して、見たり、聞いたり、話したり、分析したりできるコグニティブ ソリューションを使用したコグニティブ機能をそのアプリケーションに容易に追加することができます。

Cognitive Services リソースの種類

2 つの異なるリソースを使用して、Azure Cognitive Services にアクセスすることができます:マルチサービス リソース、または単一サービス リソース。

  • マルチサービス リソース:
    • 1 つのキーとエンドポイントを使用して複数の Azure Cognitive Services にアクセスします。
    • ご利用の複数のサービスの課金を統合します。
  • 単一サービス リソース:
    • 作成されたサービスごとに一意のキーとエンドポイントを使用して、単一の Azure Cognitive Service にアクセスします。
    • Free レベルを使用してサービスをお試しください。

前提条件

  • 有効な Azure サブスクリプション - 無料アカウントを作成する
  • 責任ある AI の条項に同意してリソースを作成するためには、Azure アカウントに Cognitive Services 共同作成者ロールが割り当てられている必要があります。 このロールをアカウントに割り当てるには、ロールの割り当てに関するドキュメントの手順に従うか、管理者にお問い合わせください。

新しい Azure Cognitive Services リソースを作成する

マルチサービス リソースには、ポータルで Cognitive Services という名前が付けられます。 マルチサービス リソースでは次の Cognitive Services にアクセスできます。

  • 決定 - Content Moderator
  • 言語 - Language、Translator
  • 音声 - Speech
  • 視覚 - Computer Vision、Custom Vision、Face
  1. このリンクを選択すると、Azure Cognitive マルチサービス リソースを作成できます: Cognitive Servicesリソースを作成します

  2. [作成] ページで、次の情報を指定します。

    プロジェクトの詳細 説明
    サブスクリプション 使用できる Azure サブスクリプションのいずれかを選択します。
    リソース グループ Cognitive Services リソースを含むことになる Azure リソース グループ。 新しいグループを作成することも、既存のグループに追加することもできます。
    リージョン Cognitive Services インスタンスの場所。 別の場所を選択すると待機時間が生じる可能性がありますが、リソースのランタイムの可用性には影響しません。
    名前 Cognitive Sservices リソースのわかりやすい名前。 例: MyCognitiveServicesResource
    価格レベル Cognitive Services アカウントのコストは、選択しているオプションと使用量によって異なります。 詳細については、「API の価格の詳細」をご覧ください。

    マルチサービス リソースの作成画面

  3. 必要に応じてリソースの他の設定を構成し、条件を読み取って同意し (該当する場合)、[Review + create(確認と作成) ] を選択します。

ヒント

サブスクリプションで Cognitive Service リソースを作成できない場合は、Azure portalPowerShell コマンド、または Azure CLI コマンドを使用して、その Azure リソース プロバイダーの特権を有効にする必要がある場合があります。 サブスクリプションの所有者でない場合は、サブスクリプションの所有者、または管理者のロールを持つユーザーに、登録の完了を要求するか、アカウントに /register/action 特権を付与するように要求します。

リソースのキーを取得する

  1. リソースが正常にデプロイされたら、[Next Steps(次のステップ )] >[Go to resource(リソースへの移行)] を選択します。

    リソースのキーを取得する画面

  2. 開かれた [クイックスタート] ウィンドウから、リソースエンドポイントにアクセスしキーを管理できます。

認証用の環境変数を構成する

アプリケーションは、使用する Cognitive Services へのアクセスを認証する必要があります。 認証するために、Azure リソースのキーを格納する環境変数を作成することをお勧めします。 認証オプションの詳細については、「Cognitive Services に対する要求の認証」を参照してください。

キーを用意したら、アプリケーションを実行しているローカル マシンの新しい環境変数に書き込みます。 環境変数を設定するには、コンソール ウィンドウを開いて、お使いのオペレーティング システムの手順に従います。 your-key をお使いのリソースのいずれかのキーで置き換えます。

setx COGNITIVE_SERVICE_KEY "your-key"

実行中のプログラムのうち、環境変数の読み取りを必要とするプログラム (コンソール ウィンドウを含む) については、環境変数を追加した後で再起動が必要となる場合があります。 たとえば、Visual Studio をエディターとして使用している場合、サンプルを実行する前に Visual Studio を再起動します。

リソースをクリーンアップする

Cognitive Services サブスクリプションをクリーンアップして削除したい場合は、リソースまたはリソース グループを削除することができます。 リソース グループを削除すると、そのグループに含まれている他のリソースも削除されます。

  1. Azure Portal で左側のメニューを展開してサービスのメニューを開き、 [リソース グループ] を選択して、リソース グループの一覧を表示します。
  2. 削除するリソースが含まれているリソース グループを見つけます。
  3. リソース グループ全体を削除する場合は、リソース グループ名を選択します。 次のページで [リソース グループの削除] を選択し、確認します。
  4. Cognitive Service リソースのみを削除する場合は、リソース グループを選択して、その中のすべてのリソースを表示します。 次のページで、削除するリソースを選択し、その行の省略記号メニューを選択して、[削除] を選択します。

削除されたリソースを復旧する必要がある場合は、削除された Cognitive Services リソースの復旧に関するページを参照してください。

関連項目