Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menambahkan wajah ke koleksi
Anda dapat menggunakan operasi [IndexFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_IndexFaces.html) untuk mendeteksi wajah dalam citra dan menambahkannya ke koleksi. Untuk setiap wajah yang terdeteksi, Amazon Rekognition mengekstraksi fitur wajah dan menyimpan informasi fitur dalam basis data. Selain itu, perintah tersebut menyimpan metadata untuk setiap wajah yang terdeteksi dalam koleksi wajah tertentu. Amazon Rekognition tidak menyimpan bit citra yang sebenarnya.
Untuk informasi tentang memberikan wajah yang cocok untuk pengindeksan, lihat [Rekomendasi untuk citra input perbandingan wajah](recommendations-facial-input-images.md).
Untuk setiap wajah, operasi `IndexFaces` menyimpan informasi berikut:
+ **Fitur wajah multidimensi** — `IndexFaces` menggunakan analisis wajah untuk mengekstraksi informasi multidimensi tentang fitur wajah dan menyimpan informasi tersebut dalam koleksi wajah. Anda tidak dapat mengakses informasi ini secara langsung. Namun, Amazon Rekognition menggunakan informasi ini ketika mencari koleksi wajah untuk mencocokkan wajah.
+ **Metadata** — Metadata untuk setiap wajah mencakup kotak pembatas, tingkat kepercayaan (bahwa kotak pembatas berisi wajah), ID yang ditetapkan oleh Amazon Rekognition (ID wajah dan ID citra), dan ID citra eksternal (jika Anda memberikannya) dalam permintaan. Informasi ini dikembalikan kepada Anda sebagai respons atas panggilan API `IndexFaces`. Misalnya, lihat elemen `face` dalam respons contoh berikut.
Layanan akan mengembalikan metadata ini sebagai respons terhadap panggilan API berikut:
+ `[ListFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListFaces.html)`
+ Operasi pencarian wajah — Respons untuk [SearchFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_SearchFaces.html) dan [SearchFacesByImage](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_SearchFacesByImage.html) mengembalikan kepercayaan dalam mencocokkan untuk setiap wajah yang cocok, bersama dengan metadata dari wajah cocok ini.
Jumlah muka yang terindeks oleh `IndexFaces` tergantung pada versi model deteksi wajah yang terkait dengan koleksi input. Untuk informasi selengkapnya, lihat [Memahami versi model](face-detection-model.md).
Informasi tentang wajah yang terindeks dikembalikan dalam array objek [FaceRecord](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_FaceRecord.html).
Anda mungkin ingin mengaitkan wajah yang terindeks dengan citra yang terdeteksi dengan wajah tersebut. Misalnya, Anda mungkin ingin mempertahankan indeks sisi klien citra dan wajah dalam citra. Untuk mengaitkan wajah dengan citra, tentukan ID citra di parameter permintaan `ExternalImageId`. ID citra dapat berupa nama file atau ID lain yang Anda buat.
Selain informasi sebelumnya bahwa API tetap ada di koleksi wajah, API juga mengembalikan detail wajah yang tidak tersimpan dalam koleksi. (Lihat elemen `faceDetail` dalam respons contoh berikut).
**catatan**
`DetectFaces` menampilkan informasi yang sama, sehingga Anda tidak perlu memanggil `DetectFaces` dan `IndexFaces` untuk citra yang sama.
## Memfilter wajah
IndexFaces Operasi ini memungkinkan Anda untuk memfilter wajah yang diindeks dari gambar. Dengan `IndexFaces` Anda dapat menentukan jumlah maksimum wajah untuk diberi indeks, atau Anda dapat memilih untuk hanya mengindeks wajah terdeteksi dengan kualitas tinggi.
Anda dapat menentukan jumlah maksimum wajah yang diindeks oleh `IndexFaces` dengan menggunakan parameter input `MaxFaces`. Hal ini berguna apabila Anda ingin mengindeks wajah terbesar dalam citra dan tidak ingin mengindeks wajah yang lebih kecil, seperti wajah orang yang berdiri di baliknya.
Secara default, `IndexFaces` memilih bilah kualitas yang digunakan untuk memfilter wajah. Anda dapat menggunakan parameter input `QualityFilter` untuk secara eksplisit mengatur bilah kualitas. Nilainya adalah:
+ `AUTO` — Amazon Rekognition memilih bar kualitas yang digunakan untuk memfilter wajah (nilai default).
+ `LOW` — Semua kecuali wajah kualitas terendah diindeks.
+ `MEDIUM`
+ `HIGH` — Hanya wajah kualitas tertinggi yang diindeks.
+ `NONE` - Tidak ada wajah yang disaring berdasarkan kualitas.
`IndexFaces` memfilter wajah karena alasan berikut:
+ Wajah terlalu kecil dibandingkan dengan dimensi citra.
+ Wajah terlalu buram.
+ Citra terlalu gelap.
+ Wajah memiliki pose yang ekstrem.
+ Wajah tidak memiliki cukup detail agar cocok untuk pencarian wajah.
**catatan**
Untuk menggunakan penyaringan berkualitas, Anda memerlukan koleksi yang terkait dengan model wajah versi 3 atau lebih tinggi. Untuk mendapatkan versi model wajah yang terkait dengan koleksi, panggil [DescribeCollection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeCollection.html).
Informasi tentang wajah yang tidak terindeks oleh `IndexFaces` dikembalikan dalam array objek [UnindexedFace](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UnindexedFace.html). Array `Reasons` berisi daftar alasan mengapa wajah tidak diindeks. Misalnya, nilai `EXCEEDS_MAX_FACES` adalah wajah yang tidak diindeks karena jumlah wajah yang ditentukan oleh `MaxFaces` telah terdeteksi.
Untuk informasi selengkapnya, lihat [Mengelola wajah dalam koleksi](managing-face-collections.md#collections-index-faces).
**Menambahkan wajah ke koleksi (SDK)**
1. Jika belum:
1. Buat atau perbarui pengguna dengan `AmazonRekognitionFullAccess` dan `AmazonS3ReadOnlyAccess` izin. Untuk informasi selengkapnya, lihat [Langkah 1: Siapkan akun AWS dan buat Pengguna](setting-up.md#setting-up-iam).
1. Instal dan konfigurasikan AWS CLI dan AWS SDK. Untuk informasi selengkapnya, lihat [Langkah 2: Siapkan AWS CLI and AWS SDK](setup-awscli-sdk.md).
1. Unggah citra (berisi satu wajah atau lebih) ke bucket Amazon S3.
Untuk petunjuk, lihat [Mengunggah Objek ke Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UploadingObjectsintoAmazonS3.html) S3 di Panduan Pengguna *Layanan Penyimpanan Sederhana Amazon*.
1. Gunakan contoh berikut untuk memanggil operasi `IndexFaces`.
------
#### [ Java ]
Contoh ini menampilkan pengenal wajah untuk wajah yang ditambahkan ke koleksi.
Ubah nilai `collectionId` untuk nama koleksi yang ingin ditambahkan wajah. Ganti nilai-nilai `bucket` dan `photo` dengan nama bucket Amazon S3 dan citra yang Anda gunakan di langkah 2. Parameter `.withMaxFaces(1)` membatasi jumlah wajah yang diindeks menjadi 1. Hapus atau ubah nilainya sesuai dengan kebutuhan Anda.
```
//Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
//PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
package aws.example.rekognition.image;
import com.amazonaws.services.rekognition.AmazonRekognition;
import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
import com.amazonaws.services.rekognition.model.FaceRecord;
import com.amazonaws.services.rekognition.model.Image;
import com.amazonaws.services.rekognition.model.IndexFacesRequest;
import com.amazonaws.services.rekognition.model.IndexFacesResult;
import com.amazonaws.services.rekognition.model.QualityFilter;
import com.amazonaws.services.rekognition.model.S3Object;
import com.amazonaws.services.rekognition.model.UnindexedFace;
import java.util.List;
public class AddFacesToCollection {
public static final String collectionId = "MyCollection";
public static final String bucket = "bucket";
public static final String photo = "input.jpg";
public static void main(String[] args) throws Exception {
AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
Image image = new Image()
.withS3Object(new S3Object()
.withBucket(bucket)
.withName(photo));
IndexFacesRequest indexFacesRequest = new IndexFacesRequest()
.withImage(image)
.withQualityFilter(QualityFilter.AUTO)
.withMaxFaces(1)
.withCollectionId(collectionId)
.withExternalImageId(photo)
.withDetectionAttributes("DEFAULT");
IndexFacesResult indexFacesResult = rekognitionClient.indexFaces(indexFacesRequest);
System.out.println("Results for " + photo);
System.out.println("Faces indexed:");
List faceRecords = indexFacesResult.getFaceRecords();
for (FaceRecord faceRecord : faceRecords) {
System.out.println(" Face ID: " + faceRecord.getFace().getFaceId());
System.out.println(" Location:" + faceRecord.getFaceDetail().getBoundingBox().toString());
}
List unindexedFaces = indexFacesResult.getUnindexedFaces();
System.out.println("Faces not indexed:");
for (UnindexedFace unindexedFace : unindexedFaces) {
System.out.println(" Location:" + unindexedFace.getFaceDetail().getBoundingBox().toString());
System.out.println(" Reasons:");
for (String reason : unindexedFace.getReasons()) {
System.out.println(" " + reason);
}
}
}
}
```
------
#### [ Java V2 ]
Kode ini diambil dari GitHub repositori contoh SDK AWS Dokumentasi. Lihat contoh lengkapnya [di sini](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javav2/example_code/rekognition/src/main/java/com/example/rekognition/AddFacesToCollection.java).
```
//snippet-start:[rekognition.java2.add_faces_collection.import]
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.core.SdkBytes;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.rekognition.RekognitionClient;
import software.amazon.awssdk.services.rekognition.model.IndexFacesResponse;
import software.amazon.awssdk.services.rekognition.model.IndexFacesRequest;
import software.amazon.awssdk.services.rekognition.model.Image;
import software.amazon.awssdk.services.rekognition.model.QualityFilter;
import software.amazon.awssdk.services.rekognition.model.Attribute;
import software.amazon.awssdk.services.rekognition.model.FaceRecord;
import software.amazon.awssdk.services.rekognition.model.UnindexedFace;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
import software.amazon.awssdk.services.rekognition.model.Reason;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.InputStream;
import java.util.List;
//snippet-end:[rekognition.java2.add_faces_collection.import]
/**
* Before running this Java V2 code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class AddFacesToCollection {
public static void main(String[] args) {
final String usage = "\n" +
"Usage: " +
" \n\n" +
"Where:\n" +
" collectionName - The name of the collection.\n" +
" sourceImage - The path to the image (for example, C:\\AWS\\pic1.png). \n\n";
if (args.length != 2) {
System.out.println(usage);
System.exit(1);
}
String collectionId = args[0];
String sourceImage = args[1];
Region region = Region.US_EAST_1;
RekognitionClient rekClient = RekognitionClient.builder()
.region(region)
.credentialsProvider(ProfileCredentialsProvider.create("profile-name"))
.build();
addToCollection(rekClient, collectionId, sourceImage);
rekClient.close();
}
// snippet-start:[rekognition.java2.add_faces_collection.main]
public static void addToCollection(RekognitionClient rekClient, String collectionId, String sourceImage) {
try {
InputStream sourceStream = new FileInputStream(sourceImage);
SdkBytes sourceBytes = SdkBytes.fromInputStream(sourceStream);
Image souImage = Image.builder()
.bytes(sourceBytes)
.build();
IndexFacesRequest facesRequest = IndexFacesRequest.builder()
.collectionId(collectionId)
.image(souImage)
.maxFaces(1)
.qualityFilter(QualityFilter.AUTO)
.detectionAttributes(Attribute.DEFAULT)
.build();
IndexFacesResponse facesResponse = rekClient.indexFaces(facesRequest);
System.out.println("Results for the image");
System.out.println("\n Faces indexed:");
List faceRecords = facesResponse.faceRecords();
for (FaceRecord faceRecord : faceRecords) {
System.out.println(" Face ID: " + faceRecord.face().faceId());
System.out.println(" Location:" + faceRecord.faceDetail().boundingBox().toString());
}
List unindexedFaces = facesResponse.unindexedFaces();
System.out.println("Faces not indexed:");
for (UnindexedFace unindexedFace : unindexedFaces) {
System.out.println(" Location:" + unindexedFace.faceDetail().boundingBox().toString());
System.out.println(" Reasons:");
for (Reason reason : unindexedFace.reasons()) {
System.out.println("Reason: " + reason);
}
}
} catch (RekognitionException | FileNotFoundException e) {
System.out.println(e.getMessage());
System.exit(1);
}
}
// snippet-end:[rekognition.java2.add_faces_collection.main]
}
```
------
#### [ AWS CLI ]
AWS CLI Perintah ini menampilkan output JSON untuk operasi `index-faces` CLI.
Ganti nilai `collection-id` dengan nama koleksi tempat Anda ingin wajah itu disimpan. Mengganti nilai-nilai `Bucket` dan `Name` dengan bucket Amazon S3 dan file citra yang Anda gunakan pada langkah 2. Parameter `max-faces` membatasi jumlah wajah yang diindeks menjadi 1. Hapus atau ubah nilainya sesuai dengan kebutuhan Anda. Ganti nilai `profile_name` di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda.
```
aws rekognition index-faces --image '{"S3Object":{"Bucket":"bucket-name","Name":"file-name"}}' --collection-id "collection-id" \
--max-faces 1 --quality-filter "AUTO" --detection-attributes "ALL" \
--external-image-id "example-image.jpg" --profile profile-name
```
Jika Anda mengakses CLI pada perangkat Windows, gunakan tanda kutip ganda alih-alih tanda kutip tunggal dan hindari tanda kutip ganda bagian dalam dengan garis miring terbalik (yaitu\\) untuk mengatasi kesalahan parser yang mungkin Anda temui. Sebagai contoh, lihat berikut ini:
```
aws rekognition index-faces --image "{\"S3Object\":{\"Bucket\":\"bucket-name\",\"Name\":\"image-name\"}}" \
--collection-id "collection-id" --max-faces 1 --quality-filter "AUTO" --detection-attributes "ALL" \
--external-image-id "example-image.jpg" --profile profile-name
```
------
#### [ Python ]
Contoh ini menampilkan pengenal wajah untuk wajah yang ditambahkan ke koleksi.
Ubah nilai `collectionId` untuk nama koleksi yang ingin ditambahkan wajah. Ganti nilai-nilai `bucket` dan `photo` dengan nama bucket Amazon S3 dan citra yang Anda gunakan di langkah 2. Parameter input `MaxFaces` membatasi jumlah wajah yang diindeks menjadi 1. Hapus atau ubah nilainya sesuai dengan kebutuhan Anda. Ganti nilai `profile_name` di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda.
```
# Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
# PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
import boto3
def add_faces_to_collection(bucket, photo, collection_id):
session = boto3.Session(profile_name='profile-name')
client = session.client('rekognition')
response = client.index_faces(CollectionId=collection_id,
Image={'S3Object': {'Bucket': bucket, 'Name': photo}},
ExternalImageId=photo,
MaxFaces=1,
QualityFilter="AUTO",
DetectionAttributes=['ALL'])
print('Results for ' + photo)
print('Faces indexed:')
for faceRecord in response['FaceRecords']:
print(' Face ID: ' + faceRecord['Face']['FaceId'])
print(' Location: {}'.format(faceRecord['Face']['BoundingBox']))
print('Faces not indexed:')
for unindexedFace in response['UnindexedFaces']:
print(' Location: {}'.format(unindexedFace['FaceDetail']['BoundingBox']))
print(' Reasons:')
for reason in unindexedFace['Reasons']:
print(' ' + reason)
return len(response['FaceRecords'])
def main():
bucket = 'amzn-s3-demo-bucket'
collection_id = 'collection-id'
photo = 'photo-name'
indexed_faces_count = add_faces_to_collection(bucket, photo, collection_id)
print("Faces indexed count: " + str(indexed_faces_count))
if __name__ == "__main__":
main()
```
------
#### [ .NET ]
Contoh ini menampilkan pengenal wajah untuk wajah yang ditambahkan ke koleksi.
Ubah nilai `collectionId` untuk nama koleksi yang ingin ditambahkan wajah. Ganti nilai-nilai `bucket` dan `photo` dengan nama bucket Amazon S3 dan citra yang Anda gunakan di langkah 2.
```
//Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
//PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
using System;
using System.Collections.Generic;
using Amazon.Rekognition;
using Amazon.Rekognition.Model;
public class AddFaces
{
public static void Example()
{
String collectionId = "MyCollection";
String bucket = "amzn-s3-demo-bucket";
String photo = "input.jpg";
AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
Image image = new Image()
{
S3Object = new S3Object()
{
Bucket = bucket,
Name = photo
}
};
IndexFacesRequest indexFacesRequest = new IndexFacesRequest()
{
Image = image,
CollectionId = collectionId,
ExternalImageId = photo,
DetectionAttributes = new List(){ "ALL" }
};
IndexFacesResponse indexFacesResponse = rekognitionClient.IndexFaces(indexFacesRequest);
Console.WriteLine(photo + " added");
foreach (FaceRecord faceRecord in indexFacesResponse.FaceRecords)
Console.WriteLine("Face detected: Faceid is " +
faceRecord.Face.FaceId);
}
}
```
------
## IndexFaces permintaan operasi
Input ke `IndexFaces` adalah citra yang akan diindeks dan koleksi untuk ditambahkan wajah atau beberapa wajah.
```
{
"CollectionId": "MyCollection",
"Image": {
"S3Object": {
"Bucket": "bucket",
"Name": "input.jpg"
}
},
"ExternalImageId": "input.jpg",
"DetectionAttributes": [
"DEFAULT"
],
"MaxFaces": 1,
"QualityFilter": "AUTO"
}
```
## IndexFaces respon operasi
`IndexFaces` mengembalikan informasi tentang wajah yang terdeteksi dalam citra. Misalnya, respons JSON berikut mencakup atribut deteksi default untuk wajah yang terdeteksi dalam citra input. Contoh tersebut juga menunjukkan wajah yang tidak terindeks karena nilai parameter input `MaxFaces` telah terlampaui — array `Reasons` berisi *EXCEEDS\_MAX\_FACES*. Jika wajah tidak diindeks karena alasan kualitas, `Reasons` berisi nilai-nilai seperti *KETAJAMAN\_RENDAH* atau *KECERAHAN\_RENDAH*. Untuk informasi selengkapnya, lihat [UnindexedFace](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_UnindexedFace.html).
```
{
"FaceModelVersion": "3.0",
"FaceRecords": [
{
"Face": {
"BoundingBox": {
"Height": 0.3247932195663452,
"Left": 0.5055555701255798,
"Top": 0.2743072211742401,
"Width": 0.21444444358348846
},
"Confidence": 99.99998474121094,
"ExternalImageId": "input.jpg",
"FaceId": "b86e2392-9da1-459b-af68-49118dc16f87",
"ImageId": "09f43d92-02b6-5cea-8fbd-9f187db2050d"
},
"FaceDetail": {
"BoundingBox": {
"Height": 0.3247932195663452,
"Left": 0.5055555701255798,
"Top": 0.2743072211742401,
"Width": 0.21444444358348846
},
"Confidence": 99.99998474121094,
"Landmarks": [
{
"Type": "eyeLeft",
"X": 0.5751981735229492,
"Y": 0.4010535478591919
},
{
"Type": "eyeRight",
"X": 0.6511467099189758,
"Y": 0.4017036259174347
},
{
"Type": "nose",
"X": 0.6314528584480286,
"Y": 0.4710812568664551
},
{
"Type": "mouthLeft",
"X": 0.5879443287849426,
"Y": 0.5171778798103333
},
{
"Type": "mouthRight",
"X": 0.6444502472877502,
"Y": 0.5164633989334106
}
],
"Pose": {
"Pitch": -10.313642501831055,
"Roll": -1.0316886901855469,
"Yaw": 18.079818725585938
},
"Quality": {
"Brightness": 71.2919921875,
"Sharpness": 78.74752044677734
}
}
}
],
"OrientationCorrection": "",
"UnindexedFaces": [
{
"FaceDetail": {
"BoundingBox": {
"Height": 0.1329464465379715,
"Left": 0.5611110925674438,
"Top": 0.6832437515258789,
"Width": 0.08777777850627899
},
"Confidence": 92.37225341796875,
"Landmarks": [
{
"Type": "eyeLeft",
"X": 0.5796897411346436,
"Y": 0.7452847957611084
},
{
"Type": "eyeRight",
"X": 0.6078574657440186,
"Y": 0.742687463760376
},
{
"Type": "nose",
"X": 0.597953200340271,
"Y": 0.7620673179626465
},
{
"Type": "mouthLeft",
"X": 0.5884202122688293,
"Y": 0.7920381426811218
},
{
"Type": "mouthRight",
"X": 0.60627681016922,
"Y": 0.7919750809669495
}
],
"Pose": {
"Pitch": 15.658954620361328,
"Roll": -4.583454608917236,
"Yaw": 10.558992385864258
},
"Quality": {
"Brightness": 42.54612350463867,
"Sharpness": 86.93206024169922
}
},
"Reasons": [
"EXCEEDS_MAX_FACES"
]
}
]
}
```
Untuk mendapatkan semua informasi wajah, tentukan 'ALL' untuk parameter permintaan `DetectionAttributes`. Sebagai contoh, dalam respons contoh berikut, perhatikan informasi tambahan dalam elemen `faceDetail`, yang tidak tersimpan pada server:
+ 25 penanda wajah (dibandingkan dengan hanya lima pada contoh sebelumnya)
+ Sepuluh atribut wajah (kacamata, jenggot, oklusi, arah tatapan mata, dan sebagainya)
+ Emosi (lihat elemen `emotion`)
Elemen `face` menyediakan metadata yang tersimpan di server.
`FaceModelVersion` adalah versi model wajah yang terkait dengan koleksi. Untuk informasi selengkapnya, lihat [Memahami versi model](face-detection-model.md).
`OrientationCorrection` adalah perkiraan orientasi citra. Informasi koreksi orientasi tidak dikembalikan jika Anda menggunakan versi model deteksi wajah yang lebih tinggi dari versi 3. Untuk informasi selengkapnya, lihat [Mendapatkan orientasi citra dan koordinat kotak pembatas](images-orientation.md).
Respons sampel berikut menunjukkan JSON yang dikembalikan saat menentukan ["SEMUA"]:
```
{
"FaceModelVersion": "3.0",
"FaceRecords": [
{
"Face": {
"BoundingBox": {
"Height": 0.06333333253860474,
"Left": 0.17185185849666595,
"Top": 0.7366666793823242,
"Width": 0.11061728745698929
},
"Confidence": 99.99999237060547,
"ExternalImageId": "input.jpg",
"FaceId": "578e2e1b-d0b0-493c-aa39-ba476a421a34",
"ImageId": "9ba38e68-35b6-5509-9d2e-fcffa75d1653"
},
"FaceDetail": {
"AgeRange": {
"High": 25,
"Low": 15
},
"Beard": {
"Confidence": 99.98077392578125,
"Value": false
},
"BoundingBox": {
"Height": 0.06333333253860474,
"Left": 0.17185185849666595,
"Top": 0.7366666793823242,
"Width": 0.11061728745698929
},
"Confidence": 99.99999237060547,
"Emotions": [
{
"Confidence": 95.40877532958984,
"Type": "HAPPY"
},
{
"Confidence": 6.6088080406188965,
"Type": "CALM"
},
{
"Confidence": 0.7385611534118652,
"Type": "SAD"
}
],
"EyeDirection": {
"yaw": 16.299732,
"pitch": -6.407457,
"confidence": 99.968704
}
"Eyeglasses": {
"Confidence": 99.96795654296875,
"Value": false
},
"EyesOpen": {
"Confidence": 64.0671157836914,
"Value": true
},
"Gender": {
"Confidence": 100,
"Value": "Female"
},
"Landmarks": [
{
"Type": "eyeLeft",
"X": 0.21361233294010162,
"Y": 0.757106363773346
},
{
"Type": "eyeRight",
"X": 0.2518567442893982,
"Y": 0.7599404454231262
},
{
"Type": "nose",
"X": 0.2262365221977234,
"Y": 0.7711842060089111
},
{
"Type": "mouthLeft",
"X": 0.2050037682056427,
"Y": 0.7801263332366943
},
{
"Type": "mouthRight",
"X": 0.2430567592382431,
"Y": 0.7836716771125793
},
{
"Type": "leftPupil",
"X": 0.2161938101053238,
"Y": 0.756662905216217
},
{
"Type": "rightPupil",
"X": 0.2523181438446045,
"Y": 0.7603650689125061
},
{
"Type": "leftEyeBrowLeft",
"X": 0.20066319406032562,
"Y": 0.7501518130302429
},
{
"Type": "leftEyeBrowUp",
"X": 0.2130996286869049,
"Y": 0.7480520606040955
},
{
"Type": "leftEyeBrowRight",
"X": 0.22584207355976105,
"Y": 0.7504606246948242
},
{
"Type": "rightEyeBrowLeft",
"X": 0.24509544670581818,
"Y": 0.7526801824569702
},
{
"Type": "rightEyeBrowUp",
"X": 0.2582615911960602,
"Y": 0.7516844868659973
},
{
"Type": "rightEyeBrowRight",
"X": 0.26881539821624756,
"Y": 0.7554477453231812
},
{
"Type": "leftEyeLeft",
"X": 0.20624476671218872,
"Y": 0.7568746209144592
},
{
"Type": "leftEyeRight",
"X": 0.22105035185813904,
"Y": 0.7582521438598633
},
{
"Type": "leftEyeUp",
"X": 0.21401576697826385,
"Y": 0.7553104162216187
},
{
"Type": "leftEyeDown",
"X": 0.21317370235919952,
"Y": 0.7584449648857117
},
{
"Type": "rightEyeLeft",
"X": 0.24393919110298157,
"Y": 0.7600628137588501
},
{
"Type": "rightEyeRight",
"X": 0.2598416209220886,
"Y": 0.7605880498886108
},
{
"Type": "rightEyeUp",
"X": 0.2519053518772125,
"Y": 0.7582084536552429
},
{
"Type": "rightEyeDown",
"X": 0.25177454948425293,
"Y": 0.7612871527671814
},
{
"Type": "noseLeft",
"X": 0.2185886949300766,
"Y": 0.774715781211853
},
{
"Type": "noseRight",
"X": 0.23328955471515656,
"Y": 0.7759330868721008
},
{
"Type": "mouthUp",
"X": 0.22446128726005554,
"Y": 0.7805567383766174
},
{
"Type": "mouthDown",
"X": 0.22087252140045166,
"Y": 0.7891407608985901
}
],
"MouthOpen": {
"Confidence": 95.87068939208984,
"Value": false
},
"Mustache": {
"Confidence": 99.9828109741211,
"Value": false
},
"Pose": {
"Pitch": -0.9409101605415344,
"Roll": 7.233824253082275,
"Yaw": -2.3602254390716553
},
"Quality": {
"Brightness": 32.01998519897461,
"Sharpness": 93.67259216308594
},
"Smile": {
"Confidence": 86.7142105102539,
"Value": true
},
"Sunglasses": {
"Confidence": 97.38925170898438,
"Value": false
}
}
}
],
"OrientationCorrection": "ROTATE_0"
"UnindexedFaces": []
}
```