Face Detection Operations - Detect

Referensi

Layanan:: Azure AI Services

Versi API:: v1.1-preview.1

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

Penting

Untuk mengurangi potensi penyalahgunaan yang dapat menyebabkan orang melakukan stereotip, diskriminasi, atau penolakan layanan yang tidak adil, kami menghentikan atribut Face API yang memprediksi emosi, jenis kelamin, usia, senyum, rambut wajah, rambut, dan makeup. Baca selengkapnya tentang keputusan https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/ini .

- 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. Face diberi peringkat berdasarkan ukuran persegi wajah dari besar hingga kecil.
- Untuk hasil optimal saat mengkueri "Identifikasi", "Verifikasi", dan "Temukan Serupa" ('returnFaceId' adalah benar), silakan gunakan wajah yang: frontal, clear, dan dengan ukuran minimum 200x200 piksel (100 piksel antar mata).
- Nilai 'detectionModel' yang berbeda dapat disediakan. Untuk menggunakan dan membandingkan model deteksi yang berbeda, silakan lihat https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - 'detection_02': Atribut wajah dan landmark dinonaktifkan jika Anda memilih model deteksi ini.
  - 'detection_03': Atribut wajah (mask, blur, dan headPose) dan landmark didukung jika Anda memilih model deteksi ini.
- 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 merujuk ke https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

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'.
faceIdTimeToLive	query		integer int32	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	Biner gambar input.

Respons

Nama	Jenis	Deskripsi
200 OK	FaceDetectionResult[]	Panggilan yang berhasil mengembalikan array entri wajah yang diberi peringkat berdasarkan ukuran persegi wajah dalam urutan menuram. Respons kosong menunjukkan tidak ada wajah yang terdeteksi.
Other Status Codes	FaceErrorResponse	Respons kesalahan yang tidak 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 wajah dalam urutan menuram. Respons kosong menunjukkan tidak ada wajah yang terdeteksi.

Other Status Codes

FaceErrorResponse

Respons kesalahan yang tidak 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
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Contoh

Detect with Image

Sample request

HTTP

POST {endpoint}/face/v1.1-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>"

Sample response

Status code:: 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'.
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 tertentu dalam string yang dipisahkan koma seperti 'returnFaceAttributes=headPose,glasses'. Analisis atribut wajah memiliki biaya komputasi dan waktu tambahan.
FaceDetectionResult	Respons untuk mendeteksi API.
FaceError	Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respons yang berisi detail kesalahan.
FaceLandmarks	Koleksi 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	Jenis kacamata 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

Item aksesori dan tingkat keyakinan yang sesuai.

Nama	Jenis	Deskripsi
confidence	number	Tingkat keyakinan jenis aksesori. Rentang antara [0,1].
type	AccessoryType	Jenis aksesori.

AccessoryType

Jenis aksesori.

Nama	Jenis	Deskripsi
glasses	string	Kacamata.
headwear	string	Kepala keausan.
mask	string	Masker.

BlurLevel

Menunjukkan tingkat kekaburan.

Nama	Jenis	Deskripsi
high	string	Tingkat kabur tinggi.
low	string	Tingkat kabur rendah.
medium	string	Tingkat kabur sedang.

BlurProperties

Properti yang menjelaskan keberadaan kabur dalam gambar.

Nama	Jenis	Deskripsi
blurLevel	BlurLevel	Nilai enum yang menunjukkan tingkat kekaburan.
value	number	Angka yang menunjukkan tingkat kekaburan mulai dari 0 hingga 1.

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'.

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

ExposureLevel

Menunjukkan tingkat paparan.

Nama	Jenis	Deskripsi
goodExposure	string	Tingkat paparan yang baik.
overExposure	string	Tingkat paparan tinggi.
underExposure	string	Tingkat pencahayaan rendah.

ExposureProperties

Properti yang menjelaskan tingkat paparan gambar.

Nama	Jenis	Deskripsi
exposureLevel	ExposureLevel	Nilai enum yang menunjukkan tingkat paparan.
value	number	Angka yang menunjukkan tingkat paparan berkisar antara 0 hingga 1. [0, 0,25) sedang terpapar. [0,25, 0,75) adalah paparan yang baik. [0.75, 1] kelebihan paparan.

FaceAttributes

Atribut wajah untuk wajah yang terdeteksi.

Nama	Jenis	Deskripsi
accessories	AccessoryItem[]	Properti yang menjelaskan aksesori apa pun pada wajah tertentu.
age	number	Usia dalam 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 ada 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	Intensitas senyum, angka antara [0,1].

FaceAttributeType

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

Nama	Jenis	Deskripsi
accessories	string	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 tidak ada wajah yang terdeteksi.
age	string	Usia dalam bertahun-tahun.
blur	string	Wajah kabur atau tidak. Level mengembalikan 'Rendah', 'Sedang' atau 'Tinggi'. Nilai mengembalikan angka antara [0,1], semakin besar pengaburnya.
exposure	string	Tingkat pencahayaan wajah. Level mengembalikan 'GoodExposure', 'OverExposure' atau 'UnderExposure'.
facialHair	string	Properti yang menjelaskan atribut rambut wajah.
glasses	string	Jenis kacamata. Nilai termasuk 'NoGlasses', 'ReadingGlasses', 'Kacamata Hitam', 'SwimmingGoggles'.
hair	string	Properti yang menjelaskan atribut rambut.
headPose	string	Sudut roll/yaw/pitch 3-D untuk arah wajah.
mask	string	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	string	Tingkat kebisingan piksel wajah. Level mengembalikan 'Rendah', 'Sedang' dan 'Tinggi'. Nilai mengembalikan angka antara [0,1], semakin besar noisier
occlusion	string	Apakah setiap area wajah terpaku, termasuk dahi, mata, dan mulut.
qualityForRecognition	string	Kualitas gambar keseluruhan mengenai apakah gambar yang digunakan dalam deteksi memiliki kualitas yang cukup untuk mencoba pengenalan wajah. Nilai 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	string	Intensitas senyum, angka antara [0,1].

FaceDetectionResult

Respons untuk mendeteksi API.

Nama	Jenis	Deskripsi
faceAttributes	FaceAttributes	Atribut wajah untuk wajah yang terdeteksi.
faceId	string	FaceId unik dari wajah yang terdeteksi, dibuat oleh API deteksi dan akan kedaluwarsa 24 jam setelah panggilan deteksi. Untuk mengembalikan ini, diperlukan parameter 'returnFaceId' menjadi 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 ditetapkan sebagai true.

FaceError

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

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

FaceErrorResponse

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	FaceError	Objek kesalahan.

FaceLandmarks

Koleksi 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 bagian luar mata kanan.
eyeRightTop	LandmarkCoordinate	Koordinat bagian atas mata kanan.
eyebrowLeftInner	LandmarkCoordinate	Koordinat bagian dalam alis kiri.
eyebrowLeftOuter	LandmarkCoordinate	Koordinat alis kiri luar.
eyebrowRightInner	LandmarkCoordinate	Koordinat bagian dalam alis kanan.
eyebrowRightOuter	LandmarkCoordinate	Koordinat alis kanan luar.
mouthLeft	LandmarkCoordinate	Koordinat mulut kiri.
mouthRight	LandmarkCoordinate	Koordinat mulut 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 atas alar.
noseRootLeft	LandmarkCoordinate	Koordinat akar hidung kiri.
noseRootRight	LandmarkCoordinate	Koordinat hak akar hidung.
noseTip	LandmarkCoordinate	Koordinat ujung hidung.
pupilLeft	LandmarkCoordinate	Koordinat murid mata kiri.
pupilRight	LandmarkCoordinate	Koordinat murid 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

Persegi panjang di mana wajah dapat ditemukan.

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

FacialHair

Properti yang menjelaskan atribut rambut wajah.

Nama	Jenis	Deskripsi
beard	number	Angka mulai dari 0 hingga 1 menunjukkan tingkat keyakinan yang terkait dengan properti.
moustache	number	Angka mulai dari 0 hingga 1 menunjukkan tingkat keyakinan yang terkait dengan properti.
sideburns	number	Angka mulai dari 0 hingga 1 menunjukkan tingkat keyakinan yang terkait dengan properti.

GlassesType

Jenis kacamata wajah.

Nama	Jenis	Deskripsi
noGlasses	string	Tidak ada kacamata di wajah.
readingGlasses	string	Kacamata normal di wajah.
sunglasses	string	Kacamata di wajah.
swimmingGoggles	string	Kacamata renang di wajah.

HairColor

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

Nama	Jenis	Deskripsi
color	HairColorType	Nama warna rambut.
confidence	number	Tingkat keyakinan warna. Rentang antara [0,1].

HairColorType

Nama warna rambut.

Nama	Jenis	Deskripsi
black	string	Hitam.
blond	string	Pirang.
brown	string	Brown.
gray	string	Abu.
other	string	Lainnya.
red	string	Merah.
unknown	string	Tidak dikenal.
white	string	Putih.

HairProperties

Properti yang menjelaskan atribut rambut.

Nama	Jenis	Deskripsi
bald	number	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

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

Nama	Jenis	Deskripsi
pitch	number	Nilai sudut.
roll	number	Nilai sudut.
yaw	number	Nilai sudut.

LandmarkCoordinate

Koordinat landmark dalam gambar.

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

MaskProperties

Properti yang menjelaskan keberadaan masker pada wajah tertentu.

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

MaskType

Jenis masker.

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

NoiseLevel

Menunjukkan tingkat kebisingan.

Nama	Jenis	Deskripsi
high	string	Tingkat kebisingan tinggi.
low	string	Tingkat kebisingan rendah.
medium	string	Tingkat kebisingan sedang.

NoiseProperties

Properti yang menjelaskan tingkat kebisingan gambar.

Nama	Jenis	Deskripsi
noiseLevel	NoiseLevel	Nilai enum yang menunjukkan tingkat kebisingan.
value	number	Angka yang menunjukkan tingkat kebisingan mulai dari 0 hingga 1. [0, 0,25) sedang terpapar. [0,25, 0,75) adalah paparan yang baik. [0.75, 1] kelebihan paparan. [0, 0,3) adalah tingkat kebisingan rendah. [0.3, 0.7) adalah tingkat kebisingan sedang. [0.7, 1] adalah tingkat kebisingan tinggi.

OcclusionProperties

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 terpaku.

QualityForRecognition

Menunjukkan kualitas gambar untuk pengenalan.

Nama	Jenis	Deskripsi
high	string	Kualitas tinggi.
low	string	Kualitas rendah.
medium	string	Kualitas sedang.

RecognitionModel

Model pengenalan untuk wajah.

Nama	Jenis	Deskripsi
recognition_01	string	Model pengenalan default untuk "Deteksi". Semua faceId yang dibuat sebelum 2019 Maret diikat dengan model pengenalan ini.
recognition_02	string	Model pengenalan dirilis pada bulan Maret 2019.
recognition_03	string	Model pengenalan dirilis pada bulan Mei 2020.
recognition_04	string	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

Scopes

Contoh

Detect with Image

Sample request

Sample response

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: