Nossa API de Detecção de Marcos Faciais oferece uma solução avançada para detectar e analisar marcos faciais com alta precisão. Esta API suporta a detecção de 72, 150 e 201 pontos chave, cobrindo características faciais essenciais, como olhos, sobrancelhas, lábios e contornos do nariz. Além disso, oferece localização precisa de características faciais, incluindo sobrancelhas, olhos, nariz, boca e bochechas, bem como identificação precisa dos contornos faciais para rostos únicos e múltiplos. A API também inclui estimativa do ângulo do rosto, permitindo a determinação de várias poses faciais na imagem. Ideal para desenvolvedores nas áreas de fotografia, realidade aumentada e segurança biométrica, esta API permite capacidades aprimoradas de reconhecimento facial e processamento de imagem. Integre nossa API de Detecção de Marcos Faciais em sua aplicação para fornecer aos usuários ferramentas robustas e precisas de análise facial, melhorando a precisão e funcionalidade de suas soluções de reconhecimento facial e edição de imagem.
Detecte e analise com precisão os pontos de referência facial com nossa API de Detecção de Pontos de Referência Faciais, suportando até 201 pontos chave para identificação precisa de características e contornos faciais
| Campo | Requerido | Tipo | Escopo | Padrões | Exemplo | Descrição |
|---|---|---|---|---|---|---|
image |
SIM | file |
||||
max_face_num |
NÃO | integer |
|
1 | O número máximo de rostos a serem processados. O valor padrão é 1 (apenas o rosto com a maior área na imagem é detectado) |
|
face_field |
NÃO | string |
|
idade,gênero,landmark4 |
Retorna mais informações sobre o rosto (por padrão, apenas face_token, quadro do rosto, probabilidade e ângulo de rotação são retornados).
|
Marcos Faciais - Recursos do endpoint
| Objeto | Descrição |
|---|---|
max_face_num |
Opcional The maximum number of faces to process. The default value is 1 (only the face with the largest area in the image is detected). `1` `2` `3` `4` `5` `6` `7` `8` `9` `10` |
face_field |
Opcional Returns more information about the face (by default only face_token, face frame, probability and rotation angle are returned). `age`: Age information. `gender`: Gender information. `landmark4`: 4 feature points. `landmark72`: 72 feature points. `landmark150`: 150 feature points. `landmark201`: 201 feature points. |
Corpo da requisição |
[Obrigatório] Arquivo binário |
{"error_code":0,"error_detail":{"status_code":200,"code":"","code_message":"","message":""},"log_id":"3029321544","request_id":"3029321544","result":{"face_num":1,"face_list":[{"face_token":"cc9e38750f16ed1669e80080bbe675cd","location":{"left":227.4,"top":297.37,"width":428,"height":390,"rotation":9},"face_probability":1,"angle":{"yaw":-5.4,"pitch":4.11,"roll":6.5},"age":23,"gender":{"type":"female","probability":1},"landmark4":[{"x":342.55,"y":392.89},{"x":537.16,"y":425.52},{"x":444.49,"y":492},{"x":417.93,"y":598.68}],"landmark72":[{"x":211.42,"y":389.11},{"x":211.45,"y":454.33},{"x":217.19,"y":520.68},{"x":230.51,"y":587.25},{"x":272.21,"y":653.61},{"x":333.86,"y":701.47},{"x":397.65,"y":722.14},{"x":458.56,"y":714.69},{"x":521.82,"y":680.24},{"x":567.83,"y":629.46},{"x":595.26,"y":573.74},{"x":617.43,"y":516.93},{"x":634.24,"y":460.12},{"x":292.98,"y":390.39},{"x":318.13,"y":376.28},{"x":344.48,"y":374.84},{"x":368.84,"y":386.52},{"x":387.21,"y":412.33},{"x":362.76,"y":414.49},{"x":335.75,"y":413.25},{"x":310.65,"y":404.53},{"x":342.55,"y":392.89},{"x":267.67,"y":337.43},{"x":307.64,"y":313.65},{"x":348.79,"y":317.8},{"x":384.91,"y":330.65},{"x":414.2,"y":361.04},{"x":378.63,"y":350.6},{"x":343.11,"y":336.44},{"x":306.05,"y":330},{"x":496.1,"y":431.47},{"x":520.92,"y":411.42},{"x":547.64,"y":408.35},{"x":570.53,"y":418.62},{"x":587.01,"y":440.4},{"x":567.85,"y":447.97},{"x":543.23,"y":448.07},{"x":517.74,"y":440.38},{"x":537.16,"y":425.52},{"x":496.91,"y":377.12},{"x":531.03,"y":357.65},{"x":565.65,"y":356.6},{"x":601.4,"y":364.84},{"x":625.76,"y":397.18},{"x":597.98,"y":379.65},{"x":565.2,"y":375.88},{"x":531.03,"y":377.78},{"x":418.64,"y":417.49},{"x":409.97,"y":447.95},{"x":400.39,"y":478.22},{"x":383.7,"y":515.63},{"x":413.63,"y":516.49},{"x":458.04,"y":524.06},{"x":479.96,"y":530.58},{"x":476.66,"y":489.77},{"x":474.56,"y":457.83},{"x":472.9,"y":426.24},{"x":444.49,"y":492},{"x":344.52,"y":588.53},{"x":381.99,"y":565.59},{"x":426.46,"y":565.31},{"x":464,"y":578.93},{"x":483.89,"y":612.39},{"x":453.93,"y":633.54},{"x":412.94,"y":637.6},{"x":371.08,"y":619.74},{"x":383.01,"y":583.79},{"x":422.29,"y":586.94},{"x":456.09,"y":596},{"x":451.53,"y":609.57},{"x":417.9,"y":605.64},{"x":381.4,"y":598.02}],"landmark150":{"cheek_right_1":{"x":213.31,"y":376.48},"cheek_right_3":{"x":212.31,"y":445},"cheek_right_5":{"x":216.89,"y":514.34},"cheek_right_7":{"x":228.12,"y":584.53},"cheek_right_9":{"x":270.75,"y":653.04},"cheek_right_11":{"x":332.93,"y":699.57},"chin_2":{"x":398.69,"y":722.57},"cheek_left_11":{"x":462.08,"y":717.99},"cheek_left_9":{"x":525.5,"y":684.85},"cheek_left_7":{"x":569.52,"y":629.84},"cheek_left_5":{"x":595.66,"y":570.57},"cheek_left_3":{"x":617.83,"y":511.85},"cheek_left_1":{"x":633.71,"y":451.79},"eye_right_corner_right":{"x":293.33,"y":390.13},"eye_right_eyelid_upper_2":{"x":318.25,"y":377.04},"eye_right_eyelid_upper_4":{"x":344.68,"y":375.49},"eye_right_eyelid_upper_6":{"x":369.89,"y":386.77},"eye_right_corner_left":{"x":390.44,"y":410.11},"eye_right_eyelid_lower_6":{"x":365.1,"y":412.33},"eye_right_eyelid_lower_4":{"x":337.94,"y":411.41},"eye_right_eyelid_lower_2":{"x":312.77,"y":403.81},"eye_right_eyeball_center":{"x":341.34,"y":392.67},"eyebrow_right_corner_right":{"x":266.1,"y":339.17},"eyebrow_right_upper_2":{"x":303.64,"y":314.75},"eyebrow_right_upper_3":{"x":344.8,"y":317.85},"eyebrow_right_upper_4":{"x":381.22,"y":331.85},"eyebrow_right_corner_left":{"x":410.94,"y":362.62},"eyebrow_right_lower_3":{"x":374.82,"y":350.73},"eyebrow_right_lower_2":{"x":340.14,"y":335.51},"eyebrow_right_lower_1":{"x":302.89,"y":329.1},"eye_left_corner_right":{"x":492.67,"y":428.42},"eye_left_eyelid_upper_2":{"x":518.31,"y":410.95},"eye_left_eyelid_upper_4":{"x":545.71,"y":408.81},"eye_left_eyelid_upper_6":{"x":569,"y":419.01},"eye_left_corner_left":{"x":585.88,"y":440.01},"eye_left_eyelid_lower_6":{"x":565.43,"y":446.83},"eye_left_eyelid_lower_4":{"x":540.8,"y":446.05},"eye_left_eyelid_lower_2":{"x":515,"y":438.53},"eye_left_eyeball_center":{"x":536.12,"y":425.9},"eyebrow_left_corner_right":{"x":495.13,"y":377.7},"eyebrow_left_upper_2":{"x":529.83,"y":358.02},"eyebrow_left_upper_3":{"x":565,"y":356.28},"eyebrow_left_upper_4":{"x":599.49,"y":366.73},"eyebrow_left_corner_left":{"x":619.9,"y":400.87},"eyebrow_left_lower_3":{"x":595.48,"y":380.91},"eyebrow_left_lower_2":{"x":563.7,"y":375.62},"eyebrow_left_lower_1":{"x":529.85,"y":378.42},"nose_right_contour_1":{"x":418.86,"y":416.29},"nose_right_contour_2":{"x":410.51,"y":446.37},"nose_right_contour_3":{"x":402.36,"y":476.4},"nose_right_contour_4":{"x":383.4,"y":513.02},"nose_right_contour_6":{"x":410.52,"y":516.68},"nose_left_contour_6":{"x":456.86,"y":525.44},"nose_left_contour_4":{"x":478.09,"y":528.98},"nose_left_contour_3":{"x":474.87,"y":488.63},"nose_left_contour_2":{"x":473.23,"y":457.12},"nose_left_contour_1":{"x":471.49,"y":425.63},"nose_tip":{"x":442.2,"y":496.31},"mouth_corner_right_outer":{"x":341.24,"y":585.81},"mouth_lip_upper_outer_3":{"x":379.69,"y":563.4},"mouth_lip_upper_outer_6":{"x":426.17,"y":562.78},"mouth_lip_upper_outer_9":{"x":466.59,"y":577.21},"mouth_corner_left_outer":{"x":486.51,"y":610.45},"mouth_lip_lower_outer_9":{"x":456.17,"y":631.45},"mouth_lip_lower_outer_6":{"x":413.57,"y":633.21},"mouth_lip_lower_outer_3":{"x":370.08,"y":617.74},"mouth_lip_upper_inner_3":{"x":380.98,"y":580.09},"mouth_lip_upper_inner_6":{"x":422.31,"y":583.11},"mouth_lip_upper_inner_9":{"x":458.37,"y":593.28},"mouth_lip_lower_inner_9":{"x":453.4,"y":609.05},"mouth_lip_lower_inner_6":{"x":418.46,"y":604.37},"mouth_lip_lower_inner_3":{"x":380.29,"y":597.38},"cheek_right_2":{"x":212.93,"y":410.5},"cheek_right_4":{"x":214.39,"y":479.51},"cheek_right_6":{"x":220.68,"y":550.2},"cheek_right_8":{"x":245.39,"y":621.53},"cheek_right_10":{"x":300.01,"y":678.73},"chin_1":{"x":364.7,"y":714.6},"chin_3":{"x":430.51,"y":724.12},"cheek_left_10":{"x":495.61,"y":704.82},"cheek_left_8":{"x":549.96,"y":659.87},"cheek_left_6":{"x":583.27,"y":600.8},"cheek_left_4":{"x":607.33,"y":541.8},"cheek_left_2":{"x":626.35,"y":482.51},"eyebrow_right_upper_1":{"x":267.94,"y":331.45},"eyebrow_right_upper_5":{"x":413.45,"y":350.56},"eyebrow_left_upper_1":{"x":496.52,"y":365.34},"eyebrow_left_upper_5":{"x":621.09,"y":392.67},"eye_right_eyelid_upper_1":{"x":304.44,"y":381.64},"eye_right_eyelid_upper_3":{"x":331.09,"y":373.67},"eye_right_eyelid_upper_5":{"x":358.57,"y":378.95},"eye_right_eyelid_upper_7":{"x":381.67,"y":397.09},"eye_right_eyelid_lower_7":{"x":377.69,"y":411.71},"eye_right_eyelid_lower_5":{"x":351.62,"y":413.56},"eye_right_eyelid_lower_3":{"x":324.75,"y":409.51},"eye_right_eyelid_lower_1":{"x":302.54,"y":398.2},"eye_right_eyeball_right":{"x":320.4,"y":391},"eye_right_eyeball_left":{"x":361.31,"y":397.8},"eye_left_eyelid_upper_1":{"x":503.74,"y":417.52},"eye_left_eyelid_upper_3":{"x":531.35,"y":407.53},"eye_left_eyelid_upper_5":{"x":558.43,"y":411.84},"eye_left_eyelid_upper_7":{"x":579.32,"y":428.12},"eye_left_eyelid_lower_7":{"x":575.56,"y":444.47},"eye_left_eyelid_lower_5":{"x":553.17,"y":448.07},"eye_left_eyelid_lower_3":{"x":527.36,"y":443.86},"eye_left_eyelid_lower_1":{"x":503.32,"y":434.23},"eye_left_eyeball_right":{"x":515.84,"y":424.58},"eye_left_eyeball_left":{"x":556.66,"y":430.73},"nose_bridge_1":{"x":447.91,"y":420.66},"nose_bridge_2":{"x":445.64,"y":451.94},"nose_bridge_3":{"x":443.32,"y":483.13},"nose_right_contour_5":{"x":397.12,"y":529.26},"nose_right_contour_7":{"x":411.09,"y":503.25},"nose_left_contour_7":{"x":461.95,"y":512.58},"nose_left_contour_5":{"x":462.48,"y":540.26},"nose_middle_contour":{"x":431.88,"y":537.16},"mouth_corner_right_inner":{"x":347,"y":585.72},"mouth_corner_left_inner":{"x":481.52,"y":608.27},"mouth_lip_upper_outer_1":{"x":351.78,"y":575.3},"mouth_lip_upper_outer_2":{"x":364.76,"y":567.86},"mouth_lip_upper_outer_4":{"x":394.51,"y":557.96},"mouth_lip_upper_outer_5":{"x":410.21,"y":557.41},"mouth_lip_upper_outer_7":{"x":441.58,"y":563.41},"mouth_lip_upper_outer_8":{"x":455.29,"y":568.3},"mouth_lip_upper_outer_10":{"x":476.87,"y":586.34},"mouth_lip_upper_outer_11":{"x":483.55,"y":597.48},"mouth_lip_lower_outer_11":{"x":477.84,"y":619.73},"mouth_lip_lower_outer_10":{"x":468.21,"y":627.16},"mouth_lip_lower_outer_8":{"x":442.45,"y":635.54},"mouth_lip_lower_outer_7":{"x":428.47,"y":636.02},"mouth_lip_lower_outer_5":{"x":397.32,"y":631.81},"mouth_lip_lower_outer_4":{"x":382.9,"y":626.59},"mouth_lip_lower_outer_2":{"x":357.81,"y":609.33},"mouth_lip_lower_outer_1":{"x":348.66,"y":598.32},"mouth_lip_upper_inner_1":{"x":354.69,"y":582.61},"mouth_lip_upper_inner_2":{"x":367.18,"y":580.48},"mouth_lip_upper_inner_4":{"x":394.89,"y":578.02},"mouth_lip_upper_inner_5":{"x":408.31,"y":578.95},"mouth_lip_upper_inner_7":{"x":435.23,"y":583.8},"mouth_lip_upper_inner_8":{"x":446.95,"y":587.1},"mouth_lip_upper_inner_10":{"x":468.75,"y":597.9},"mouth_lip_upper_inner_11":{"x":477.16,"y":603.44},"mouth_lip_lower_inner_11":{"x":474.97,"y":610.84},"mouth_lip_lower_inner_10":{"x":465,"y":610.23},"mouth_lip_lower_inner_8":{"x":441.62,"y":607.74},"mouth_lip_lower_inner_7":{"x":430.57,"y":606.11},"mouth_lip_lower_inner_5":{"x":405.1,"y":602.18},"mouth_lip_lower_inner_4":{"x":393.08,"y":600},"mouth_lip_lower_inner_2":{"x":366.38,"y":594.11},"mouth_lip_lower_inner_1":{"x":354.07,"y":590.78}},"landmark201":{"cheek_right_1":{"x":213.22915649414,"y":372.33111572266},"cheek_right_3":{"x":211.96017456055,"y":439.81048583984},"cheek_right_5":{"x":215.05560302734,"y":508.29144287109},"cheek_right_7":{"x":224.61000061035,"y":578.12634277344},"cheek_right_9":{"x":266.06130981445,"y":649.23956298828},"cheek_right_11":{"x":330.36294555664,"y":698.38012695312},"chin_2":{"x":395.84976196289,"y":721.20947265625},"cheek_left_11":{"x":460.86743164062,"y":715.66754150391},"cheek_left_9":{"x":528.61138916016,"y":682.13861083984},"cheek_left_7":{"x":577.67846679688,"y":626.98022460938},"cheek_left_5":{"x":603.46160888672,"y":566.48693847656},"cheek_left_3":{"x":624.44720458984}}}]},"_note":"Response truncated for documentation purposes"}
curl --location 'https://zylalabs.com/api/4439/facial+landmarks+api/5452/facial+landmarks' \
--header 'Content-Type: application/json' \
--form 'image=@"FILE_PATH"'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
Nossa API de Detecção de Marcos Faciais fornece uma solução avançada para detectar e analisar marcos faciais com alta precisão Essa API suporta a detecção de 72 150 e 201 pontos-chave cobrindo características faciais essenciais como olhos sobrancelhas lábios e contornos do nariz Além disso oferece localização precisa de características faciais incluindo sobrancelhas olhos nariz boca e bochechas bem como identificação precisa de contornos faciais para rostos únicos e múltiplos A API também inclui estimativa de ângulo facial permitindo a determinação de várias poses faciais na imagem
Reconhecimento Facial: Aumentando a precisão dos sistemas de reconhecimento facial ao identificar características faciais chave Animação e Jogos: Criando animações faciais realistas ao mapear marcos faciais para modelos de personagens Realidade Aumentada (RA): Permitindo que aplicativos de RA coloquem elementos virtuais com precisão nos rostos dos usuários, como filtros e máscaras Beleza e Cosméticos: Potencializando aplicativos virtuais de maquiagem e beleza para aplicar cosméticos com precisão nas características faciais Fotografia e Videografia: Melhorando a detecção facial para melhores configurações de foco e exposição em câmeras
Alta Precisão: Proporciona identificação precisa de características faciais chave, aumentando a eficácia de aplicações que dependem de análise facial Processamento em Tempo Real: Capaz de identificar marcos faciais em tempo real, tornando-se adequado para aplicações ao vivo como AR e monitoramento de segurança Versatilidade: Aplicável a diversos campos, incluindo reconhecimento facial, animação, AR, diagnósticos médicos, beleza, fotografia, segurança e interação humano-computador Consistência: Oferece resultados fiáveis e consistentes em diferentes rostos e condições
Pesquisadores e Engenheiros em Visão Computacional: Profissionais e acadêmicos que trabalham no desenvolvimento de sistemas de reconhecimento facial, algoritmos de detecção de emoções e outras aplicações que requerem a localização precisa de pontos de referência faciais Desenvolvedores de Realidade Aumentada (AR) e Realidade Virtual (VR): Indivíduos que criam experiências imersivas que envolvem rastreamento e interação facial Profissionais e Pesquisadores de Saúde: Aqueles que estudam a anatomia facial para diagnóstico médico, reconstrução facial ou análise de expressões faciais em pesquisas psicológicas Artistas Digitais e Animadores: Criadores que usam pontos de referência faciais para animação de personagens, morphing facial e outros efeitos visuais
A API de Marcos Faciais retorna dados relacionados a características faciais, incluindo o número de rostos detectados, suas localizações, tokens de rosto, níveis de confiança e coordenadas detalhadas de marcos. Ela também fornece informações adicionais como idade, gênero e ângulos faciais
Os campos principais na resposta incluem `face_num` (número de faces detectadas), `face_list` (detalhes de cada face), `face_probability` (pontuação de confiança) e vários arrays de pontos de referência (por exemplo, `landmark4`, `landmark72`, etc.) que fornecem coordenadas para características faciais
Os dados de resposta estão estruturados como um objeto JSON contendo parâmetros públicos (como `request_id` e `error_code`) e parâmetros de negócios (como `result`, que inclui detalhes da face) As informações de cada face estão aninhadas dentro do array `face_list`
O ponto final aceita parâmetros como `imagem` (obrigatório), `num_max_face` (opcional, para especificar o número de rostos a serem detectados) e `campo_face` (opcional, para solicitar informações adicionais como idade e gênero)
Os usuários podem personalizar solicitações ajustando o `max_face_num` para detectar múltiplas faces e selecionando valores específicos de `face_field` para recuperar dados adicionais, como `landmark150` ou `gender`, com base em suas necessidades de aplicação
A API fornece informações sobre marcos faciais, localizações de faces, pontuações de confiança, idade, gênero e ângulos faciais. Os usuários podem escolher receber diferentes níveis de detalhe especificando o parâmetro `face_field`
Os usuários podem utilizar os dados retornados analisando a `face_list` para coordenadas de características faciais usando `face_probability` para avaliações de confiança e aproveitando dados de idade e gênero para insights demográficos em aplicações como marketing ou segurança
Casos de uso típicos incluem aprimorar sistemas de reconhecimento facial desenvolver aplicativos de realidade aumentada com rastreamento facial em tempo real criar filtros de beleza personalizados e conduzir análises demográficas em estudos de engajamento do usuário
Nível de serviço:
100%
Tempo de resposta:
909ms
Nível de serviço:
100%
Tempo de resposta:
280ms
Nível de serviço:
100%
Tempo de resposta:
949ms
Nível de serviço:
100%
Tempo de resposta:
5.626ms
Nível de serviço:
100%
Tempo de resposta:
465ms
Nível de serviço:
100%
Tempo de resposta:
800ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
269ms
Nível de serviço:
100%
Tempo de resposta:
771ms
Nível de serviço:
100%
Tempo de resposta:
819ms
Nível de serviço:
100%
Tempo de resposta:
802ms
Nível de serviço:
100%
Tempo de resposta:
1.172ms
Nível de serviço:
100%
Tempo de resposta:
1.074ms
Nível de serviço:
100%
Tempo de resposta:
4.904ms
Nível de serviço:
100%
Tempo de resposta:
1.151ms
Nível de serviço:
100%
Tempo de resposta:
937ms
Nível de serviço:
100%
Tempo de resposta:
1.024ms
Nível de serviço:
100%
Tempo de resposta:
3.008ms
