Skip to content

Concepts

This section is the visual counterpart to the OpenAPI reference. The reference tells you the field names; concept pages tell you what those fields mean — clinically, visually, and as data on a face.

Every concept page follows the same shape:

  1. Overview — definition in beauty / dermatology terms.
  2. Machine-readable summary — one fenced YAML block with request, response path, value range, related components.
  3. Reference imagery — real face with the metric’s mask or feature overlay applied, where imagery is available.
  4. Rendering notes — how to turn data into a UI affordance.
  5. Edge cases and local_warnings[] — known footguns and the metric-specific status codes.