Documentation

Build with AscendMe

Everything you need to integrate facial analysis, potential generation, and personalized recommendations into your product.

Quick start API reference

Getting started

Introduction
What AscendMe measures and how the scores are built.
Your first analysis
Upload two photos, run the pipeline, read the report.
Photo guidelines
Lighting, angle, and framing that produce the best results.

Authentication

API keys
Create, rotate, and scope keys for server-side access.
OAuth for users
Let end-users sign in and own their analyses.

Core concepts

Harmony metrics
Harmony, angularity, dimorphism, health signals.
Potential portraits
How the best-version image is generated.
Regional baselines
Why regional context matters for interpretation.

Recipes

Batch scoring
Score a folder of portraits in parallel.
Webhooks
Get notified when a long analysis completes.
Export to PDF
Render a shareable report from a raw analysis.

Your first analysis

The fastest path from zero to a full harmony report. Requires an API key from your dashboard.

1
Create an API key under Settings → Developers.
2
Capture a front-facing and side-profile photo in even, natural light.
3
POST both images (base64 or URL) to /v1/analyze with age, gender, and region.
4
Render the returned harmony, breakdown, strengths, and priorities in your UI.