用語集Glossary

AA

属性Attributes

属性は検出結果から省略可能です (年齢性別頭部姿勢笑顔など)。Attributes are optional in the detection results, such as age, gender, head pose, facial hair, smiling. これらはクエリ パラメーター returnFaceAttributes を指定することによって検出 API から取得できます。They can be obtained from the detection API by specifying the query parameters: returnFaceAttributes. 属性は顔 ID四角形に加えて、選択したに関する追加情報を提供します。Attributes give extra information regarding selected faces; in addition to the face ID and the rectangle.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

年齢 (属性)Age (Attribute)

年齢は、特定の顔の年齢を表す属性の 1 つです。Age is one of the attributes that describes the age of a particular face. 年齢属性は検出結果から省略可能であり、returnFaceAttributes パラメーターを指定することによって検出要求で制御できます。The age attribute is optional in the detection results, and can be controlled with a detection request by specifying the returnFaceAttributes parameter.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

bB

CC

候補Candidate

候補は本質的には識別結果 (たとえば、検出において特定された人物と信頼度レベル) です。Candidates are essentially identification results (e.g. identified persons and level of confidence in detections). 候補は PersonID信頼度で表され、その人物が高い信頼度レベルで特定されたことを示します。A candidate is represented by the PersonID and confidence, indicating that the person is identified with a high level of confidence.

詳しくは、ガイド「Face - Identify」(顔 - 識別) をご覧ください。For more details, please refer to the guide Face - Identify.

信頼度Confidence

信頼度は、人物の類似性を数値化したもので、特定検証において、検索、識別、検証された結果の類似性を示します。Confidence is a measurement revealing the similarity between faces or Person in numerical values –which is used in identification, and verification to indicate the similarities of searched, identified and verified results.

詳細については、「Face - Find Similar」(顔 - 類似検索)、「Face - Identify」(顔 - 識別)、「Face - Verify」(顔 - 検証) の各ガイドを参照してください。For more details, please refer to the following guides: Face - Find Similar, Face - Identify, Face - Verify.

DD

検出/顔検出Detection/Face Detection

顔検出とは、イメージ内の顔を特定するアクションのことです。Face detection is the action of locating faces in images. ユーザーは要求にイメージをアップロードするか、イメージの URL を指定できます。Users can upload an image or specify an image URL in the request. 検出された顔は顔 ID とともに返されます。顔 ID は Face API の一意の ID を示します。The detected faces are returned with face IDs indicating a unique identity in Face API. 四角形は、イメージ内の顔の位置 (ピクセル単位) のほか、各顔の省略可能な属性 (年齢性別頭部姿勢笑顔など) を示します。The rectangles indicate the face locations in the image in pixels, as well as the optional attributes for each face such as age, gender, head pose, facial hair and smiling.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

EE

FF

FaceFace

顔とは、検出された顔に関連する、Face API から派生した結果を表す統一用語のことです。Face is a unified term for the results derived from Face API related with detected faces. 最終的に、顔は統一 ID (顔 ID)、イメージ内の指定されたリージョン (顔四角形)、および顔に関連する追加の属性 (年齢性別、ランドマーク、頭部姿勢など) で表されます。Ultimately, face is represented by a unified identity (Face ID), a specified region in images (Face Rectangle), and extra face related attributes, such as age, gender, landmarks and head pose. さらに、顔は検出から返される場合があります。Additionally, faces can be returned from detection.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

Face APIFace API

Face API は、顔検出および認証の最も高度なアルゴリズムを提供するクラウド ベースの API です。Face API is a cloud-based API that provides the most advanced algorithms for face detection and recognition. Face API の主な機能は、属性による顔検出と顔の認識の 2 つのカテゴリに分類できます。The main functionality of Face API can be divided into two categories: face detection with attributes, and face recognition.

詳細については、Face API の概要に関するページ、「Face - Detect」(顔 - 検出)、「Face - Find Similar」(顔 - 類似検索)、「Face - Group」(顔 - グループ)、「Face - Identify」(顔 - 識別)、「Face - Verify」(顔 - 検証) の各ガイドを参照してください。For more details, please refer to the following guides: Face API Overview, Face - Detect, Face - Find Similar, Face - Group, Face - Identify, Face - Verify.

顔の属性Face Attributes/Facial Attributes

詳しくは、「属性」をご覧ください。Please see Attributes.

顔 IDFace ID

顔 ID は検出結果から派生します。ここでは、文字列が Face APIを表します。Face ID is derived from the detection results, in which a string represents a face in Face API.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

顔のランドマークFace Landmarks/Facial Landmarks

ランドマークは、顔のセマンティック ポイント (目、鼻、口など) である検出結果から省略可能です (次の図に示します)。Landmarks are optional in the detection results; which are semantic facial points, such as the eyes, nose and mouth (illustrated in following figure). ランドマークは、ブール値 returnFaceLandmarks によって検出要求で制御できます。Landmarks can be controlled with a detection request by the Boolean number returnFaceLandmarks. returnFaceLandmarks が true に設定されると、返される顔にはランドマーク属性があります。If returnFaceLandmarks is set as true, the returned faces will have landmark attributes.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

HowToDetectFace

顔四角形Face Rectangle

顔四角形は検出結果から派生し、イメージ内の矩形 (左、上、幅、高さ) をピクセル単位で表します。Face rectangle is derived from the detection results, which is an upright rectangle (left, top, width, height) in images in pixels. の左上隅 (左、上 ) の、幅と高さの隣は、x 軸 と y 軸でそれぞれ顔のサイズを示します。The top-left corner of a face (left, top), besides the width and height, indicates face sizes in x and y axes respectively.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

髭 (属性)Facial Hair (Attribute)

髭は、対象の顔の髭の長さを表すのに使用される属性の 1 つです。Facial hair is one of the attributes used to describe the facial hair length of the available faces. 髭属性は検出結果から省略可能であり、returnFaceAttributes によって検出要求で制御できます。The facial hair attribute is optional in the detection results, and can be controlled with a detection request by returnFaceAttributes. returnFaceAttributes に 'facialHair' が含まれていると、返される顔には髭属性が指定されます。If returnFaceAttributes contains 'facialHair', the returned faces will have facial hair attributes.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

FaceListFaceList

FaceList は PersistedFace のコレクションで、類似検索のユニットです。FaceList is a collection of PersistedFace and is the unit of Find Similar. FaceList には、FaceList ID のほか、名前やユーザー データなどのその他の属性が付属します。A FaceList comes with a FaceList ID, as well as other attributes such as Name and User Data.

詳細については、「FaceList - Create」(FaceList - 作成)、「FaceList - Get」(FaceList - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: FaceList - Create, FaceList - Get.

FaceList IDFaceList ID

FaceList ID は、FaceList の識別子として使用される、ユーザー指定の ID です。FaceList ID is a user provided string used as an identifier of a FaceList. FaceList ID は、サブスクリプション内で一意である必要があります。The FaceList ID must be unique within the subscription.

詳細については、「FaceList - Create」(FaceList - 作成)、「FaceList - Get」(FaceList - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: FaceList - Create, FaceList - Get.

類似検索Find Similar

この API は、顔のコレクションに基づいて類似の顔の検索/クエリに使用されます。This API is used to search/query similar faces based on a collection of faces. 顔や顔のコレクションのクエリは、要求内で顔 ID または FceList ID/LargeFaceList ID で表されます。Query faces and face collections are represented as face IDs or FceList ID/LargeFaceList ID in the request. 返される結果は、顔 ID または PersistedFace IDで表される、検索された類似の顔になります。Returned results are searched similar faces, represented by face IDs or PersistedFace IDs.

詳細については、「Face - Find Similar」(顔 - 類似検索)、「LargeFaceList - Create」(LargeFaceList - 作成)、「FaceList - Create」(FaceList - 作成) の各ガイドを参照してください。For more details, please refer to the following guides: Face - Find Similar, LargeFaceList - Create, FaceList - Create.

GG

性別 (属性)Gender (Attribute)

性別は、対象の顔の性別を表すのに使用される属性の 1 つです。Gender is one of the attributes used to describe the genders of the available faces. 性別属性は検出結果から省略可能であり、returnFaceAttributes によって検出要求で制御できます。The gender attribute is optional in the detection results, and can be controlled with a detection request by returnFaceAttributes. returnFaceAttributes に 'gender' が含まれていると、返される顔には性別属性が指定されます。If returnfaceAttributes contains 'gender', the returned faces will have gender attributes.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

グループ化Grouping

顔のグループ化とは、顔の類似性に基づいて顔のコレクションをグループ化することです。Face grouping is the grouping of a collection of faces according to facial similarities. 顔のコレクションは、その要求内で顔 ID のコレクションによって示されます。Face collections are indicated by the face ID collections in the request. グループ化の結果、類似の顔が一緒のグループにグループ化され、他のどの顔にも類似していない顔は、不揃いのグループにマージされます。As a result of grouping, similar faces are grouped together as groups, and faces that are not similar to any other face are merged together as a messy group. グループ化の結果には、最大で 1 つの不揃いのグループが存在します。There is at the most, one messy group in the grouping result.

詳しくは、ガイド「Face - Group」(顔 - グループ) をご覧ください。For more details, please refer to the guide Face - Group.

グループGroups

グループは、グループ化の結果から派生します。Groups are derived from the grouping results. 各グループには類似の顔が含まれ、顔は顔 ID によって示されます。Each group contains a collection of similar faces, where faces are indicated by face IDs.

詳しくは、ガイド「Face - Group」(顔 - グループ) をご覧ください。For more details, please refer to the guide Face - Group.

HH

頭部姿勢 (属性)Head Pose (Attribute)

頭部姿勢は、次の図に示すように、ロール、ピッチ、ヨー角に基づいて、3D 空間における顔の向きを表す属性の 1 つです。Head pose is one of the attributes that represents face orientation in 3D space according to roll, pitch and yaw angles, as shown in following figure. ロールとヨー角の値の範囲は、[-180, 180] と [-90, 90] です。The value ranges of roll and yaw are [-180, 180] and [-90, 90] in degrees. 最新バージョンでは、検出から返されるピッチの値は常に 0 です。In the current version, the pitch value returned from detection is always 0. 頭部姿勢属性は検出結果から省略可能であり、returnFaceAttributes パラメーターによって検出要求で制御できます。The head pose attribute is optional in the detection results, and can be controlled with a detection request by the returnFaceAttributes parameter. returnFaceAttributes パラメーターに 'headPose' が含まれていると、返される顔には頭部姿勢属性が指定されています。If returnFaceAttributes parameter contains 'headPose', the returned faces will have head pose attributes.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

GlossaryHeadPose

II

識別Identification

識別とは、LargePersonGroup/PersonGroup から 1 つ以上の顔を識別することです。Identification is to identify one or more faces from a LargePersonGroup/PersonGroup. PersonGroup/LargePersonGroup は、人物のコレクションです。A PersonGroup/LargePersonGroup is a collection of Persons. 顔と LargePersonGroup/PersonGroup は、その要求内でそれぞれ顔 ID LargePersonGroup ID/PersonGroup ID によって表されます。Faces and the LargePersonGroup/PersonGroup are represented by face IDs and LargePersonGroup IDs/PersonGroup IDs respectively in the request. 識別された結果は、信頼度とともに人物で表される候補です。Identified results are candidates, represented by Persons with confidence. 入力内の複数の顔は別個のものと見なされ、各顔にはそれぞれ独自の識別された結果を持ちます。Multiple faces in the input are considered separately, and each face will have its own identified result.

注意

LargePersonGroup/PersonGroup は、識別の前に正常にトレーニングが行われている必要があります。The LargePersonGroup/PersonGroup should be trained successfully before identification. LargePersonGroup/PersonGroup がトレーニングを受けていない場合や、トレーニングの状態が 'succeeded' と表示されていない (つまり、'running'、'failed'、または 'timeout' と表示されている) 場合、要求の応答は 400 になります。If the LargePersonGroup/PersonGroup is not trained, or the training status is not shown as 'succeeded' (i.e. 'running', 'failed', or 'timeout'), the request response is 400.

詳細については、「Face - Identify」(顔 - 識別)、「LargePersonGroup Person - Create」(LargePersonGroup の人物 - 作成)、「LargePersonGroup - Create」(LargePersonGroup - 作成)、「LargePersonGroup - Train」(LargePersonGroup - トレーニング)、「PersonGroup Person - Create」(PersonGroup の人物 - 作成)、「PersonGroup - Create」(PersonGroup - 作成)、「PersonGroup - Train」(PersonGroup - トレーニング) の各ガイドを参照してください。For more details, please refer to the following guides: Face - Identify, LargePersonGroup Person - Create, LargePersonGroup - Create, LargePersonGroup - Train, PersonGroup Person - Create, PersonGroup - Create, PersonGroup - Train.

IsIdenticalIsIdentical

IsIdentical は検証結果のブール値フィールドで、2 つの顔が同じ人物のものであるかどうかを示します。IsIdentical is a Boolean field of verification results indicating whether two faces belong to the same person.

詳しくは、ガイド「Face - Verify」(顔 - 検証) をご覧ください。For more details, please refer to the guide Face - Verify.

JJ

KK

LL

ランドマークLandmarks

「顔のランドマーク」を参照してください。Please see face landmarks.

LargeFaceListLargeFaceList

LargeFaceList は PersistedFace のコレクションで、類似検索のユニットです。LargeFaceList is a collection of PersistedFace and is the unit of Find Similar. LargeFaceList には、LargeFaceList ID のほか、名前やユーザー データなどのその他の属性が付属します。A LargeFaceList comes with a LargeFaceList ID, as well as other attributes such as Name and User Data.

詳細については、「LargeFaceList - Create」(LargeFaceList - 作成)、「LargeFaceList - Get」(LargeFaceList - 取得)、「LargeFaceList - List Face」(FaceList - 顔のリスト) の各ガイドを参照してください。For more details, please refer to the following guides: LargeFaceList - Create, LargeFaceList - Get, LargeFaceList - List Face.

LargeFaceList IDLargeFaceList ID

LargeFaceList ID は、LargeFaceList の識別子として使用される、ユーザー指定の ID です。LargeFaceList ID is a user provided string used as an identifier of a LargeFaceList. LargeFaceList ID は、サブスクリプション内で一意である必要があります。The LargeFaceList ID must be unique within the subscription.

詳細については、「LargeFaceList - Create」(LargeFaceList - 作成)、「LargeFaceList - Get」(LargeFaceList - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: LargeFaceList - Create, LargeFaceList - Get.

LargePersonGroupLargePersonGroup

LargePersonGroup は人物のコレクションで、識別のユニットです。LargePersonGroup is a collection of Persons and is the unit of Identification. LargePersonGroup には、LargePersonGroup ID のほか、名前やユーザー データなどのその他の属性が付属します。A LargePersonGroup comes with a LargePersonGroup ID, as well as other attributes such as Name and User Data.

詳細については、「LargePersonGroup - Create」(LargePersonGroup - 作成)、「LargePersonGroup - Get」(LargePersonGroup - 取得)、「LargePersonGroup Person - List」(LargePersonGroup の人物 - リスト) の各ガイドを参照してください。For more details, please refer to the following guides: LargePersonGroup - Create, LargePersonGroup - Get, LargePersonGroup Person - List.

LargePersonGroup IDLargePersonGroup ID

LargePersonGroup ID は、LargePersonGroup の識別子として使用される、ユーザー指定の文字列です。LargePersonGroup ID is a user provided string used as an identifier of a LargePersonGroup. LargePersonGroup ID は、サブスクリプション内で一意である必要があります。The LargePersonGroup ID must be unique within the subscription.

詳細については、「LargePersonGroup - Create」(LargePersonGroup - 作成)、「LargePersonGroup - Get」(LargePersonGroup - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: LargePersonGroup - Create, LargePersonGroup - Get.

MM

不揃いのグループMessy group

不揃いのグループはグループ化の結果から派生し、他のどの顔とも類似していない顔が含まれます。Messy group is derived from the grouping results; which contains faces not similar to any other face. 不揃いのグループ内の顔はそれぞれ顔 ID で示されます。Each face in a messy group is indicated by the face ID.

詳しくは、ガイド「Face - Group」(顔 - グループ) をご覧ください。For more details, please refer to the guide Face - Group.

NN

名前 (人物)Name (Person)

名前は、人物をわかりやすく説明する文字列です。Name is a user friendly descriptive string for Person. 人物 ID とは異なり、人物の名前はグループ内で重複してかまいません。Unlike the Person ID, the name of people can be duplicated within a group.

詳細については、「LargePersonGroup Person - Create」(LargePersonGroup の人物 - 作成)、「LargePersonGroup Person - Get」(LargePersonGroup の人物 - 取得)、「PersonGroup Person - Create」(PersonGroup の人物 - 作成)、「PersonGroup Person - Get」(PersonGroup の人物 - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: LargePersonGroup Person - Create, LargePersonGroup Person - Get, PersonGroup Person - Create, PersonGroup Person - Get.

名前 (LargePersonGroup/PersonGroup)Name (LargePersonGroup/PersonGroup)

名前は、LargePersonGroup/PersonGroup をわかりやすく説明する文字列です。Name is also a user friendly descriptive string for LargePersonGroup/PersonGroup. LargePersonGroup ID/PersonGroup ID とは異なり、LargePersonGroup/PersonGroup の名前はサブスクリプション内で重複してかまいません。Unlike the LargePersonGroup ID/PersonGroup ID, the name of LargePersonGroups/PersonGroups can be duplicated within a subscription.

詳細については、「LargePersonGroup - Create」(LargePersonGroup - 作成)、「LargePersonGroup - Get」(LargePersonGroup - 取得)、「PersonGroup - Create」(PersonGroup - 作成)、「PersonGroup - Get」(PersonGroup - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: LargePersonGroup - Create, LargePersonGroup - Get, PersonGroup - Create, PersonGroup - Get.

OO

PP

PersistedFacePersistedFace

PersistedFace は、Face API のデータ構造です。PersistedFace is a data structure in Face API. PersistedFace には、PersistedFace ID のほか、名前やユーザー データなどのその他の属性が付属します。PersistedFace comes with a PersistedFace ID, as well as other attributes such as Name, and User Data.

詳細については、「LargeFaceList - Add Face」(LargeFaceList - 顔の追加)、「FaceList - Add Face」(FaceList - 顔の追加)、「LargePersonGroup Person - Add Face」(LargePersonGroup の人物 - 顔の追加)、「PersonGroup Person - Add Face」(PersonGroup の人物 - 顔の追加) の各ガイドを参照してください。For more details, please refer to the following guides: LargeFaceList - Add Face, FaceList - Add Face, LargePersonGroup Person - Add Face, PersonGroup Person - Add Face.

人物 IDPerson ID

人物 ID は、PersistedFace が正常に作成されると生成されます。Person ID is generated when a PersistedFace is created successfully. Face API でこの顔を表す文字列が作成されます。A string is created to represent this Face in Face API.

詳細については、「LargeFaceList - Add Face」(LargeFaceList - 顔の追加)、「FaceList - Add Face」(FaceList - 顔の追加)、「LargePersonGroup Person - Add Face」(LargePersonGroup の人物 - 顔の追加)、「PersonGroup Person - Add Face」(PersonGroup の人物 - 顔の追加) の各ガイドを参照してください。For more details, please refer to the following guides: LargeFaceList - Add Face, FaceList - Add Face, LargePersonGroup Person - Add Face, PersonGroup Person - Add Face.

PersonPerson

人物は、Face API で管理されるデータ構造です。Person is a data structure managed in Face API. 人物には、人物 ID のほか、名前、PersistedFace のコレクション、ユーザー データなどのその他の属性が付属します。Person comes with a Person ID, as well as other attributes such as Name, a collection of PersistedFace, and User Data.

詳細については、「LargePersonGroup Person - Create」(LargePersonGroup の人物 - 作成)、「LargePersonGroup Person - Get」(LargePersonGroup の人物 - 取得)、「PersonGroup Person - Create」(PersonGroup の人物 - 作成)、「PersonGroup Person - Get」(PersonGroup の人物 - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: LargePersonGroup Person - Create, LargePersonGroup Person - Get, PersonGroup Person - Create, PersonGroup Person - Get.

人物 IDPerson ID

人物 ID は、人物が正常に作成されると生成されます。Person ID is generated when a Person is created successfully. Face API でこの人物を表す文字列が作成されます。A string is created to represent this person in Face API.

詳細については、「LargePersonGroup Person - Create」(LargePersonGroup の人物 - 作成)、「LargePersonGroup Person - Get」(LargePersonGroup の人物 - 取得)、「PersonGroup Person - Create」(PersonGroup の人物 - 作成)、「PersonGroup Person - Get」(PersonGroup の人物 - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: LargePersonGroup Person - Create, LargePersonGroup Person - Get, PersonGroup Person - Create, PersonGroup Person - Get.

PersonGroupPersonGroup

PersonGroup は人物のコレクションで、識別のユニットです。PersonGroup is a collection of Persons and is the unit of Identification. PersonGroup には、PersonGroup ID のほか、名前やユーザー データなどのその他の属性が付属します。A PersonGroup comes with a PersonGroup ID, as well as other attributes such as Name and User Data.

詳細については、「PersonGroup - Create」(PersonGroup - 作成)、「PersonGroup - Get」(PersonGroup - 取得)、「PersonGroup Person - List」(PersonGroup の人物 - リスト) の各ガイドを参照してください。For more details, please refer to the following guides: PersonGroup - Create, PersonGroup - Get, PersonGroup Person - List.

PersonGroup IDPersonGroup ID

PersonGroup ID は、PersonGroup の識別子として使用される、ユーザー指定の文字列です。PersonGroup ID is a user provided string used as an identifier of a PersonGroup. グループ ID は、サブスクリプション内で一意である必要があります。The group ID must be unique within the subscription.

詳細については、「PersonGroup - Create」(PersonGroup - 作成)、「PersonGroup - Get」(PersonGroup - 取得) の各ガイドを参照してください。For more details, please refer to the following guides: PersonGroup - Create, PersonGroup - Get.

姿勢 (属性)Pose (Attribute)

頭部姿勢」をご覧ください。Please see Head Pose.

QQ

RR

認識Recognition

認識は、類似検索グループ化識別2 つの顔が同じであるかどうかの検証など、顔認識テクノロジにおいて一般的なアプリケーション領域です。Recognition is a popular application area for face technologies, such as Find Similar, Grouping, Identify,verifying two faces same or not.

詳細については、「Face - Find Similar」(顔 - 類似検索)、「Face - Group」(顔 - グループ)、「Face - Identify」(顔 - 識別)、「Face - Verify」(顔 - 検証) の各ガイドを参照してください。For more details, please refer to the following guides: Face - Find Similar, Face - Group, Face - Identify, Face - Verify.

四角形 (顔)Rectangle (Face)

顔四角形」をご覧ください。Please see face rectangle.

SS

類似した顔の検索Similar Face Searching

類似検索」をご覧ください。Please see Find Similar.

笑顔 (属性)Smile (Attribute)

笑顔は、対象の顔の笑顔を表すのに使用される属性の 1 つです。Smile is one of the attributes used to describe the smile expression of the available faces. 笑顔属性は検出結果から省略可能であり、returnFaceAttributes によって検出要求で制御できます。The smile attribute is optional in the detection results, and can be controlled with a detection request by returnFaceAttributes. returnFaceAttributes に 'smile' が含まれていると、返される顔には笑顔属性が指定されます。If returnFaceAttributes contains 'smile', the returned faces will have smile attributes.

詳しくは、ガイド「Face - Detect」(顔 - 検出) をご覧ください。For more details, please refer to the guide Face - Detect.

スナップショットSnapshot

スナップショットは、特定の顔データ型のための一時的なリモート ストレージです。A snapshot is a temporary remote storage for certain Face data types. これは、あるサブスクリプションから別のサブスクリプションにデータをコピーするための一種のクリップボードとして機能します。It functions as a kind of clipboard to copy data from one subscription to another. 最初に、ユーザーはソース サブスクリプション内のデータのスナップショットを "取得" し、次にそれをターゲット サブスクリプション内の新しいデータ オブジェクトに "適用" します。First the user "takes" a snapshot of the data in the source subscription, and then they "apply" it to a new data object in the target subscription.

詳細については、顔の移行ガイドのほか、「Snapshot - Take」(スナップショット - 作成) および「Snapshot - Apply」(スナップショット - 適用) のリファレンス ドキュメント (REST) を参照してください。For more details, see Face migration guide as well as the Snapshot - Take and Snapshot - Apply reference documentation (REST).

状態 (トレーニング)Status (Train)

状態は、'notstarted'、'running'、'succeeded'、'failed' などの、LargeFaceList/LargePersonGroups/PersonGroups をトレーニングするための手順を記述するために使用される文字列です。Status is a string used to describe the procedure for Training LargeFaceList/LargePersonGroups/PersonGroups, including 'notstarted', 'running', 'succeeded', 'failed'.

詳しくは、「LargeFaceList - Train」(LargeFaceList - トレーニング)、「LargePersonGroup - Train」(LargePersonGroup - トレーニング)、「PersonGroup - Train」(PersonGroup - トレーニング) の各ガイドをご覧ください。For more details, please refer to the guide LargeFaceList - Train, LargePersonGroup - Train, PersonGroup - Train.

Subscription keySubscription key

サブスクリプション キーは、Face API を呼び出すために、クエリ文字列パラメーターとして指定する必要がある文字列です。Subscription key is a string that you need to specify as a query string parameter in order to invoke any Face API. サブスクリプション キーは、Microsoft Cognitive Services ポータルにサインインした後に、[個人用サブスクリプション] ページで確認できます。The subscription key can be found in My Subscriptions page after you sign in to Microsoft Cognitive Services portal. 各サブスクリプションには、主キー 1 つと 2 次キー 1 つの 2 つのキーが関連付けられています。There will be two keys associated with each subscription: one primary key and one secondary key. 両方とも API を同じように呼び出すことができます。Both can be used to invoke API identically. サブスクリプション キーは安全に保管する必要があります。また、サブスクリプション キーは [個人用サブスクリプション] ページでいつでも再生成できます。You need to keep the subscription keys secure, and you can regenerate subscription keys at any time from My Subscriptions page as well.

TT

トレーニング (LargeFaceList/LargePersonGroup/PersonGroup)Train (LargeFaceList/LargePersonGroup/PersonGroup)

この API は、Find Similar/Identification のパフォーマンスを確保するために、LargeFaceList/LargePersonGroup/PersonGroup を事前処理するために使用されます。This API is used to pre-process the LargeFaceList/LargePersonGroup/PersonGroup to ensure the Find Similar/Identification performance. トレーニングを行わない、またはトレーニングの状態が成功と表示されていない場合、この PersonGroup の識別は失敗します。If the training is not operated, or the Training Status is not shown as succeeded, the identification for this PersonGroup will result in failure.

詳細については、「LargeFaceList - Train」(LargeFaceList - トレーニング)、「LargePersonGroup - Train」(LargePersonGroup - トレーニング)、「PersonGroup - Train」(PersonGroup - トレーニング)、「Face - Identify」(顔 - 識別) の各ガイドを参照してください。For more details, please refer to the following guides: LargeFaceList - Train, LargePersonGroup - Train, PersonGroup - Train, Face - Identify.

UU

UserData/ユーザー データUserData/User Data

ユーザー データは、人物PersonGroup/LargePersonGroup に関連付けられている追加情報です。User data is extra information associated with Person and PersonGroup/LargePersonGroup. ユーザー データはユーザーが設定することで、データの使用、理解、記憶がより簡単になります。User data is set by users to make data easier to use, understand and remember.

詳細については、「LargePersonGroup - Create」(LargePersonGroup - 作成)、「LargePersonGroup - Update」(LargePersonGroup - 更新)、「LargePersonGroup Person - Create」(LargePersonGroup の人物 - 作成)、「LargePersonGroup Person - Update」(LargePersonGroup の人物 - 更新)、「PersonGroup - Create」(PersonGroup - 作成)、「PersonGroup - Update」(PersonGroup - 更新)、「PersonGroup Person - Create」(PersonGroup の人物 - 作成)、「PersonGroup Person - Update」(PersonGroup の人物 - 更新) の各ガイドを参照してください。For more details, please refer to the following guides: LargePersonGroup - Create, LargePersonGroup - Update, LargePersonGroup Person - Create, LargePersonGroup Person - Update, PersonGroup - Create, PersonGroup - Update, PersonGroup Person - Create, PersonGroup Person - Update.

VV

確認Verification

この API は、2 つの顔が同じであるかどうかを検証します。This API is used to verify whether two faces are the same or not. 両方の顔は、その要求内で顔 ID として表されます。Both faces are represented as face IDs in the request. 検証された結果には、true の場合は同じであることを示すブール値フィールド (isIdentical) と、信頼のレベルを示す数値フィールド (confidence) が含まれています。Verified results contain a Boolean field (isIdentical) indicating same if true and a number field (confidence) indicating the level of confidence.

詳しくは、ガイド「Face - Verify」(顔 - 検証) をご覧ください。For more details, please refer to the guide Face - Verify.

WW

XX

YY

ZZ