Análisis de piel por selfie vía API: un perfil de belleza completo a partir de una foto

Qué es un análisis de piel por selfie — y qué no es

Un análisis de piel por foto usa visión computacional para leer, en una selfie común del celular, los atributos que una asesora de tienda observaría en persona: el tono de la piel y su subtono (cálido, frío o neutro) y — en el caso de MaIA Scan — también el color y el tipo de cabello (liso, ondulado, rizado o afro). El resultado no es un informe médico: es un perfil de belleza estructurado, hecho para personalizar recomendaciones de productos, quizzes y atención.

MaIA Scan no hace reconocimiento facial. La API no identifica personas, no crea plantillas biométricas, no compara rostros, no infiere rasgos protegidos ni emite diagnósticos médicos. Cada atributo vuelve con un estado — predicho o abstenido — y un score, y la pauta es simple: cuando el modelo se abstiene o el score es bajo, la marca confirma con la clienta en vez de asumir.

Lo que distingue al modelo es la base con la que fue entrenado: cientos de miles de selfies reales de consumidoras brasileñas, cubriendo toda la gama de tonos de piel y tipos de cabello de Brasil — no un dataset mayoritariamente blanco. Por eso MaIA Scan es especialmente preciso en piel brasileña y latinoamericana, justo donde la mayoría de las APIs de análisis de piel se equivoca con el tono de la base.

Cómo funciona, en cuatro pasos

La llamada es síncrona: la respuesta de la solicitud es el perfil terminado.

1. 1

   La clienta autoriza y envía la selfie

   Una foto frontal en JPEG o PNG de hasta 6 MB — y, si quieres más precisión en el cabello, una foto lateral en la misma llamada, sin crédito adicional. El consentimiento lo recoge antes la marca.

2. 2

   Tu aplicación llama a POST /api/v1/scan

   Multipart con el campo front (y el side opcional), autenticado con la clave de la cuenta: Authorization: Bearer msk_live_…. Un x-request-id opcional acompaña el evento de uso.

3. 3

   La API reserva el crédito y analiza

   El crédito se reserva antes de llamar al modelo y se liquida cuando llega la respuesta. Si el análisis falla, la reserva se devuelve automáticamente — nunca pagas por un resultado que no recibiste.

4. 4

   El perfil vuelve en JSON, con estado en cada atributo

   session_id, request_id, credits_charged, credits_remaining y el documento result con los atributos que pediste — cada uno con estado, valor, score y versión del modelo — más la verificación de calidad de la foto. Tú decides qué mostrar, qué confirmar y qué usar en tus reglas.

Qué devuelve la API de atributos de belleza

Cuatro atributos visibles, agrupados en tres modelos que eliges en cada llamada con el campo models. Solo vuelven los atributos pedidos; las claves siguen la versión de la MaIA Scan API — trata la respuesta como un documento JSON y lee los campos que necesites.

Para quién es: dónde un perfil de belleza por foto cambia la venta

MaIA Scan es un bloque de construcción. Lo que haces con el perfil depende del canal — y ahí es donde el análisis de piel para e-commerce se convierte en ingresos.

Por qué MaIA Scan y no una API genérica de análisis de piel

• Entrenada donde la belleza es diversa: cientos de miles de selfies brasileñas reales, con toda la gama de tonos de piel y tipos de cabello de Brasil.
• En producción en los mayores clubes de belleza de América Latina — glam y Men's Market — con el mismo motor que integras por la API.
• Piel y cabello en la misma llamada: el análisis de cabello por selfie (color y estructura) viene incluido, sin un segundo proveedor.
• Tres familias de modelo — color, condición de la piel y estructura capilar — reentrenadas con datos nuevos y validación humana; la respuesta guarda las versiones de modelo y de pipeline.
• Privacidad por diseño: consentimiento obligatorio, retención de la imagen original configurable por proyecto, ningún reconocimiento facial.
• Del perfil a la recomendación: con MaIA Beauty Advisor el mismo perfil se convierte en sugerencias de productos de tu catálogo, con la explicación del porqué.

Créditos: paga por lo que usas, sin mensualidad

Cada análisis consume créditos del saldo de la cuenta según los modelos que pidas — piel (tono y subtono), color del cabello y tipo de cabello — y solo por los que devolvieron un valor; la foto lateral opcional va en la misma llamada. Los paquetes se venden por número de créditos — Starter (R$ 998 por 500), Growth (R$ 1.998 por 2.500) y Scale (R$ 4.998 por 10.000) — pagados con tarjeta, Pix o boleto en nuestro propio checkout. Las recargas sueltas y automáticas siguen tu último paquete pagado; los créditos no caducan. La lista de precios por operación y la documentación completa en PDF están en el área de la cuenta.

El saldo después de la llamada viene en toda respuesta exitosa (credits_remaining). Con saldo cero, la llamada se rechaza antes de cualquier procesamiento con 402 insufficient_credits, sin cobro. Para volúmenes enterprise, límites por clave o contrato, habla con nosotros.

Privacidad, consentimiento y LGPD

Eres responsable de obtener la autorización explícita de la persona antes de enviar cualquier foto. En el gateway la imagen queda en memoria solo durante la solicitud y se reenvía una vez al modelo — nada va a disco, base de datos ni logs. La MaIA Scan API almacena el resultado estructurado con las versiones de modelo y de pipeline; la retención de la imagen original es configurable por proyecto. por solicitud guardamos cuenta, clave, endpoint, estado, crédito, latencia, x-request-id y capture_id — lo que ves en tu página de uso.

Integración: self-service hoy, proyecto cuando quieras más

El análisis es self-service vía API. La recomendación de productos a partir del perfil no es un endpoint: se entrega como proyecto, y es rápida de montar — integramos el catálogo de tu marca.