Face Detection Operations - Detect

Referensi

Layanan:: Azure AI Services

Versi API:: v1.2-preview.1

Deteksi wajah manusia dalam gambar, kembalikan persegi panjang wajah, dan secara opsional dengan faceIds, landmark, dan atribut.

Penting

Microsoft telah menghentikan atau membatasi kemampuan pengenalan wajah yang dapat digunakan untuk mencoba menyimpulkan status emosional dan atribut identitas yang, jika disalahgunakan, dapat membuat orang tunduk pada stereotip, diskriminasi, atau penolakan layanan yang tidak wajar. Kemampuan yang dihentikan adalah emosi dan jenis kelamin. Kemampuan yang terbatas adalah usia, senyum, rambut wajah, rambut, dan makeup. Email Azure Face API jika Anda memiliki kasus penggunaan yang bertanggung jawab yang akan mendapat manfaat dari penggunaan salah satu kemampuan terbatas. Baca selengkapnya tentang keputusan ini di sini.

- Tidak ada gambar yang akan disimpan. Hanya fitur wajah yang diekstrak yang akan disimpan di server. faceId adalah pengidentifikasi fitur wajah dan akan digunakan dalam "Identifikasi", "Verifikasi", dan "Temukan Serupa". Fitur wajah yang disimpan akan kedaluwarsa dan dihapus pada waktu yang ditentukan oleh faceIdTimeToLive setelah panggilan deteksi asli.
- Parameter opsional termasuk faceId, landmark, dan atribut. Atribut termasuk headPose, kacamata, oklusi, aksesori, kabur, paparan, kebisingan, masker, dan qualityForRecognition. Beberapa hasil yang dikembalikan untuk atribut tertentu mungkin tidak sangat akurat.
- Format JPEG, PNG, GIF (bingkai pertama), dan BMP didukung. Ukuran file gambar yang diizinkan adalah dari 1KB hingga 6MB.
- Ukuran wajah minimum yang dapat dideteksi adalah 36x36 piksel dalam gambar yang tidak lebih besar dari 1920x1080 piksel. Gambar dengan dimensi yang lebih tinggi dari 1920x1080 piksel akan membutuhkan ukuran wajah minimum yang lebih besar secara proporsional.
- Hingga 100 wajah dapat dikembalikan untuk gambar. Wajah diberi peringkat berdasarkan ukuran persegi panjang wajah dari besar ke kecil.
- Untuk hasil optimal saat mengkueri "Identifikasi", "Verifikasi", dan "Temukan Serupa" ('returnFaceId' adalah true), silakan gunakan wajah yang: frontal, clear, dan dengan ukuran minimum 200x200 piksel (100 piksel antar mata).
- Nilai 'detectionModel' yang berbeda dapat disediakan. Ketersediaan landmark dan atribut yang didukung tergantung pada model deteksi yang ditentukan. Untuk menggunakan dan membandingkan model deteksi yang berbeda, silakan lihat di sini.
- Nilai 'recognitionModel' yang berbeda disediakan. Jika operasi tindak lanjut seperti "Verifikasi", "Identifikasi", "Temukan Serupa" diperlukan, tentukan model pengenalan dengan parameter 'recognitionModel'. Nilai default untuk 'recognitionModel' adalah 'recognition_01', jika model terbaru diperlukan, tentukan model yang Anda butuhkan secara eksplisit dalam parameter ini. Setelah ditentukan, faceId yang terdeteksi akan dikaitkan dengan model pengenalan yang ditentukan. Detail selengkapnya, silakan lihat di sini.

POST {endpoint}/face/{apiVersion}/detect

Dengan parameter opsional:

POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
apiVersion	path	True	string	Versi API
endpoint	path	True	string (uri)	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	'detectionModel' yang terkait dengan faceIds yang terdeteksi. Nilai 'detectionModel' yang didukung termasuk 'detection_01', 'detection_02' dan 'detection_03'. Nilai defaultnya adalah 'detection_01'. 'detection_03' direkomendasikan karena akurasinya ditingkatkan pada wajah yang lebih kecil (64x64 piksel) dan orientasi wajah yang diputar.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	Jumlah detik untuk ID wajah yang di-cache. Rentang yang didukung dari 60 detik hingga 86400 detik. Nilai defaultnya adalah 86400 (24 jam).
recognitionModel	query		RecognitionModel	'recognitionModel' yang terkait dengan faceIds yang terdeteksi. Nilai 'recognitionModel' yang didukung termasuk 'recognition_01', 'recognition_02', 'recognition_03' atau 'recognition_04'. Nilai defaultnya adalah 'recognition_01'. 'recognition_04' direkomendasikan karena akurasinya ditingkatkan pada wajah yang mengenakan masker dibandingkan dengan 'recognition_03', dan akurasi keseluruhannya ditingkatkan dibandingkan dengan 'recognition_01' dan 'recognition_02'.
returnFaceAttributes	query		FaceAttributeType[]	Analisis dan kembalikan satu atau beberapa atribut wajah yang ditentukan dalam string yang dipisahkan koma seperti 'returnFaceAttributes=headPose,glasses'. Analisis atribut wajah memiliki biaya komputasi dan waktu tambahan.
returnFaceId	query		boolean	Mengembalikan faceId dari wajah yang terdeteksi atau tidak. Nilai defaultnya adalah true.
returnFaceLandmarks	query		boolean	Mengembalikan landmark wajah dari wajah yang terdeteksi atau tidak. Nilai defaultnya adalah false.
returnRecognitionModel	query		boolean	Mengembalikan 'recognitionModel' atau tidak. Nilai defaultnya adalah false. Ini hanya berlaku ketika returnFaceId = true.

Isi Permintaan

Media Types: "application/octet-stream"

Nama	Jenis	Deskripsi
imageContent	string (binary)	Biner gambar input.

Respons

Nama	Jenis	Deskripsi
200 OK	FaceDetectionResult[]	Panggilan yang berhasil mengembalikan array entri wajah yang diberi peringkat berdasarkan ukuran persegi panjang wajah dalam urutan menuram. Respons kosong menunjukkan tidak ada wajah yang terdeteksi.
Other Status Codes	FaceErrorResponse	Respons kesalahan tak terduga. Header x-ms-error-code: string

Nama

Jenis

Deskripsi

200 OK

FaceDetectionResult[]

Panggilan yang berhasil mengembalikan array entri wajah yang diberi peringkat berdasarkan ukuran persegi panjang wajah dalam urutan menuram. Respons kosong menunjukkan tidak ada wajah yang terdeteksi.

Other Status Codes

FaceErrorResponse

Respons kesalahan tak terduga.

Header

x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Kunci rahasia untuk langganan Azure AI Face Anda.

Jenis: apiKey
Dalam: header

AADToken

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: accessCode
URL Otorisasi: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Cakupan

Nama	Deskripsi
https://cognitiveservices.azure.com/.default

Contoh

Detect with Image

Permintaan sampel

HTTP

POST {endpoint}/face/v1.2-preview.1/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Respon sampel

Kode status:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_03",
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 412.7,
        "y": 78.4
      },
      "pupilRight": {
        "x": 446.8,
        "y": 74.2
      },
      "noseTip": {
        "x": 437.7,
        "y": 92.4
      },
      "mouthLeft": {
        "x": 417.8,
        "y": 114.4
      },
      "mouthRight": {
        "x": 451.3,
        "y": 109.3
      },
      "eyebrowLeftOuter": {
        "x": 397.9,
        "y": 78.5
      },
      "eyebrowLeftInner": {
        "x": 425.4,
        "y": 70.5
      },
      "eyeLeftOuter": {
        "x": 406.7,
        "y": 80.6
      },
      "eyeLeftTop": {
        "x": 412.2,
        "y": 76.2
      },
      "eyeLeftBottom": {
        "x": 413,
        "y": 80.1
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7
      },
      "eyeRightBottom": {
        "x": 447,
        "y": 75.3
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4
      },
      "noseRootLeft": {
        "x": 428,
        "y": 77.1
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87
      },
      "noseLeftAlarOutTip": {
        "x": 424.3,
        "y": 96.4
      },
      "noseRightAlarOutTip": {
        "x": 446.6,
        "y": 92.5
      },
      "upperLipTop": {
        "x": 437.6,
        "y": 105.9
      },
      "upperLipBottom": {
        "x": 437.6,
        "y": 108.2
      },
      "underLipTop": {
        "x": 436.8,
        "y": 111.4
      },
      "underLipBottom": {
        "x": 437.3,
        "y": 114.5
      }
    },
    "faceAttributes": {
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "headwear",
          "confidence": 0.99
        },
        {
          "type": "glasses",
          "confidence": 1
        },
        {
          "type": "mask",
          "confidence": 0.87
        }
      ],
      "blur": {
        "blurLevel": "medium",
        "value": 0.51
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.55
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.12
      },
      "qualityForRecognition": "high"
    }
  }
]

Definisi

Nama	Deskripsi
AccessoryItem	Item aksesori dan tingkat keyakinan yang sesuai.
AccessoryType	Jenis aksesori.
BlurLevel	Menunjukkan tingkat kekaburan.
BlurProperties	Properti yang menjelaskan keberadaan kabur dalam gambar.
DetectionModel	'detectionModel' yang terkait dengan faceIds yang terdeteksi. Nilai 'detectionModel' yang didukung termasuk 'detection_01', 'detection_02' dan 'detection_03'. Nilai defaultnya adalah 'detection_01'. 'detection_03' direkomendasikan karena akurasinya ditingkatkan pada wajah yang lebih kecil (64x64 piksel) dan orientasi wajah yang diputar.
ExposureLevel	Menunjukkan tingkat paparan.
ExposureProperties	Properti yang menjelaskan tingkat paparan gambar.
FaceAttributes	Atribut wajah untuk wajah yang terdeteksi.
FaceAttributeType	Analisis dan kembalikan satu atau beberapa atribut wajah yang ditentukan dalam string yang dipisahkan koma seperti 'returnFaceAttributes=headPose,glasses'. Analisis atribut wajah memiliki biaya komputasi dan waktu tambahan.
FaceDetectionResult	Respons untuk api deteksi.
FaceError	Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respons yang berisi detail kesalahan.
FaceLandmarks	Kumpulan tengara wajah 27 titik yang menunjuk ke posisi penting komponen wajah.
FaceRectangle	Persegi panjang di mana wajah dapat ditemukan.
FacialHair	Properti yang menjelaskan atribut rambut wajah.
GlassesType	Kacamata jenis wajah.
HairColor	Array warna kandidat dan tingkat keyakinan di hadapan masing-masing.
HairColorType	Nama warna rambut.
HairProperties	Properti yang menjelaskan atribut rambut.
HeadPose	Sudut roll/yaw/pitch 3-D untuk arah wajah.
LandmarkCoordinate	Koordinat landmark dalam gambar.
MaskProperties	Properti yang menjelaskan keberadaan masker pada wajah tertentu.
MaskType	Jenis masker.
NoiseLevel	Menunjukkan tingkat kebisingan.
NoiseProperties	Properti yang menjelaskan tingkat kebisingan gambar.
OcclusionProperties	Properti yang menjelaskan oklusi pada wajah tertentu.
QualityForRecognition	Menunjukkan kualitas gambar untuk pengenalan.
RecognitionModel	Model pengenalan untuk wajah.

AccessoryItem

Objek

Item aksesori dan tingkat keyakinan yang sesuai.

Nama	Jenis	Deskripsi
confidence	number (float) minimum: 0 maximum: 1	Tingkat keyakinan jenis aksesori. Rentang antara [0,1].
type	AccessoryType	Jenis aksesori.

AccessoryType

Enumeration

Jenis aksesori.

Nilai	Deskripsi
glasses	Kacamata.
headwear	Kepala memakai.
mask	Masker.

BlurLevel

Enumeration

Menunjukkan tingkat kekaburan.

Nilai	Deskripsi
high	Tingkat kabur tinggi.
low	Tingkat kabur rendah.
medium	Tingkat kabur sedang.

BlurProperties

Objek

Properti yang menjelaskan keberadaan kabur dalam gambar.

Nama	Jenis	Deskripsi
blurLevel	BlurLevel	Nilai enum yang menunjukkan tingkat kekaburan.
value	number (float) minimum: 0 maximum: 1	Angka yang menunjukkan tingkat kekaburan mulai dari 0 hingga 1.

DetectionModel

Enumeration

'detectionModel' yang terkait dengan faceIds yang terdeteksi. Nilai 'detectionModel' yang didukung termasuk 'detection_01', 'detection_02' dan 'detection_03'. Nilai defaultnya adalah 'detection_01'. 'detection_03' direkomendasikan karena akurasinya ditingkatkan pada wajah yang lebih kecil (64x64 piksel) dan orientasi wajah yang diputar.

Nilai	Deskripsi
detection_01	Model deteksi default. Merekomendasikan untuk deteksi wajah frontal dekat. Untuk skenario dengan wajah sudut (pose kepala) yang sangat besar, wajah terkumpul atau orientasi gambar yang salah, wajah dalam kasus seperti itu mungkin tidak terdeteksi.
detection_02	Model deteksi dirilis pada tahun 2019 Mei dengan akurasi yang ditingkatkan terutama pada wajah kecil, samping dan buram.
detection_03	Model deteksi dirilis pada bulan Februari 2021 dengan akurasi yang ditingkatkan terutama pada wajah kecil.

ExposureLevel

Enumeration

Menunjukkan tingkat paparan.

Nilai	Deskripsi
goodExposure	Tingkat paparan yang baik.
overExposure	Tingkat paparan tinggi.
underExposure	Tingkat paparan rendah.

ExposureProperties

Objek

Properti yang menjelaskan tingkat paparan gambar.

Nama	Jenis	Deskripsi
exposureLevel	ExposureLevel	Nilai enum yang menunjukkan tingkat paparan.
value	number (float) minimum: 0 maximum: 1	Angka yang menunjukkan tingkat paparan mulai dari 0 hingga 1. [0, 0,25) berada di bawah paparan. [0.25, 0.75) adalah paparan yang baik. [0.75, 1] melebihi eksposur.

FaceAttributes

Objek

Atribut wajah untuk wajah yang terdeteksi.

Nama	Jenis	Deskripsi
accessories	AccessoryItem[]	Properti yang menjelaskan aksesori apa pun pada wajah tertentu.
age	number (float)	Usia bertahun-tahun.
blur	BlurProperties	Properti yang menjelaskan keberadaan kabur dalam gambar.
exposure	ExposureProperties	Properti yang menjelaskan tingkat paparan gambar.
facialHair	FacialHair	Properti yang menjelaskan atribut rambut wajah.
glasses	GlassesType	Jenis kacamata jika salah satu wajah.
hair	HairProperties	Properti yang menjelaskan atribut rambut.
headPose	HeadPose	Sudut roll/yaw/pitch 3-D untuk arah wajah.
mask	MaskProperties	Properti yang menjelaskan keberadaan masker pada wajah tertentu.
noise	NoiseProperties	Properti yang menjelaskan tingkat kebisingan gambar.
occlusion	OcclusionProperties	Properti yang menjelaskan oklusi pada wajah tertentu.
qualityForRecognition	QualityForRecognition	Properti yang menjelaskan kualitas gambar keseluruhan mengenai apakah gambar yang digunakan dalam deteksi memiliki kualitas yang memadai untuk mencoba pengenalan wajah.
smile	number (float) minimum: 0 maximum: 1	Intensitas senyum, angka antara [0,1].

FaceAttributeType

Enumeration

Analisis dan kembalikan satu atau beberapa atribut wajah yang ditentukan dalam string yang dipisahkan koma seperti 'returnFaceAttributes=headPose,glasses'. Analisis atribut wajah memiliki biaya komputasi dan waktu tambahan.

Nilai	Deskripsi
accessories	Aksesoris di sekitar wajah, termasuk 'headwear', 'kacamata' dan 'masker'. Array kosong berarti tidak ada aksesori yang terdeteksi. Perhatikan ini setelah wajah terdeteksi. Masker besar tidak dapat mengakibatkan wajah terdeteksi.
age	Usia bertahun-tahun.
blur	Wajah kabur atau tidak. Level mengembalikan 'Rendah', 'Sedang' atau 'Tinggi'. Nilai mengembalikan angka antara [0,1], semakin besar buram.
exposure	Tingkat paparan wajah. Level mengembalikan 'GoodExposure', 'OverExposure' atau 'UnderExposure'.
facialHair	Properti yang menjelaskan atribut rambut wajah.
glasses	Jenis kacamata. Nilai termasuk 'NoGlasses', 'ReadingGlasses', 'Sunglasses', 'SwimmingGoggles'.
hair	Properti yang menjelaskan atribut rambut.
headPose	Sudut roll/yaw/pitch 3-D untuk arah wajah.
mask	Apakah setiap wajah mengenakan masker. Jenis masker mengembalikan 'noMask', 'faceMask', 'otherMaskOrOcclusion', atau 'uncertain'. Nilai mengembalikan boolean 'noseAndMouthCovered' yang menunjukkan apakah hidung dan mulut tertutup.
noise	Tingkat kebisingan piksel wajah. Level mengembalikan 'Rendah', 'Sedang' dan 'Tinggi'. Nilai mengembalikan angka antara [0,1], semakin besar noisier
occlusion	Apakah setiap area wajah dihilangkan, termasuk dahi, mata, dan mulut.
qualityForRecognition	Kualitas gambar keseluruhan mengenai apakah gambar yang digunakan dalam deteksi memiliki kualitas yang memadai untuk mencoba pengenalan wajah. Nilainya adalah peringkat informal rendah, sedang, atau tinggi. Hanya gambar berkualitas 'tinggi' yang direkomendasikan untuk pendaftaran orang dan kualitas pada atau di atas 'sedang' yang direkomendasikan untuk skenario identifikasi. Atribut hanya tersedia saat menggunakan model pengenalan recognition_03 atau recognition_04.
smile	Intensitas senyum, angka antara [0,1].

FaceDetectionResult

Objek

Respons untuk api deteksi.

Nama	Jenis	Deskripsi
faceAttributes	FaceAttributes	Atribut wajah untuk wajah yang terdeteksi.
faceId	string (uuid)	FaceId unik dari wajah yang terdeteksi, dibuat oleh API deteksi dan akan kedaluwarsa 24 jam setelah panggilan deteksi. Untuk mengembalikan ini, parameter 'returnFaceId' memerlukan true.
faceLandmarks	FaceLandmarks	Array tengara wajah 27 titik yang menunjuk ke posisi penting komponen wajah. Untuk mengembalikan ini, diperlukan parameter 'returnFaceLandmarks' menjadi true.
faceRectangle	FaceRectangle	Area persegi panjang untuk lokasi wajah pada gambar.
recognitionModel	RecognitionModel	'recognitionModel' yang terkait dengan faceId ini. Ini hanya dikembalikan ketika 'returnRecognitionModel' secara eksplisit diatur sebagai true.

FaceError

Objek

Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
message	string	Representasi kesalahan yang dapat dibaca manusia.

FaceErrorResponse

Objek

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	FaceError	Objek kesalahan.

FaceLandmarks

Objek

Kumpulan tengara wajah 27 titik yang menunjuk ke posisi penting komponen wajah.

Nama	Jenis	Deskripsi
eyeLeftBottom	LandmarkCoordinate	Koordinat bagian bawah mata kiri.
eyeLeftInner	LandmarkCoordinate	Koordinat bagian dalam mata kiri.
eyeLeftOuter	LandmarkCoordinate	Koordinat bagian luar mata kiri.
eyeLeftTop	LandmarkCoordinate	Koordinat bagian atas mata kiri.
eyeRightBottom	LandmarkCoordinate	Koordinat bagian bawah mata kanan.
eyeRightInner	LandmarkCoordinate	Koordinat bagian dalam mata kanan.
eyeRightOuter	LandmarkCoordinate	Koordinat mata kanan luar.
eyeRightTop	LandmarkCoordinate	Koordinat bagian atas mata kanan.
eyebrowLeftInner	LandmarkCoordinate	Koordinat bagian dalam alis kiri.
eyebrowLeftOuter	LandmarkCoordinate	Koordinat bagian luar alis kiri.
eyebrowRightInner	LandmarkCoordinate	Koordinat bagian dalam alis kanan.
eyebrowRightOuter	LandmarkCoordinate	Koordinat bagian luar alis kanan.
mouthLeft	LandmarkCoordinate	Koordinat mulut kiri.
mouthRight	LandmarkCoordinate	Koordinat mulut ke kanan.
noseLeftAlarOutTip	LandmarkCoordinate	Koordinat hidung meninggalkan ujung alar keluar.
noseLeftAlarTop	LandmarkCoordinate	Koordinat hidung kiri atas alar.
noseRightAlarOutTip	LandmarkCoordinate	Koordinat hidung kanan alar ujung keluar.
noseRightAlarTop	LandmarkCoordinate	Koordinat hidung kanan alar atas.
noseRootLeft	LandmarkCoordinate	Koordinat akar hidung kiri.
noseRootRight	LandmarkCoordinate	Koordinat akar hidung kanan.
noseTip	LandmarkCoordinate	Koordinat ujung hidung.
pupilLeft	LandmarkCoordinate	Koordinat murid mata kiri.
pupilRight	LandmarkCoordinate	Koordinat pupil mata kanan.
underLipBottom	LandmarkCoordinate	Koordinat bagian bawah bibir bawah.
underLipTop	LandmarkCoordinate	Koordinat bagian bawah bibir atas.
upperLipBottom	LandmarkCoordinate	Koordinat bagian bawah bibir atas.
upperLipTop	LandmarkCoordinate	Koordinat bagian atas bibir atas.

FaceRectangle

Objek

Persegi panjang di mana wajah dapat ditemukan.

Nama	Jenis	Deskripsi
height	integer (int32)	Tinggi persegi panjang, dalam piksel.
left	integer (int32)	Jarak dari tepi kiri jika gambar ke tepi kiri persegi panjang, dalam piksel.
top	integer (int32)	Jarak dari tepi atas jika gambar ke tepi atas persegi panjang, dalam piksel.
width	integer (int32)	Lebar persegi panjang, dalam piksel.

FacialHair

Objek

Properti yang menjelaskan atribut rambut wajah.

Nama	Jenis	Deskripsi
beard	number (float) minimum: 0 maximum: 1	Angka mulai dari 0 hingga 1 menunjukkan tingkat keyakinan yang terkait dengan properti.
moustache	number (float) minimum: 0 maximum: 1	Angka mulai dari 0 hingga 1 menunjukkan tingkat keyakinan yang terkait dengan properti.
sideburns	number (float) minimum: 0 maximum: 1	Angka mulai dari 0 hingga 1 menunjukkan tingkat keyakinan yang terkait dengan properti.

GlassesType

Enumeration

Kacamata jenis wajah.

Nilai	Deskripsi
noGlasses	Tidak ada kacamata di wajah.
readingGlasses	Kacamata normal di wajah.
sunglasses	Kacamata di wajah.
swimmingGoggles	Kacamata renang di wajah.

HairColor

Objek

Array warna kandidat dan tingkat keyakinan di hadapan masing-masing.

Nama	Jenis	Deskripsi
color	HairColorType	Nama warna rambut.
confidence	number (float) minimum: 0 maximum: 1	Tingkat keyakinan warna. Rentang antara [0,1].

HairColorType

Enumeration

Nama warna rambut.

Nilai	Deskripsi
black	Hitam.
blond	Pirang.
brown	Coklat.
gray	Abu-abu.
other	Lain.
red	Merah.
unknown	Diketahui.
white	Putih.

HairProperties

Objek

Properti yang menjelaskan atribut rambut.

Nama	Jenis	Deskripsi
bald	number (float) minimum: 0 maximum: 1	Angka yang menjelaskan tingkat keyakinan apakah orang tersebut botak.
hairColor	HairColor[]	Array warna kandidat dan tingkat keyakinan di hadapan masing-masing.
invisible	boolean	Nilai boolean yang menjelaskan apakah rambut terlihat dalam gambar.

HeadPose

Objek

Sudut roll/yaw/pitch 3-D untuk arah wajah.

Nama	Jenis	Deskripsi
pitch	number (float)	Nilai sudut.
roll	number (float)	Nilai sudut.
yaw	number (float)	Nilai sudut.

LandmarkCoordinate

Objek

Koordinat landmark dalam gambar.

Nama	Jenis	Deskripsi
x	number (float)	Komponen horizontal, dalam piksel.
y	number (float)	Komponen vertikal, dalam piksel.

MaskProperties

Objek

Properti yang menjelaskan keberadaan masker pada wajah tertentu.

Nama	Jenis	Deskripsi
noseAndMouthCovered	boolean	Nilai boolean yang menunjukkan apakah hidung dan mulut tertutup.
type	MaskType	Jenis masker.

MaskType

Enumeration

Jenis masker.

Nilai	Deskripsi
faceMask	Masker wajah.
noMask	Tanpa masker.
otherMaskOrOcclusion	Jenis masker atau oklusi lainnya.
uncertain	Tidak menentu.

NoiseLevel

Enumeration

Menunjukkan tingkat kebisingan.

Nilai	Deskripsi
high	Tingkat kebisingan tinggi.
low	Tingkat kebisingan rendah.
medium	Tingkat kebisingan sedang.

NoiseProperties

Objek

Properti yang menjelaskan tingkat kebisingan gambar.

Nama	Jenis	Deskripsi
noiseLevel	NoiseLevel	Nilai enum yang menunjukkan tingkat kebisingan.
value	number (float) minimum: 0 maximum: 1	Angka yang menunjukkan tingkat kebisingan mulai dari 0 hingga 1. [0, 0,25) berada di bawah paparan. [0.25, 0.75) adalah paparan yang baik. [0.75, 1] melebihi eksposur. [0, 0,3) adalah tingkat kebisingan rendah. [0.3, 0.7) adalah tingkat kebisingan sedang. [0.7, 1] adalah tingkat kebisingan tinggi.

OcclusionProperties

Objek

Properti yang menjelaskan oklusi pada wajah tertentu.

Nama	Jenis	Deskripsi
eyeOccluded	boolean	Nilai boolean yang menunjukkan apakah mata terpaku.
foreheadOccluded	boolean	Nilai boolean yang menunjukkan apakah dahi dihilangkan.
mouthOccluded	boolean	Nilai boolean yang menunjukkan apakah mulut dihilangkan.

QualityForRecognition

Enumeration

Menunjukkan kualitas gambar untuk pengenalan.

Nilai	Deskripsi
high	Kualitas tinggi.
low	Kualitas rendah.
medium	Kualitas sedang.

RecognitionModel

Enumeration

Model pengenalan untuk wajah.

Nilai	Deskripsi
recognition_01	Model pengenalan default untuk "Deteksi". Semua faceId yang dibuat sebelum 2019 Maret diikat dengan model pengenalan ini.
recognition_02	Model pengenalan dirilis pada bulan Maret 2019.
recognition_03	Model pengenalan dirilis pada bulan Mei 2020.
recognition_04	Model pengenalan dirilis pada februari 2021. Disarankan untuk menggunakan model pengenalan ini untuk akurasi pengenalan yang lebih baik.

Bagikan melalui

Face Detection Operations - Detect

Parameter URI

Isi Permintaan

Respons

Keamanan

Ocp-Apim-Subscription-Key

AADToken

Cakupan

Contoh

Detect with Image

Permintaan sampel

Respon sampel

Definisi

AccessoryItem

AccessoryType

BlurLevel

BlurProperties

DetectionModel

ExposureLevel

ExposureProperties

FaceAttributes

FaceAttributeType

FaceDetectionResult

FaceError

FaceErrorResponse

FaceLandmarks

FaceRectangle

FacialHair

GlassesType

HairColor

HairColorType

HairProperties

HeadPose

LandmarkCoordinate

MaskProperties

MaskType

NoiseLevel

NoiseProperties

OcclusionProperties

QualityForRecognition

RecognitionModel

Sumber Daya Tambahan: