Developer API · v1

The AscendMe API

Bring science-backed facial analysis into your app. One endpoint uploads a photo, returns harmony metrics, and generates a realistic potential portrait.

Read the docs Request access

Sub-second inference

Landmark detection, harmony scoring, and breakdown in a single call — typically under 900 ms.

Private by default

Images processed in-memory, never resold. Bring-your-own storage supported.

Typed responses

Deterministic JSON schema. TypeScript, Python, and OpenAPI clients.

Quick start

A single POST returns a full analysis object.

POST https://api.ascendme.site/v1/analyze

bash

curl https://api.ascendme.site/v1/analyze \
  -H "Authorization: Bearer $ASCEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "front_image": "data:image/jpeg;base64,…",
    "side_image":  "data:image/jpeg;base64,…",
    "age": 25,
    "gender": "male",
    "region": "south_asia"
  }'

Endpoints

POST/v1/analyzeFull facial harmony analysis from front + side photo.

POST/v1/potentialGenerate a realistic best-version portrait.

GET/v1/analysesList past analyses for the authenticated user.

GET/v1/analyses/:idRetrieve a single analysis by id.