MaIA Scan

API de análisis de piel para app móvil

API de análisis de piel para app móvil: cómo integrarla sin construir el modelo

Guía práctica para equipos de producto y desarrollo que quieren llevar el análisis de piel por selfie a su app: flujo de captura, arquitectura con proxy, manejo de confianza y privacidad.

5 min de lecturaEquipo MaIA · B4A

Una app de marca tiene algo que el sitio web rara vez consigue: la cámara frontal a un toque de distancia y una sesión identificada. Por eso, integrar una API de análisis de piel para app móvil suele ser el camino más corto para pasar de un catálogo plano a una experiencia que sabe con quién está hablando. En este artículo repasamos el flujo completo —captura, llamada, respuesta, uso del perfil— desde la perspectiva de quien va a escribir el código y de quien va a aprobar el proyecto.

Qué resuelve el análisis por selfie dentro de una app

En el navegador, pedir una foto implica fricción: permisos, encuadre, incertidumbre sobre qué pasa con la imagen. En una app ya instalada, el usuario concedió permisos de cámara, entiende el contexto y normalmente está logueado. Eso convierte la selfie en un dato de onboarding barato y repetible.

Con ese dato se resuelven tres problemas concretos:

  • Onboarding sin cuestionario largo. En vez de diez preguntas sobre tipo de piel y tono, una foto.
  • Catálogo ordenado por persona. La home de la app deja de mostrar lo mismo para todos.
  • Continuidad entre canales. El perfil guardado en tu base alimenta email, WhatsApp y atención.

MaIA Scan entrega ese perfil como JSON: tono y subtono de piel, tipo y condición de la piel, atributos de cabello y una confianza por campo. El modelo fue entrenado con piel brasileña, lo que importa cuando tu base de usuarios es latinoamericana y diversa. Puedes ver el detalle del producto en la página de análisis de piel y cabello por selfie.

Cómo integrar una API de análisis de piel para app móvil

El flujo mínimo

  1. La app captura la selfie con la cámara frontal y una guía de encuadre.
  2. La app envía la imagen a tu backend, no directamente al proveedor.
  3. Tu backend llama a la API con tu clave, recibe el JSON y lo guarda asociado al usuario.
  4. La app recibe el perfil ya procesado y renderiza la pantalla de resultado.

Este orden no es un detalle de estilo. Es lo que mantiene la clave de API fuera del binario y te da un punto único donde registrar, auditar y versionar lo que ocurre.

Por qué el proxy en tu backend es obligatorio

Cualquier credencial embebida en un app bundle es extraíble. Un proxy propio te permite autenticar al usuario antes de gastar un crédito, limitar la cantidad de análisis por sesión, enriquecer la respuesta con datos de tu catálogo y cambiar de versión de la API sin publicar una nueva versión en las tiendas.

También te da control sobre el reintento: si la respuesta falla por conexión intermitente —algo normal en mobile—, el reintento ocurre en tu servidor y la app solo ve un estado de "procesando".

Caché y estado

El perfil de belleza no cambia de un minuto a otro. Guárdalo en tu base con fecha y versión del modelo, y vuelve a analizar solo cuando el usuario lo pida o cuando pase un período que tú definas. Así, la segunda apertura de la app muestra recomendaciones al instante, sin nueva llamada.

La captura define la calidad de la respuesta

La parte más subestimada del proyecto no es la llamada HTTP: es la pantalla de cámara.

  • Luz. Avisa cuando la escena está muy oscura o con contraluz fuerte.
  • Encuadre. Un óvalo guía y detección de rostro en el dispositivo evitan fotos cortadas.
  • Sin filtros. Desactiva cualquier embellecimiento automático del sistema de cámara.
  • Resolución y compresión. Define un tamaño estándar antes de subir, para no castigar redes lentas.

Una pantalla de captura bien hecha reduce más errores que cualquier ajuste posterior.

Cómo usar la confianza por campo

Cada campo del perfil viene con un valor de confianza. Úsalo como regla de producto, no como dato decorativo.

Un patrón simple que funciona bien en app:

  • Confianza alta: la app afirma y recomienda directamente.
  • Confianza media: la app sugiere y ofrece confirmación ("¿tu piel suele brillar al mediodía?").
  • Confianza baja: la app no muestra ese atributo y propone repetir la foto con mejor luz.

Así evitas la peor experiencia posible: una afirmación segura sobre algo que el usuario sabe que no es cierto. Vale recordar que el análisis describe atributos visibles en una foto; no diagnostica ni sustituye a un profesional de la salud.

Qué construir encima del perfil

Recomendación con SKU

El perfil solo genera valor cuando se cruza con tu catálogo. Mapea atributos a filtros de producto y define qué pasa cuando no hay match exacto. Si prefieres no construir esa lógica, MaIA Beauty Advisor es una consultora de IA integrada al catálogo de la marca, entregada como proyecto junto al equipo de B4A, y funciona en WhatsApp, páginas de producto y chat.

Prueba de color

Para maquillaje, el perfil responde "qué tono" y la prueba visual responde "cómo me queda". MaIA Try-On tiene una API que aplica labial o base sobre una foto enviada, con paletas calibradas a los productos reales de la marca, y un SDK de navegador en early access con trece productos y Full Look en modo ao vivo por cámara o modo foto, renderizado localmente.

Historial del usuario

Guardar varios análisis a lo largo del tiempo permite mostrar al usuario cómo cambian los atributos visibles entre estaciones o rutinas, y te da señales para reactivación.

Privacidad y permisos

Define desde el inicio tres cosas y escríbelas en la pantalla de captura: para qué se usa la foto, si se almacena y por cuánto tiempo, y cómo el usuario puede borrar su perfil. En la mayoría de los proyectos no hace falta guardar la imagen: basta con el JSON. Menos retención, menos superficie de riesgo, menos conversaciones largas con el área legal.

Primeros pasos

El camino es self-serve: creas una cuenta, compras créditos y obtienes una clave de API. Empieza por un entorno de prueba, implementa el proxy, valida con un grupo interno de usuarios con tonos de piel variados y recién entonces libera la función a toda la base.

Crea tu cuenta y tu clave en la documentación de la API, o habla con el equipo de B4A si quieres revisar la arquitectura de tu app antes de escribir la primera línea.

Preguntas frecuentes

¿Puedo llamar a la API de análisis de piel directamente desde la app?

No es recomendable: cualquier clave embebida en el binario puede ser extraída. Lo correcto es que la app envíe la foto a tu backend y que tu backend haga la llamada con la clave de API.

¿Necesito un SDK móvil para usar MaIA Scan?

No. MaIA Scan se consume como API: envías la foto y recibes un JSON con el perfil de belleza, así que funciona con cualquier stack nativo o híbrido. El SDK de navegador pertenece a MaIA Try-On y está en early access, concedido por cuenta.

¿Tengo que almacenar las fotos de los usuarios?

En la mayoría de los casos no hace falta: basta con guardar el JSON del perfil asociado al usuario. Menos retención de imágenes significa menos riesgo y menos complejidad legal.

¿Qué hago cuando la confianza de un campo es baja?

Trátalo como regla de producto: no muestres ese atributo como afirmación, pide confirmación al usuario o sugiere repetir la foto con mejor luz y sin filtros.

¿El análisis sirve como evaluación dermatológica?

No. El análisis describe atributos visibles en una foto, como tono y subtono, tipo y condición aparente de la piel. No diagnostica, no trata ni reemplaza a un profesional de la salud.

API de bellezaanálisis de pielapp móvilintegracióndesarrollo

← Todos los artículos