Análise de pele por selfie via API: um perfil de beleza completo a partir de uma foto

O que é uma análise de pele por selfie — e o que ela não é

Uma análise de pele por foto usa visão computacional para ler, em uma selfie comum de celular, os atributos que uma consultora de loja observaria pessoalmente: o tom da pele e o seu subtom (quente, frio ou neutro) e — no caso da MaIA Scan — também a cor e o tipo do cabelo (liso, ondulado, cacheado ou crespo). O resultado não é um laudo: é um perfil de beleza estruturado, feito para personalizar recomendação de produtos, quizzes e atendimento.

A MaIA Scan não faz reconhecimento facial. A API não identifica pessoas, não cria templates biométricos, não faz matching de rostos, não infere traços protegidos e não emite diagnóstico médico. Cada atributo volta com um status — previsto ou abstido — e um score, e a orientação é simples: quando o modelo se abstém ou o score é baixo, a marca confirma com a cliente em vez de assumir.

O que diferencia o modelo é a base em que foi treinado: centenas de milhares de selfies reais de consumidoras brasileiras, cobrindo toda a gama de tons de pele e tipos de cabelo do Brasil — não um dataset majoritariamente branco. Por isso a MaIA Scan é singularmente forte para a pele brasileira e latino-americana, justamente onde a maioria das APIs de análise de pele erra o tom da base.

Como funciona, em quatro passos

A chamada é síncrona: a resposta da requisição é o perfil pronto.

1. 1

   A cliente autoriza e envia a selfie

   Uma foto frontal em JPEG ou PNG de até 6 MB — e, se quiser mais precisão para cabelo, uma foto de perfil na mesma chamada, sem crédito adicional. O consentimento é colhido antes, pela marca.

2. 2

   Sua aplicação chama POST /api/v1/scan

   Multipart com o campo front (e o side opcional), autenticado com a chave da conta: Authorization: Bearer msk_live_…. Um x-request-id opcional acompanha o evento de uso.

3. 3

   A API reserva o crédito e analisa

   O crédito é reservado antes de chamarmos o modelo e liquidado quando a resposta chega. Se a análise falhar, a reserva é devolvida automaticamente — você nunca paga por um resultado que não recebeu.

4. 4

   O perfil volta em JSON, com status em cada atributo

   session_id, request_id, credits_charged, credits_remaining e o documento result com os atributos que você pediu — cada um com status, valor, score e versão do modelo — mais a verificação de qualidade da foto. Você decide o que mostrar, o que confirmar e o que usar nas suas regras.

O que a API de atributos de beleza devolve

Quatro atributos visíveis, agrupados em três modelos que você escolhe a cada chamada com o campo models. Só os atributos pedidos voltam; as chaves seguem a versão da MaIA Scan API — trate a resposta como um documento JSON e leia os campos de que precisa.

Para quem é: onde um perfil de beleza por foto muda a venda

A MaIA Scan é um bloco de construção. O que você faz com o perfil depende do canal — e é aí que a análise de pele para e-commerce vira receita.

Por que a MaIA Scan, e não uma API genérica de análise de pele

• Treinada onde a beleza é diversa: centenas de milhares de selfies brasileiras reais, com toda a gama de tons de pele e tipos de cabelo do Brasil.
• Em produção nos maiores clubes de beleza da América Latina — glam e Men's Market — no mesmo motor que você integra pela API.
• Pele e cabelo na mesma chamada: a análise de cabelo por selfie (cor e estrutura) vem junto, sem um segundo fornecedor.
• Três famílias de modelo — cor, condição da pele e estrutura capilar — retreinadas com novos dados e validação humana; a resposta guarda as versões de modelo e de pipeline.
• Privacidade por design: consentimento obrigatório, retenção da imagem bruta configurável por projeto, nenhum reconhecimento facial.
• Do perfil à recomendação: com a MaIA Beauty Advisor, o mesmo perfil vira sugestão de produtos do seu catálogo, com a explicação do porquê.

Créditos: pague pelo que usar, sem mensalidade

Cada análise consome créditos do saldo da conta de acordo com os modelos que você pedir — pele (tom e subtom), cor do cabelo e tipo de cabelo — e só pelos que devolveram um valor; a foto de perfil opcional vai na mesma chamada. Os pacotes são vendidos por número de créditos — Starter (R$ 998 por 500), Growth (R$ 1.998 por 2.500) e Scale (R$ 4.998 por 10.000) — pagos por cartão, Pix ou boleto no nosso próprio checkout. Recargas avulsas e automáticas seguem o seu último pacote pago; créditos não expiram. A lista de preços por operação e a documentação completa em PDF ficam na área da conta.

O saldo após a chamada vem em toda resposta bem-sucedida (credits_remaining). Com saldo zero, a chamada é recusada antes de qualquer processamento com 402 insufficient_credits, sem cobrança. Para volumes enterprise, limites por chave ou contrato, fale com a gente.

Privacidade, consentimento e LGPD

Você é responsável por obter a autorização explícita da pessoa antes de enviar qualquer foto. No gateway, a imagem fica em memória apenas durante a requisição e é encaminhada uma vez ao modelo — nada vai para disco, banco ou logs. A MaIA Scan API armazena o resultado estruturado com as versões de modelo e de pipeline; a retenção da imagem bruta é configurável por projeto. por requisição guardamos conta, chave, endpoint, status, crédito, latência, x-request-id e capture_id — é o que aparece na sua página de uso.

Integração: self-service hoje, projeto quando você quiser mais

A análise é self-service via API. A recomendação de produtos a partir do perfil não é um endpoint: é entregue como projeto, e é rápida de montar — basta integrarmos o catálogo da sua marca.