---
title: AI Agent Face Analysis API
description: Connect AI agents to iLook's structured face analysis API with OpenAPI, MCP, A2A, llms.txt, face shape, face score, Golden Ratio phi score, and stable JSON errors.
doc_version: "1.5"
last_updated: "2026-08-18"
canonical: "https://www.ilook.fit/ai-agent-face-analysis-api"
---

# AI Agent Face Analysis API

iLook gives AI agents a direct integration surface for consent-gated adult face analysis. Agents can use REST, MCP, A2A, OpenAPI, Markdown mirrors, and llms.txt instead of scraping the human scanner.

## What agents receive

- Descriptive `face_shape` context.
- `overall_score_100` and five visible subscores.
- One-line `score_explanations` for facial harmony, symmetry, jawline and structure, skin appearance, and eyes and brows.
- A separate Golden Ratio `phi_score` using φ ≈ 1.618.
- Focused `measurements` for face shape detector, jawline rating, canthal tilt, eye shape, adult face age cues, facial symmetry, Golden Ratio face, attractiveness test, PSL score, facial ratios, color analysis, skin analysis, and hairstyle finder. Each uses `score`, `label`, `analysis`, and tool-specific `details` rows.
- Stable error codes for invalid image, no face, multiple faces, possible minor, unsupported content, quota, invalid key, timeout, and temporary service failure.

## Stable measurement rows

- `face_shape_detector`: Primary Shape, Runner-Up Shape, Length-to-Width Cue, Widest Area, Jawline Curve, Styling Direction.
- `jawline_rating`: Left Estimate, Average, Right Estimate, Front-Photo Jaw Angle, Symmetry, Visible Jaw Width, Visible Lower Face.
- `canthal_tilt`: Left Eye Tilt, Right Eye Tilt, Average Tilt, Left/Right Difference, Category.
- `eye_shape`: Opening Shape, Corner Orientation, Eye Framing, Styling Ideas, Brow Notes.
- `face_age_cues`: Perceived Age, Age Range, Top Factors.
- `facial_symmetry`: Overall Symmetry Score, Eye Symmetry, Eyebrow Symmetry, Nose Symmetry, Mouth Symmetry, Jaw Symmetry, Straight-On Photo Check, Feature-Level Proof.
- `golden_ratio_face`: Golden Ratio Score, Face Length-to-Width, Facial Thirds, Facial Fifths, Phi Reference, Photo Limitation.
- `attractiveness_test`: Overall Score, Symmetry, Facial Thirds Balance, Facial Fifths Balance, Golden Ratio, Jawline Measurement, Face Shape Measurement.
- `psl_score`: PSL-Style Range, Geometry Score, Symmetry, Visible Thirds, Facial Fifths, Golden-Ratio Proximity, Conversion Basis.
- `facial_ratios`: FWHR-Style Upper-Face Ratio, Visible Face Length-to-Width Ratio, Jaw-to-Cheekbone Width Ratio, Pupil-Distance-to-Face-Width Ratio, Eye Spacing Ratio, Average Canthal Tilt, Midface Height Share, Lower-Face Height Share, Mouth-to-Face Width Ratio, Nose-to-Mouth Width Ratio, Nose-Length-to-Face-Height Ratio, Lip-Height-to-Mouth-Width Ratio.
- `color_analysis`: Season Verdict, Runner-Up Season, Palette Temperature, Value, Chroma, Contrast, Sample Colors, Lighting Caveat.
- `skin_analysis`: Texture Evenness, Tone Evenness, Apparent Hydration, Shine, Visible Photoaging Signs, What's Working, Focus Areas, Lighting Caveat.
- `hairstyle_finder`: Face Shape, Best Overall Direction, Recommended Hairstyles, Beard/Framing Notes, Styles to Use Carefully.

## Discovery links

- [OpenAPI specification](https://www.ilook.fit/openapi.json)
- [API documentation](https://www.ilook.fit/api/docs)
- [MCP server card](https://www.ilook.fit/.well-known/mcp/server-card.json)
- [A2A agent card](https://www.ilook.fit/.well-known/agent-card.json)
- [Agent Skills index](https://www.ilook.fit/.well-known/agent-skills/index.json)
- [llms.txt](https://www.ilook.fit/llms.txt)

## Responsible use

Use iLook for profile-photo feedback, style workflows, onboarding helpers, image-quality coaching, and structured demos where the user explicitly supplies an authorized adult image. Do not use it for identity recognition, sensitive-trait inference, age verification, medical claims, or high-impact decisions.