iLook Face Analysis MCP

Ferramentas de análise facial por IA autorizadas para adultos, incluindo formato do rosto, simetria, pontuação phi e feedback de aparência, via MCP HTTP Streamable.

Ver em ilook.fit

Documentação

API iLook v1

Envie uma imagem autorizada de adulto para POST /api/v1/score como multipart/form-data.

Para um relatório gratuito de ferramenta única, use POST /api/v1/tools/{tool} com uma chave de ferramenta suportada e concreta, como jawline_rating ou golden_ratio_face. O servidor MCP também expõe ferramentas focadas nomeadas junto com score_face.

Campos obrigatórios

  • image: JPEG, PNG ou WebP, máximo de 5 MB.
  • adult_and_authorized=true: atestado de uso adulto e lícito.
  • Chaves de agente emitidas autenticam com Authorization: Bearer <api-key>.

Resposta

A API retorna um ID de análise, versão da rubrica, modelo, pontuação geral de 0 a 100, cinco subpontuações visíveis, contexto de formato facial, pontuação phi da Proporção Áurea de 0 a 100, explicações em uma linha, resumo, confiança e um aviso de segurança.

API iLook vs APIs de visão computacional de uso geral

A iLook é uma API de feedback de aparência criada para esse fim. APIs de visão computacional de uso geral podem suportar tarefas amplas de imagem; a iLook, em vez disso, retorna um scorecard pequeno e versionado com limites explícitos e não oferece reconhecimento de identidade, correspondência biométrica, saídas médicas ou inferência de características sensíveis. Use a iLook para feedback de foto de perfil com consentimento, fluxos de estilo, orientação de qualidade de imagem e demonstrações de agentes.

Exemplos de implementação

Fluxo de trabalho REST em Python

Use uma solicitação multipart para https://www.ilook.fit/api/v1/score com Authorization: Bearer <api-key>, adult_and_authorized=true e uma imagem JPEG, PNG ou WebP de no máximo 5 MB. Mantenha a imagem de origem na memória apenas para a solicitação. Se você reter um resultado downstream permitido, armazene analysis_id, rubric_version e os campos resultantes, nunca os bytes da imagem em logs, rastreamentos ou cargas de fila.

Fluxo de trabalho MCP

Inicialize POST /mcp, liste as ferramentas e então chame score_face com image_base64, mime_type, adult_and_authorized: true e um measurement_key focado opcional. Use ferramentas focadas nomeadas quando apenas uma saída for necessária. Não coloque bytes de imagem em base64 em prompts, logs, cargas de fila ou rastreamentos.

measurements retorna os blocos de relatório da ferramenta gratuita. Cada bloco usa score, label, analysis e linhas estáveis de details.

Linhas de medição estáveis

  • face_shape_detector: Formato Primário, Correspondência Primária, Formato Vice-Campeão, Correspondência Vice-Campeã, Indicação de Comprimento-Largura, Área Mais Larga, Curva da Linha da Mandíbula, Direção de Estilo.
  • jawline_rating: Estimativa Esquerda, Média, Estimativa Direita, Ângulo da Mandíbula em Foto Frontal, Definição, Afunilamento, Simetria, Largura Visível da Mandíbula, Parte Inferior Visível do Rosto.
  • canthal_tilt: Inclinação do Olho Esquerdo, Inclinação do Olho Direito, Inclinação Média, Diferença Esquerda/Direita, Categoria.
  • eye_shape: Formato da Abertura, Proporção da Abertura, Espaçamento dos Olhos, Estimativa de Cor dos Olhos, Orientação dos Cantos, Simetria da Boca, Enquadramento dos Olhos, Ideias de Estilo, Notas das Sobrancelhas.
  • face_age_cues: Apresentação da Foto, Direção da Apresentação, Principais Fatores.
  • facial_symmetry: Pontuação Geral de Simetria, Simetria dos Olhos, Simetria das Sobrancelhas, Simetria do Nariz, Simetria da Boca, Simetria da Mandíbula, Verificação de Foto de Frente, Comprovação em Nível de Característica.
  • golden_ratio_face: Pontuação da Proporção Áurea, Comprimento-Largura do Rosto, Terços Faciais, Quintos Faciais.
  • attractiveness_test: Pontuação Geral, Simetria, Equilíbrio dos Terços Faciais, Equilíbrio dos Quintos Faciais, Proporção Áurea, Medição da Linha da Mandíbula, Medição do Formato Facial.
  • psl_score: Faixa Estilo PSL, Pontuação de Geometria, Simetria, Terços Visíveis, Quintos Faciais, Proximidade da Proporção Áurea, Base de Conversão.
  • facial_ratios: Proporção da Parte Superior do Rosto Estilo FWHR, Proporção Visível Comprimento-Largura do Rosto, Proporção Mandíbula-Maçãs do Rosto, Proporção Distância Pupilar-Largura do Rosto, Proporção de Espaçamento dos Olhos, Inclinação Cantal Média, Participação da Altura do Terço Médio, Participação da Altura da Parte Inferior do Rosto, Proporção Boca-Largura do Rosto, Proporção Nariz-Largura da Boca, Proporção Comprimento do Nariz-Altura do Rosto, Proporção Altura dos Lábios-Largura da Boca.
  • color_analysis: Veredito de Estação, Estação Vice-Campeã, Temperatura da Paleta, Valor, Croma, Contraste, Cores de Amostra, Ressalva de Iluminação.
  • skin_analysis: Uniformidade da Textura, Uniformidade do Tom, Hidratação Aparente, Brilho, Sinais Visíveis de Fotoenvelhecimento, O Que Está Funcionando, Áreas de Foco, Ressalva de Iluminação.
  • hairstyle_finder: Formato Facial, Melhor Direção Geral, Penteados Recomendados, Notas de Barba/Enquadramento, Estilos para Usar com Cautela.

Descoberta de agentes