iLook Face Analysis MCP
Herramientas de análisis facial por IA autorizadas para adultos: forma del rostro, simetría, puntuación phi y retroalimentación de apariencia, mediante MCP HTTP transmisible.
Documentación
iLook API v1
Envía una imagen autorizada de un adulto a POST /api/v1/score como multipart/form-data.
Para un informe de herramienta gratuita individual, usa POST /api/v1/tools/{tool} con una clave de herramienta compatible concreta, como jawline_rating o golden_ratio_face. El servidor MCP también expone herramientas enfocadas con nombre junto a score_face.
Campos obligatorios
image: JPEG, PNG o WebP, máximo 5 MB.adult_and_authorized=true: declaración de adulto y uso lícito.- Las claves de agente emitidas se autentican con
Authorization: Bearer <api-key>.
Respuesta
La API devuelve un id de análisis, versión de la rúbrica, modelo, puntuación general sobre 100, cinco subpuntuaciones visibles, contexto de forma facial, una puntuación phi de Proporción Áurea de 0 a 100, explicaciones de una línea, resumen, confianza y un aviso de seguridad.
iLook API frente a APIs de visión por computadora de propósito general
iLook es una API de retroalimentación de apariencia creada con un propósito específico. Las APIs de visión por computadora de propósito general pueden admitir tareas amplias de imagen; iLook, en cambio, devuelve una tarjeta de puntuación pequeña y versionada con límites explícitos y no ofrece reconocimiento de identidad, coincidencia biométrica, resultados médicos ni inferencia de rasgos sensibles. Usa iLook para retroalimentación de fotos de perfil con consentimiento, flujos de estilismo, entrenamiento de calidad de imagen y demostraciones de agentes.
Ejemplos de implementación
Flujo REST en Python
Usa una solicitud multipart a https://www.ilook.fit/api/v1/score con Authorization: Bearer <api-key>, adult_and_authorized=true y una imagen JPEG, PNG o WebP de no más de 5 MB. Mantén la imagen de origen en memoria solo para la solicitud. Si conservas un resultado posterior permitido, almacena analysis_id, rubric_version y los campos resultantes; nunca los bytes de la imagen en registros, trazas o cargas de cola.
Flujo MCP
Inicializa POST /mcp, lista las herramientas y luego llama a score_face con image_base64, mime_type, adult_and_authorized: true y un measurement_key enfocado opcional. Usa herramientas enfocadas con nombre cuando solo se necesite una salida. No coloques bytes de imagen en base64 en indicaciones, registros, cargas de cola o trazas.
measurements devuelve los bloques de informe de herramienta gratuita. Cada bloque usa score, label, analysis y filas estables de details.
Filas de medición estables
face_shape_detector: Forma primaria, coincidencia primaria, forma secundaria, coincidencia secundaria, indicio de largo a ancho, área más ancha, curva de la línea mandibular, dirección de estilismo.jawline_rating: Estimación izquierda, promedio, estimación derecha, ángulo mandibular en foto frontal, definición, conicidad, simetría, ancho mandibular visible, parte inferior del rostro visible.canthal_tilt: Inclinación del ojo izquierdo, inclinación del ojo derecho, inclinación promedio, diferencia izquierda/derecha, categoría.eye_shape: Forma de apertura, proporción de apertura, separación ocular, estimación de color de ojos, orientación de comisuras, simetría bucal, encuadre ocular, ideas de estilismo, notas de cejas.face_age_cues: Presentación de la foto, dirección de presentación, factores principales.facial_symmetry: Puntuación general de simetría, simetría ocular, simetría de cejas, simetría nasal, simetría bucal, simetría mandibular, verificación de foto frontal, prueba a nivel de rasgos.golden_ratio_face: Puntuación de Proporción Áurea, largo a ancho facial, tercios faciales, quintos faciales.attractiveness_test: Puntuación general, simetría, equilibrio de tercios faciales, equilibrio de quintos faciales, Proporción Áurea, medición de línea mandibular, medición de forma facial.psl_score: Rango estilo PSL, puntuación geométrica, simetría, tercios visibles, quintos faciales, proximidad a la Proporción Áurea, base de conversión.facial_ratios: Proporción facial superior estilo FWHR, proporción visible de largo a ancho facial, proporción de ancho mandibular a pómulos, proporción de distancia pupilar a ancho facial, proporción de separación ocular, inclinación cantal promedio, participación de altura del tercio medio, participación de altura del tercio inferior, proporción de ancho bucal a ancho facial, proporción de ancho nasal a ancho bucal, proporción de largo nasal a altura facial, proporción de altura labial a ancho bucal.color_analysis: Veredicto de temporada, temporada secundaria, temperatura de paleta, valor, croma, contraste, colores de muestra, advertencia de iluminación.skin_analysis: Uniformidad de textura, uniformidad de tono, hidratación aparente, brillo, signos visibles de fotoenvejecimiento, lo que funciona, áreas de enfoque, advertencia de iluminación.hairstyle_finder: Forma facial, mejor dirección general, peinados recomendados, notas de barba/encuadre, estilos a usar con precaución.