MaIA Scan

API de beleza para agências

API de beleza para agências: como entregar personalização sem construir do zero

Agências recebem briefings de personalização com prazo de campanha e orçamento de campanha. Veja como usar uma API de beleza para agências entregar análise por selfie, prova virtual e recomendação sem montar um time de visão computacional.

5 min de leituraEquipe MaIA · B4A

Todo briefing de beleza hoje pede alguma forma de personalização: "queremos que a consumidora descubra o tom dela", "queremos provar o batom antes de comprar", "queremos recomendar o produto certo no WhatsApp". O problema é que o prazo é de campanha e o orçamento é de campanha — não de pesquisa e desenvolvimento. Uma API de beleza para agências resolve exatamente esse descompasso: a camada difícil (ler uma foto e devolver atributos estruturados) já existe e é consumida por requisição, enquanto a agência faz o que sabe fazer — conceito, interface, jornada e mensuração.

Por que construir do zero quase nunca fecha a conta

Montar análise de imagem própria significa dados de treino, times de visão computacional, infraestrutura de inferência, testes com diferentes tons de pele, iluminação e câmeras. É um produto, não um entregável. Para uma agência que atende várias marcas, o custo não se amortiza em um projeto só, e o risco técnico cai inteiro no seu contrato.

O caminho prático é tratar a inteligência como insumo. Você integra uma API, paga por uso, e o diferencial competitivo da agência passa a ser a experiência construída em cima dela: o fluxo, o copy, a estética, a integração com o CRM do cliente e a leitura dos resultados.

O que uma API de beleza para agências entrega na prática

Perfil de beleza a partir de uma selfie

O cliente envia uma foto e recebe um JSON com atributos visíveis: tom e subtom de pele, tipo e condição aparente da pele, características de cabelo, cada campo com um nível de confiança. É um dado estruturado — não um laudo. Serve para segmentar, recomendar e personalizar comunicação, nunca para diagnosticar condição de saúde.

Para a agência, isso significa que uma landing page de campanha pode terminar em algo melhor do que um cupom genérico: termina em um perfil que a marca passa a possuir. A análise de pele e cabelo por selfie via API é o bloco mais reutilizável do conjunto, porque alimenta quiz, e-mail, página de produto e atendimento com a mesma saída.

Prova virtual de maquiagem

A prova virtual de maquiagem existe em dois formatos, e a diferença importa no escopo. Pela API, o fluxo é baseado em foto: a consumidora envia a imagem, o produto — batom ou base — é renderizado sobre ela e a imagem volta pronta, com as cores calibradas a partir dos produtos reais da marca dentro de um projeto. É o formato que cabe em campanha, em WhatsApp, em e-mail e em qualquer canal onde você controla o envio de uma foto.

Há também um SDK de navegador, em acesso antecipado desde setembro de 2026, com treze produtos (batom, base, blush, pó facial, corretivo de olheira, sombra, máscara de cílios, maquiagem de sobrancelha, delineador, bronzer, contorno, iluminador e lápis labial) mais um Full Look combinado, em modo ao vivo pela câmera — renderizado localmente no navegador, sem upload — ou em modo foto, com qualquer cor em #RRGGBB e hospedagem pela própria marca. O acesso é concedido por conta, então trate isso como conversa prévia com o time, não como download público. E atenção ao escopo: os outros onze produtos e o Full Look são do SDK, não da API por foto.

Quando o briefing pede "uma consultora", a entrega deixa de ser só API. O MaIA Beauty Advisor lê o perfil de beleza e recomenda os produtos da própria marca em WhatsApp, página de produto e chat — e é entregue como projeto junto com o time da B4A, com o catálogo do cliente mapeado. Para a agência, isso normalmente entra como frente conjunta, não como integração self-service de uma sprint.

Três formatos de entrega que funcionam bem em agência

Campanha com captura de perfil. Landing page, selfie opcional, resultado na tela e perfil enviado ao CRM do cliente. Entrega rápida, mensurável e deixa um ativo de dado depois que a mídia acaba.

Experiência na página de produto. A prova por foto no PDP de batom ou base, sem app e sem instalação. O ganho é de confiança na escolha de cor; a métrica natural é conversão do PDP e devolução por tom errado.

Fluxo conversacional. No WhatsApp, a consumidora manda a foto, recebe a imagem com o produto aplicado e, se o projeto incluir o Advisor, uma recomendação baseada no perfil. É o formato que mais aproxima mídia de venda assistida.

Como orçar e combinar escopo com o cliente

Seja explícito sobre três pontos. Primeiro, consumo: a API é cobrada por crédito, então o volume estimado de sessões entra no orçamento como custo variável do cliente, não como taxa fixa da agência. Segundo, propriedade do dado: o perfil gerado é da marca e precisa de um destino definido (CRM, CDP, plataforma de e-mail) antes do go-live, ou a campanha vira uma experiência bonita sem resíduo. Terceiro, expectativa de resultado: nenhum número de mercado é promessa de desempenho — resultados variam conforme catálogo, tráfego e canal de cada marca.

Vale também alinhar o que a ferramenta não faz. Ela descreve atributos visíveis de uma foto. Não diagnostica, não trata e não substitui profissional de saúde. Copy de campanha precisa respeitar esse limite.

Começando o piloto em dias, não em trimestres

O caminho mais curto para a agência é técnico e self-service: criar uma conta, comprar créditos, gerar a chave de API e rodar a primeira chamada em ambiente de teste no mesmo dia. A documentação da API traz os campos de resposta e os formatos aceitos, o que permite ao time de tecnologia validar viabilidade antes mesmo de apresentar o conceito ao cliente.

Um bom piloto costuma ter escopo mínimo: um canal, um objetivo de medição e um destino de dado. A partir dele, a conversa com a marca deixa de ser hipotética e passa a ser sobre números reais da operação dela.

Crie sua conta, gere a chave de API e teste a primeira integração — ou fale com o time da B4A para desenhar um projeto com o catálogo do seu cliente.

Perguntas frequentes

O que uma agência precisa para começar a usar a API?

Criar uma conta, comprar créditos e gerar uma chave de API. A partir daí, o time de tecnologia já consegue enviar uma foto e receber o perfil de beleza em JSON em ambiente de teste.

A prova virtual pela API funciona com todos os produtos de maquiagem?

Não. Pela API, o fluxo é baseado em foto e cobre batom e base, com cores calibradas aos produtos reais da marca. Os demais produtos e o Full Look pertencem ao SDK de navegador, em acesso antecipado concedido por conta.

Quem fica com os dados do perfil de beleza gerado na campanha?

O dado é da marca cliente. Defina no escopo para onde ele vai — CRM, CDP ou plataforma de e-mail — antes do go-live, para que a campanha deixe um ativo próprio e não só uma experiência pontual.

A análise por selfie pode ser comunicada como avaliação dermatológica?

Não. A API descreve atributos visíveis da foto, como tom e subtom de pele, tipo aparente e características de cabelo. Ela não diagnostica, não trata e não substitui um profissional de saúde.

Dá para prometer aumento de conversão ao cliente?

Não como promessa. Números publicados por outras empresas são referências de mercado, não resultados da MaIA, e o desempenho varia conforme catálogo, tráfego e canal de cada marca. O caminho é medir no piloto.

API de belezaagênciasintegraçãopersonalizaçãoe-commerce de beleza

← Todos os artigos