モデルの管理
準備したデータセットを使用してモデルをトレーニングします。AutoML Video Intelligence Classification では、データセットの項目を使用して、モデルのパフォーマンスをトレーニング、テスト、evaluateします。その結果を確認し、必要に応じてトレーニング データセットを調整して、改善されたデータセットで新しいモデルをトレーニングします。
モデルのトレーニングが完了するまで数時間かかることがあります。AutoML API を使用すると、トレーニングのステータスを確認できます。
AutoML Video Intelligence Classification ではトレーニングを開始するたびに新しいモデルが作成されるため、プロジェクトに多数のモデルが含まれる場合があります。プロジェクト内のモデルの一覧を取得し、不要になったモデルを削除できます。
モデルの最大寿命は 2 年です。その後もコンテンツを分類し続けるには、新しいモデルを作成してトレーニングする必要があります。
curl または PowerShell の使用
このトピックで使用する curl
(または PowerShell)のサンプルを簡単に実行できるように、次の環境変数を設定します。project-id は、Google Cloud プロジェクトの名前で置き換えます。
export PROJECT_ID="project-id"
モデルのトレーニング
信頼できるラベル付きトレーニング項目のセットを含むデータセットを用意したら、モデルの作成とトレーニングを行うことができます。
ウェブ UI
-
AutoML Video UI を開き、[Datasets] ページに移動します。
-
モデルのトレーニングに使用するデータセットを選択します。
選択したデータセットの表示名がタイトルバーに表示され、データセット内の個々の項目がラベルと一緒にページに一覧表示されます。
-
データセットの確認を終えたら、タイトルバーのすぐ下にある [Train] タブをクリックします。
トレーニング ページにデータセットの基本的な分析が表示され、データセットがトレーニングに適しているかどうかがアドバイスされます。AutoML Video から変更が提案された場合は、[Videos] ページに戻って項目やラベルを追加することを検討してください。
- データセットの準備ができたら、[Start Training] をクリックして新しいモデルを作成します。追加モデルを作成する場合は [Train New Model] をクリックします。
REST
リクエストのデータを使用する前に、次のように置き換えます。
- dataset-id: この ID は、データセットの名前の最後の要素です。たとえば、データセットの名前が
projects/434039606874/locations/us-central1/datasets/VCN3104518874390609379
の場合、データセットの ID はVCN3104518874390609379
です。 - 注:
- project-number: プロジェクトの番号。
- location-id: アノテーションを実行する Cloud リージョン。サポート対象のクラウド リージョンは
us-east1
、us-west1
、europe-west1
、asia-east1
です。リージョンを指定しないと、動画ファイルの場所に基づいてリージョンが決まります。
HTTP メソッドと URL:
POST https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models
リクエストの本文(JSON):
{ "displayName": "test_model", "dataset_id": "dataset-id", "videoClassificationModelMetadata": {} }
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-number" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models"
PowerShell
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-number" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models" | Select-Object -Expand Content
{ "name": "projects/project-number/locations/location-id/operations/operation-id", "metadata": { "@type": "type.googleapis.com/google.cloud.automl.v1beta1.OperationMetadata", "progressPercentage": 100, "createTime": "2020-02-27T01:56:28.395640Z", "updateTime": "2020-02-27T02:04:12.336070Z" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.automl.v1beta1.Model", "name": "projects/project-number/locations/location-id/models/operation-id", "createTime": "2020-02-27T02:00:22.329970Z", "videoClassificationModelMetadata": { "trainBudget": "1", "trainCost": "1", "stopReason": "BUDGET_REACHED" }, "displayName": "a_98487760535e48319dd204e6394670" } }
Java
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Node.js
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Python
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
モデルに関する情報の取得
トレーニングが完了したら、新しく作成したモデルに関する情報を取得できます。
このセクションの例では、モデルに関する基本のメタデータが返されます。モデルの正確性と準備状況の詳細を確認するには、モデルの評価をご覧ください。
ウェブ UI
-
AutoML Video UI で [Models] ページに移動します。
<img <="" alt="モデルが 1 つ表示されているモデルページ" li="" src="/static/video-intelligence/automl/docs/images/models_page.png" /> - 表示するモデルの名前をクリックします。
REST
リクエストのデータを使用する前に、次のように置き換えます。
- model-name: モデルの作成時にレスポンスで指定された完全なモデル名。完全な名前の形式: projects/project-number/locations/location-id/models/model-id
- dataset-id: データセットのデータセット識別子(表示名ではない)に置き換えます。例:
VCN3940649673949184000
- project-number: プロジェクトの数
HTTP メソッドと URL:
GET https://automl.googleapis.com/v1beta1/model-name/modelEvaluations
JSON 本文のリクエスト:
{ "displayName": "test_model", "dataset_id": "dataset-id", "videoClassificationModelMetadata": {} }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
Java
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Node.js
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Python
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
モデルの一覧表示
1 つのプロジェクトに多数のモデルが含まれる場合があります。このセクションでは、プロジェクトで使用できるモデルを一覧表示する方法を説明します。
ウェブ UI
AutoML Video UI で [Models] ページに移動し、プロジェクトに含まれるモデルを表示します。別のプロジェクトのモデルを表示するには、タイトルバーの右上にあるプルダウン リストからプロジェクトを選択します。
REST
リクエストのデータを使用する前に、次のように置き換えます。
- model-name: モデルの作成時にレスポンスで指定された完全なモデル名。完全な名前の形式: projects/project-number/locations/location-id/models
- 注:
- project-number: プロジェクトの番号。
- location-id: アノテーションを実行する Cloud リージョン。サポート対象のクラウド リージョンは
us-east1
、us-west1
、europe-west1
、asia-east1
です。リージョンを指定しないと、動画ファイルの場所に基づいてリージョンが決まります。
HTTP メソッドと URL:
GET https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
Java
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Node.js
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Python
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
モデルの削除
次の例では、モデルを削除します。
ウェブ UI
- AutoML Video UI で [Models] ページに移動します。
- 削除する行の右端にあるその他メニューをクリックし、[削除] を選択します。
- 確認ダイアログ ボックスで [確認] をクリックします。
REST
リクエストのデータを使用する前に、次のように置き換えます。
- model-id: モデルの識別子に置き換えます。
- 注:
- project-number: プロジェクトの番号。
- location-id: アノテーションを実行する Cloud リージョン。サポート対象のクラウド リージョンは
us-east1
、us-west1
、europe-west1
、asia-east1
です。リージョンを指定しないと、動画ファイルの場所に基づいてリージョンが決まります。
HTTP メソッドと URL:
DELETE https://automl.googleapis.com/v1beta1/projects/project-number/locations/test/models/model-id
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
Java
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Node.js
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Python
AutoML Video に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。