Detecção facial
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com a API de detecção facial do Kit de ML, é possível detectar rostos em uma imagem, identificar
os principais traços faciais e o contorno dos rostos detectados. A API
detecta rostos, mas não reconhece pessoas .
Com a detecção facial, você recebe as informações necessárias para executar tarefas como
embelecer selfies e retratos ou gerar avatares usando a foto de um usuário.
Como o Kit de ML pode realizar detecção facial em tempo real, é possível usá-lo em aplicativos como chat por vídeo ou jogos que respondem às expressões do jogador.
iOS
Android
Principais recursos
- Reconhecer e localizar características faciais
Receba as coordenadas de olhos, orelhas, bochechas, nariz e boca de todos
os rostos detectados.
- Conhecer os contornos das características faciais
Veja os contornos dos rostos detectados e dos olhos, sobrancelhas, lábios e nariz.
- Reconhecer expressões faciais
Determine se uma pessoa está sorrindo ou se está com os olhos fechados.
- Rastrear rostos em frames de vídeo
Receba um identificador para cada rosto detectado exclusivo.
O identificador é consistente em todas as invocações para que você possa
manipular imagens em uma pessoa específica em um stream de vídeo.
- Processar frames de vídeo em tempo real
A detecção facial é realizada no dispositivo e é rápida o suficiente para ser usada
em aplicativos em tempo real, como manipulação de vídeo.
Resultados de exemplo
Exemplo 1
Para cada rosto detectado:
| Rosto 1 de 3 |
|---|
| Polígono delimitador |
(884.880004882812, 149.546676635742),
(1030.77197265625, 149.546676635742),
(1030.77197265625, 3272.284
|
| Ângulos de rotação |
Y: -14,054030418395996, Z: -55,007488250732422 |
| ID de acompanhamento |
2 |
| Pontos de referência faciais |
| Olho esquerdo |
(945,869323730469, 211.867126464844) |
| Olho direito |
(971.579467773438, 247.257247924805) |
| Parte inferior da boca |
(907.756591796875, 259.714477539062) |
... etc.
|
| Probabilidades de atributos |
| Sorrindo |
0,88979166746139526 |
| Olho esquerdo aberto |
0,98635888937860727 |
| Olho direito aberto |
0,99258323386311531 |
|
Exemplo 2 (detecção de contorno facial)
Quando a detecção de contorno facial está ativada, você recebe uma lista de pontos
para cada característica facial detectada. Esses pontos representam a forma do recurso. A imagem a seguir ilustra como esses pontos mapeiam um rosto.
Clique na imagem para ampliar:
| Contornos de características faciais |
|---|
| Ponte do nariz |
(505.149811, 221.201797), (506.987122, 313.285919)
|
| Olho esquerdo |
(404.642029, 232.854431), 404.642029, 232.854431, 408.527283.
|
| Parte superior do lábio superior |
(421.662048, 354.520813), (430.103882, 349.694061), (440.847595, 348.048737), (456.549988, 346.295532), 73.6.4.9.4.9.4.9.4.9.4.9.4
|
| (etc.) |
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eML Kit's Face Detection API can detect faces and their features in images and videos, but it does not recognize individuals.\u003c/p\u003e\n"],["\u003cp\u003eIt can be used for tasks such as adding effects to photos, creating avatars, and building interactive applications that respond to facial expressions.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides facial feature coordinates, contours, expression detection (like smiling), and face tracking across video frames.\u003c/p\u003e\n"],["\u003cp\u003eFace detection happens on the device and is fast enough for real-time applications.\u003c/p\u003e\n"]]],[],null,["With ML Kit's face detection API, you can detect faces in an image, identify\nkey facial features, and get the contours of detected faces. Note that the API\n*detects faces* , it does not *recognize people* .\n\nWith face detection, you can get the information you need to perform tasks like\nembellishing selfies and portraits, or generating avatars from a user's photo.\nBecause ML Kit can perform face detection in real time, you can use it in\napplications like video chat or games that respond to the player's expressions.\n\n[iOS](/ml-kit/vision/face-detection/ios)\n[Android](/ml-kit/vision/face-detection/android)\n\nKey capabilities\n\n- **Recognize and locate facial features** Get the coordinates of the eyes, ears, cheeks, nose, and mouth of every face detected.\n- **Get the contours of facial features** Get the contours of detected faces and their eyes, eyebrows, lips, and nose.\n- **Recognize facial expressions** Determine whether a person is smiling or has their eyes closed.\n- **Track faces across video frames** Get an identifier for each unique detected face. The identifier is consistent across invocations, so you can perform image manipulation on a particular person in a video stream.\n- **Process video frames in real time** Face detection is performed on the device, and is fast enough to be used in real-time applications, such as video manipulation.\n\nExample results\n\nExample 1\n\nFor each face detected:\n\n| Face 1 of 3 ||\n|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Bounding polygon** | (884.880004882812, 149.546676635742), (1030.77197265625, 149.546676635742), (1030.77197265625, 329.660278320312), (884.880004882812, 329.660278320312) |\n| **Angles of rotation** | Y: -14.054030418395996, Z: -55.007488250732422 |\n| **Tracking ID** | 2 |\n| **Facial landmarks** | |---------------------|--------------------------------------| | **Left eye** | (945.869323730469, 211.867126464844) | | **Right eye** | (971.579467773438, 247.257247924805) | | **Bottom of mouth** | (907.756591796875, 259.714477539062) | ... etc. |\n| **Feature probabilities** | |--------------------|---------------------| | **Smiling** | 0.88979166746139526 | | **Left eye open** | 0.98635888937860727 | | **Right eye open** | 0.99258323386311531 | |\n\nExample 2 (face contour detection)\n\nWhen you have face contour detection enabled, you also get a list of points\nfor each facial feature that was detected. These points represent the shape of\nthe feature. The following image illustrates how these points map to a face.\nClick the image to enlarge it:\n\n[](/static/ml-kit/vision/face-detection/images/face_contours.svg)\n\n| Facial feature contours ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Nose bridge** | (505.149811, 221.201797), (506.987122, 313.285919) |\n| **Left eye** | (404.642029, 232.854431), (408.527283, 231.366623), (413.565796, 229.427856), (421.378296, 226.967682), (432.598755, 225.434143), (442.953064, 226.089508), (453.899811, 228.594818), (461.516418, 232.650467), (465.069580, 235.600845), (462.170410, 236.316147), (456.233643, 236.891602), (446.363922, 237.966888), (435.698914, 238.149323), (424.320740, 237.235168), (416.037720, 236.012115), (409.983459, 234.870300) |\n| **Top of upper lip** | (421.662048, 354.520813), (428.103882, 349.694061), (440.847595, 348.048737), (456.549988, 346.295532), (480.526489, 346.089294), (503.375702, 349.470459), (525.624634, 347.352783), (547.371155, 349.091980), (560.082031, 351.693268), (570.226685, 354.210175), (575.305420, 359.257751) |\n| (etc.) | |"]]
