翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Rekognition Custom Labels API リファレンス Amazon Rekognition Custom Labels API は、Amazon Rekognition API リファレンスのコンテンツの一部として文書化されています。これは Amazon Rekognition Custom Labels API オペレーションの一覧で、該当する Amazon Rekognition API リファレンスのトピックへのリンクも含まれています。また、このドキュメント内の API リファレンスリンクは、該当する「Amazon Rekognition デベロッパーガイド」の API リファレンストピックに移動します。API の使用については、「[ Amazon Rekognition Custom Labels についてAmazon Rekognition Custom Labels について このセクションでは、コンソールと AWS SDK で Amazon Rekognition Custom Labels モデルをトレーニングして使用するワークフローの概要を説明します。 Amazon Rekognition Custom Labels がプロジェクト内のデータセットを管理するようになりました。コンソールと AWS SDK を使用して、プロジェクトのデータセットを作成できます。以前に Amazon Rekognition Custom Labels を使用したことがある場合は、古いデータセットを新しいプロジェクトに関連付ける必要がある場合があります。詳細については、[ステップ 6: (オプション) 以前のデータセットを新しいプロジェクトに関連付ける](su-associate-prior-dataset.md)を参照してください。 モデルタイプの決定 まず、ビジネス目標に応じて、どのタイプのモデルをトレーニングするかを決定します。例えば、ソーシャルメディアの投稿で自社のロゴを見つけたり、店舗の棚で商品を識別したり、組立ラインで機械部品を分類したりするようにモデルをトレーニングできます。 Amazon Rekognition Custom Labels では、以下のタイプのモデルをトレーニングできます。 [オブジェクト、シーン、概念を検出する](#tm-classification) [オブジェクトの位置の検索](#tm-object-localization) [ブランドの所在地を探す](#tm-brand-detection-localization) トレーニングするモデルのタイプを決定しやすくするために、Amazon Rekognition Custom Labels には使用できるサンプルプロジェクトが用意されています。詳細については、「[Amazon Rekognition Custom Labels の開始方法](getting-started.md)」を参照してください。 オブジェクト、シーン、概念を検出する このモデルは、イメージ全体に関連するオブジェクト、シーン、概念の分類を予測します。例えば、イメージに*観光名所*が含まれているかどうかを判断するモデルをトレーニングできます。サンプルプロジェクトについては、「[イメージ分類](getting-started.md#gs-image-classification-example)」を参照してください。以下の湖の画像は、オブジェクト、シーン、概念を認識できる画像の種類を示した例です。 ![\[夕暮れか日の出時に雲と山々が映り込んだ静かな湖面。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/pateros.jpg) イメージを複数のカテゴリに分類するモデルをトレーニングすることもできます。例えば、前のイメージには、*空の色*、*反射*、*湖*などのカテゴリが含まれている場合があります。サンプルプロジェクトについては、「[マルチラベルイメージ分類](getting-started.md#gs-multi-label-image-classification-example)」を参照してください。 オブジェクトの位置の検索 モデルはイメージ上のオブジェクトの位置を予測します。予測には、オブジェクトの位置に関する境界ボックス情報と、境界ボックス内のオブジェクトを識別するラベルが含まれます。例えば、次のイメージは、*コンパレータ*や*ポット抵抗*など、回路基板のさまざまな部分を囲む境界ボックスを示しています。 ![\[回路基板上の赤外線 LED、可変抵抗器、コンパレータチップを示す部品画像。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/localization-circuit-board.png) [オブジェクトのローカリゼーション](getting-started.md#gs-object-localization-example) のサンプルプロジェクトでは、Amazon Rekognition Custom Labels がラベル付き境界ボックスを使用して、オブジェクトの位置を検出するモデルをトレーニングする方法を示しています。 ブランドの所在地を探す Amazon Rekognition Custom Labels は、イメージ上のブランドの場所 (ロゴなど) を検索するようにモデルをトレーニングできます。予測には、ブランドロケーションの境界ボックス情報と、境界ボックス内のオブジェクトを識別するラベルが含まれます。サンプルプロジェクトについては、「[ブランド検出](getting-started.md#gs-brand-detection-example)」を参照してください。以下の画像は、モデルが検出できるブランドの一例です。 ![\[Lambda サービスがユーザーアクティビティをレコメンデーション生成のために Amazon Pinpoint に送信している様子を示す図。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/brand-detection-lambda.png) モデルを作成する モデルを作成する手順は、プロジェクトの作成、トレーニングデータセットとテストデータセットの作成、モデルのトレーニングです。 プロジェクトの作成 プロジェクトとは、Amazon Rekognition Custom Labels モデルのバージョンを作成および管理するために必要なリソースのグループです。プロジェクトでは、次のものが管理されます。 **データセット** - モデルのトレーニングに使用されるイメージとイメージラベル。プロジェクトには、トレーニングデータセットとテストデータセットがあります。 **モデル** - ビジネス特有の概念、シーン、オブジェクトを検索するためのトレーニングを行うソフトウェアです。プロジェクトには、モデルの複数のバージョンを含めることができます。 回路基板上の回路基板部品を検索するなど、単一のユースケースにプロジェクトを使用することをお勧めします。 Amazon Rekognition Custom Labels コンソールと [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject) API を使用してプロジェクトを作成できます。詳細については、「[プロジェクトの作成](mp-create-project.md)」を参照してください。 トレーニングデータセットとテストデータセットの作成 データセットとは、イメージとそのイメージを説明するラベルの集合のことです。プロジェクト内で、Amazon Rekognition Custom Labels でモデルのトレーニングとテストに使用するトレーニングデータセットとテストデータセットを作成します。 ラベルは、イメージ内のオブジェクトを囲むオブジェクト、シーン、概念、または境界ボックスを識別します。ラベルはイメージ全体 (*イメージレベル*) に割り当てられるか、イメージ上のオブジェクトを囲む境界ボックスに割り当てられます。 データセット内のイメージに付けるラベルによって、Amazon Rekognition Custom Labels が作成するモデルのタイプが決まります。例えば、オブジェクト、シーン、概念を検出するモデルをトレーニングするには、トレーニングデータセットとテストデータセットのイメージにイメージレベルのラベルを割り当てます。詳細については、「[データセットの目的の設定](md-dataset-purpose.md)」を参照してください。 イメージは PNG 形式および JPEG 形式である必要があり、入力イメージの推奨事項に従う必要があります。詳細については、「[イメージの準備](md-prepare-images.md)」を参照してください。 トレーニングデータセットとテストデータセットの作成 (コンソール) 1 つのデータセットでプロジェクトを開始することも、個別のトレーニングデータセットとテストデータセットを持つプロジェクトから始めることもできます。1 つのデータセットから始めると、Amazon Rekognition Custom Labels はトレーニング中にデータセットを分割して、プロジェクトのトレーニングデータセット (80%) とテストデータセット (20%) を作成します。Amazon Rekognition Custom Labels にトレーニングとテストに使用するイメージを決定させる場合は、1 つのデータセットから始めてください。トレーニング、テスト、パフォーマンスのチューニングを完全に制御するには、トレーニングデータセットとテストデータセットを分けてプロジェクトを開始することをお勧めします。 プロジェクトのデータセットを作成するには、次のいずれかの方法でイメージをインポートします。 ローカルコンピュータから画像をインポートします。 S3 バケットから画像をインポートします。Amazon Rekognition Custom Labels では、イメージを含むフォルダ名を使用してイメージにラベル付けすることができます。 Amazon SageMaker AI Ground Truth マニフェストファイルをインポートします。 既存の Amazon Rekognition Custom Labels データセットをコピーします。 詳細については、「[イメージ付きのトレーニングデータセットとテストデータセットの作成](md-create-dataset.md)」を参照してください。 イメージのインポート元によっては、イメージにラベルが付いていない場合があります。例えば、ローカルコンピュータからインポートされたイメージにはラベルは付きません。Amazon SageMaker AI Ground Truth マニフェストファイルからインポートされたイメージにはラベルが付けられます。Amazon Rekognition Custom Labels コンソールを使用して、ラベルの追加、変更、割り当てを行うことができます。詳細については、「[イメージにラベルを付ける](md-labeling-images.md)」を参照してください。 コンソールでトレーニングデータセットとテストデータセットを作成するには、「[イメージ付きのトレーニングデータセットとテストデータセットの作成](md-create-dataset.md)」を参照してください。トレーニングデータセットとテストデータセットの作成を含むチュートリアルについては、「[画像の分類](tutorial-classification.md)」を参照してください。 トレーニングデータセットとテストデータセットの作成 (SDK) トレーニングデータセットとテストデータセットを作成するには、`CreateDataset` API を使用します。Amazon SageMaker 形式のマニフェストファイルを使用するか、既存の Amazon Rekognition Custom Labels をコピーして、データセットを作成できます。詳細については、「[トレーニングデータセットとテストデータセットの作成 (SDK)](md-create-dataset.md#cd-create-dataset-sdk)」を参照してください。必要に応じて、独自のマニフェストファイルを作成できます。詳細については、「[マニフェストファイルの作成](md-create-manifest-file.md)」を参照してください。 モデルをトレーニングする トレーニングデータセットでモデルをトレーニングします。モデルの新しいバージョンは、トレーニングのたびに作成されます。トレーニング中、Amazon Rekognition Custom Labels はトレーニング済みモデルのパフォーマンスをテストします。その結果を使用して、モデルを評価し、改善することができます。トレーニングが完了するまでしばらく時間がかかります。モデルのトレーニングが成功した場合にのみ課金されます。詳細については、「[Amazon Rekognition Custom Labels モデルをトレーニングする](training-model.md)」を参照してください。モデルトレーニングが失敗した場合、Amazon Rekognition Custom Labels は使用できるデバッグ情報を提供します。詳細については、「[失敗したモデルトレーニングのデバッグ](tm-debugging.md)」を参照してください。 モデルのトレーニング (コンソール) コンソールでモデルをトレーニングする方法については、「[モデルのトレーニング (コンソール)](training-model.md#tm-console)」を参照してください。 モデルのトレーニング (SDK) Amazon Rekognition Custom Labels モデルをトレーニングするには [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion) を呼び出します。詳細については、「[モデルのトレーニング (SDK)](training-model.md#tm-sdk)」を参照してください。 モデルの改善 テスト中、Amazon Rekognition Custom Labels は、トレーニング済みモデルの改善に使用できる評価メトリクスを作成します。 モデルの評価 テスト中に作成されたパフォーマンスメトリクスを使用して、モデルのパフォーマンスを評価します。F1、適合率、再現率などのパフォーマンスメトリクスにより、トレーニングしたモデルのパフォーマンスを理解し、本稼働で使用する準備ができたかどうかを判断することができます。詳細については、「[モデルを評価するためのメトリクス](im-metrics-use.md)」を参照してください。 モデルを評価する (コンソール) パフォーマンスメトリクスを表示するには、「[評価メトリクスへのアクセス (コンソール)](im-access-training-results.md)」を参照してください。 モデルの評価 (SDK) パフォーマンスメトリクスを取得するには、[DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions) を呼び出してテスト結果を取得します。詳細については、「[Amazon Rekognition Custom Labels の評価メトリクス (SDK) へのアクセス](im-metrics-api.md)」を参照してください。テスト結果には、分類結果の混同行列など、コンソールにはないメトリクスが含まれます。テスト結果は次の形式で返されます。 F1 スコア - モデルの全体的な適合率と再現率を表す単一の値。詳細については、「[F1](im-metrics-use.md#im-f1-metric)」を参照してください。 サマリーファイルの場所 - テストサマリーには、テストデータセット全体の集計評価メトリクスと、個々のラベルのメトリクスが含まれます。`DescribeProjectVersions` は、サマリーファイルの S3 バケットとフォルダの場所を返します。詳細については、「[モデル概要ファイルへのアクセス](im-summary-file-api.md)」を参照してください。 評価マニフェストのスナップショットの場所 - スナップショットには、信頼度評価や誤検出などの二項分類テストの結果など、テスト結果に関する詳細が含まれています。`DescribeProjectVersions` は、スナップショットファイルの S3 バケットとフォルダの場所を返します。詳細については、「[評価マニフェストスナップショットの解釈](im-evaluation-manifest-snapshot-api.md)」を参照してください。 モデルの改善 改善が必要な場合は、トレーニングイメージを追加するか、データセットのラベル付けを改善することができます。詳細については、「[Amazon Rekognition Custom Labels モデルの改善](tr-improve-model.md)」を参照してください。モデルが作成した予測についてフィードバックを与えて、それを使用してモデルを改善することもできます。詳細については、「[モデルフィードバックによるモデルの改良](ex-feedback.md)」を参照してください。 モデルの改善 (コンソール) データセットにイメージを追加する方法については、「[データセットへのイメージの追加](md-add-images.md)」を参照してください。ラベルを追加または変更するには、「[イメージにラベルを付ける](md-labeling-images.md)」を参照してください。 モデルを再トレーニングするには、「[モデルのトレーニング (コンソール)](training-model.md#tm-console)」を参照してください。 モデルの改善 (SDK) データセットにイメージを追加したり、イメージのラベルを変更するには、`UpdateDatasetEntries` API を使用します。`UpdateDatasetEntries` は JSON 行を更新するか、マニフェストファイルに追加します。JSON の各行には、割り当てられたラベルや境界ボックスの情報など、1 つのイメージに関する情報が含まれています。詳細については、「[イメージの追加 (SDK)](md-add-images.md#md-add-images-sdk)」を参照してください。データセット内のエントリを表示するには、`ListDatasetEntries` API を使用します。 モデルを再トレーニングするには、「[モデルのトレーニング (SDK)](training-model.md#tm-sdk-datasets)」を参照してください。 モデルの開始 モデルを使用する前に、Amazon Rekognition Custom Labels コンソールまたは `StartProjectVersion` API を使用してモデルを開始します。モデルの稼働時間に応じて課金されます。詳細については、「[トレーニング済み Amazon Rekognition Custom Labels の実行](running-model.md)」を参照してください。 モデルの開始 (コンソール) コンソールを使用してモデルを開始する方法については、「[Amazon Rekognition Custom Labels モデルの開始 (コンソール)](rm-start.md#rm-start-console)」を参照してください。 モデルの開始 [StartProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartProjectVersion) を呼び出してモデルを開始します。詳細については、「[Amazon Rekognition Custom Labels モデル (SDK) を開始します。](rm-start.md#rm-start-sdk)」を参照してください。 イメージの分析 モデルを使用してイメージを分析するには、`DetectCustomLabels` API を使用します。ローカルイメージ、または S3 バケットに保存されているイメージを指定できます。オペレーションには、使用するモデルの Amazon リソースネーム (ARN) も必要です。 モデルでオブジェクト、シーン、概念が見つかった場合、レスポンスにはイメージに含まれるイメージレベルのラベルのリストが含まれます。例えば、次のイメージは、*Rooms* サンプルプロジェクトで見つかったイメージレベルのラベルを示しています。 ![\[暖炉、茶色のソファ、アームチェア、コーヒーテーブルが配置され、壁には風景画のあるリビングルーム。屋外のテラスにつながるドア。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/rooms.jpg) モデルがオブジェクトの位置を検出した場合、レスポンスにはイメージ内のラベル付き境界ボックスのリストが含まれます。境界ボックスは、イメージ上のオブジェクトの位置を表します。境界ボックスの情報を使用して、オブジェクトの周囲に境界ボックスを描画できます。例えば、次のイメージは、*回路基板*サンプルプロジェクトを使用して見つかった回路基板部品の周囲の境界ボックスを示しています。 ![\[赤外線 LED、フォトトランジスタ、調整用の可変抵抗器を使用した回路基板。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/customlabels-dg/images/circuitboardparts.jpg) 詳細については、「[トレーニングされたモデルによるイメージの分析](detecting-custom-labels.md)」を参照してください。 モデルの停止 モデルの稼働時間に応じて課金されます。モデルを使用しなくなった場合は、Amazon Rekognition Custom Labels コンソールまたは `StopProjectVersion` API を使用してモデルを停止します。詳細については、「[Amazon Rekognition Custom Labels モデルの停止](rm-stop.md)」を参照してください。 モデルの停止する (コンソール) コンソールを使用して実行中のモデルを停止するには、「[Amazon Rekognition Custom Labels モデルの停止 (コンソール)](rm-stop.md#rm-stop-console)」を参照してください。 モデルの停止 (SDK) 実行中のモデルを停止するには、[StopProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopProjectVersion) を呼び出します。詳細については、「[Amazon Rekognition Custom Labels モデル (SDK) の停止](rm-stop.md#rm-stop-sdk)」を参照してください。 ](understanding-custom-labels.md)」を参照してください。 ## モデルのトレーニング ### プロジェクト + [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject) - リソース (イメージ、ラベル、モデル) とオペレーション (トレーニング、評価、検知) を論理的にグループ化した Amazon Rekognition Custom Labels プロジェクトを作成します。 + [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject) - Amazon Rekognition Custom Labels プロジェクトを削除します。 + [DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects) - すべての Amazon Rekognition Custom Labels のプロジェクトの一覧を返します。 ### プロジェクトポリシー + [PutProjectPolicy](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_PutProjectPolicy) — 信頼する AWS アカウントの Amazon Rekognition Custom Labels プロジェクトにプロジェクトポリシーをアタッチします。 + [ListProjectPolicies](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListProjectPolicies) - プロジェクトにアタッチされているプロジェクトポリシーの一覧を返します。 + [DeleteProjectPolicy](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectPolicy) - 既存のプロジェクトポリシーを削除します。 ### データセット + [CreateDataset](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateDataset) - Amazon Rekognition Custom Labels データセットを作成します。 + [DeleteDataset](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteDataset) - Amazon Rekognition Custom Labels データセットを削除します。 + [DescribeDataset](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeDataset) - Amazon Rekognition Custom Labels データセットを記述します。 + [DistributeDatasetEntries](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DistributeDatasetEntries) - トレーニングデータセット内のエントリ (イメージ) を、プロジェクトのトレーニングデータセットとテストデータセット全体に分散させます。 + [ListDataSetEntries](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListDatasetEntries) - Amazon Rekognition Custom Labels データセットのエントリ (イメージ) の一覧を返します。 + [ListDataSetLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListDatasetLabels) - Amazon Rekognition Custom Labels データセットに割り当てられたラベルの一覧を返します。 + [UpdateDataSetEntries](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UpdateDatasetEntries) - Amazon Rekognition Custom Labels データセットのエントリ (イメージ) を追加または更新します。 ### モデル + [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion) - Amazon Rekognition Custom Labels モデルをトレーニングします。 + [CopyProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CopyProjectVersion) - Amazon Rekognition Custom Labels モデルをコピーします。 + [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion) - Amazon Rekognition Custom Labels モデルを削除します。 + [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions) - 特定のプロジェクト内のすべての Amazon Rekognition Custom Labels モデルの一覧を返します。 ### [タグ] + [TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource) - Amazon Rekognition Custom Labels モデルに 1 つ以上のキーバリュータグを追加します。 + [UntagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UntagResource) - Amazon Rekognition Custom Labels モデルから 1 つ以上のタグを削除します。 ## モデルの使用 + [DetectCustomLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectCustomLabels) - カスタムラベルモデルを使用してイメージを分析します。 + [StartProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartProjectVersion) - カスタムラベルモデルを開始します。 + [StopProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopProjectVersion) - カスタムラベルモデルを停止します。