Overall Face

The whole face, judged at once: structure, proportion, and harmony.

ImageFaceoverall-faceVersion 1

One holistic judgment of a face: bone structure, proportion, symmetry, and how well the features work together. Use it when a single number is the point.

What it looks for

Strong, balanced bone structure
Features and facial thirds in proportion
Symmetry between the left and right sides
Features that work together as a whole

Input

Send one image as a base64 data URL in image: PNG, JPEG, or WebP, at most 3 MiB (3,145,728 bytes) decoded. Text is optional context. A request with an image costs 10 units however many image formulas it names, so batch this one with others such as Jawline and Canthal Tilt, up to 8 per request.

The call returns noul, the probability from 0 to 1 that the answer is yes, and mogs, the verdict. The pass/fail boundary is set on the server and never returned. Use mogs as the decision and noul to rank.

POST /api/v1/mog

# Build the body in a file: a base64 image is too long for a shell argument.
# For a PNG or WebP file, change image/jpeg to image/png or image/webp.
{
  printf '{"formula":"overall-face","image":"data:image/jpeg;base64,'
  base64 < photo.jpg | tr -d '\n'
  printf '"}'
} > body.json

curl https://mogger.dev/api/v1/mog \
  -H "Authorization: Bearer $MOGGER_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @body.json

// Node 18 or later, as an ES module (mog.mjs). Use image/png or image/webp for other file types.
import { readFile } from "node:fs/promises";

const image = "data:image/jpeg;base64," + (await readFile("photo.jpg")).toString("base64");

const res = await fetch("https://mogger.dev/api/v1/mog", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MOGGER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ formula: "overall-face", image }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);

const { mogs, noul } = data.results["overall-face"];
console.log(mogs, noul);

import base64
import os

import requests

with open("photo.jpg", "rb") as f:
    image = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode("ascii")

res = requests.post(
    "https://mogger.dev/api/v1/mog",
    headers={"Authorization": f"Bearer {os.environ['MOGGER_API_KEY']}"},
    json={"formula": "overall-face", "image": image},
    timeout=60,
)
data = res.json()
if not res.ok:
    raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")

result = data["results"]["overall-face"]
print(result["mogs"], result["noul"])

# With the mogger skill installed, ask in plain words, for example:
#   Does ./photo.jpg mog on overall-face?
# The skill base64-encodes the file in the shell, so the image
# never enters the model context, and runs:
score_image ./photo.jpg overall-face | jq '.results'

Response

{
  "results": {
    "overall-face": {
      "mogs": true,
      "noul": 0.91,
      "version": 1
    }
  },
  "cost": 10,
  "quota": {
    "remaining": 990,
    "budget": 1000
  },
  "request_id": "req_0MHmB7xKQ2c9tVwLp4ZsYd3R"
}

Example values. Keys are invite only: see Authentication.

Examples

Scored ahead of time with version 1. Each verdict uses the pass/fail boundary in force now.

Michelangelo's David, plaster cast
MOGS
Michelangelo (sculptor). Plaster cast, Statens Museum for Kunst. Public domain. Wikimedia Commons
Augustus, Bevilacqua bust
MOGS
Unknown Roman sculptor. Photo: Bibi Saint-Pol (2007). Public domain. Wikimedia Commons
Socrates, plaster cast
MOGS
Unknown artist. Plaster cast, Statens Museum for Kunst. Public domain. Wikimedia Commons

Try it

Scored examples show their result at once. Your own image needs an API key and spends 10 units per run.

Formula

Overall Face

Imageoverall-face

The whole face, judged at once: structure, proportion, and harmony.

Examples

Pre-computed, free

Scores one image, with optional text as context.

Plaster cast of the head of Michelangelo's David, three-quarter view facing right, on a black background

Michelangelo's David, plaster cast

Encoding

Example image

Any image your browser can open. Resized to 1024 px on the long side and sent as JPEG.

API keyGet a key

Kept in this browser tab only, never sent anywhere but the API.

Costs 10 units

Paste an API key to score your own input. Examples above are free.

Result

Pre-computed

MOGS

Michelangelo's David, plaster cast, scored when the example was added. No request was sent.

POST /api/v1/mog

{
  "formula": "overall-face",
  "image": "data:image/jpeg;base64,… encoding"
}

Response

no request

Pre-computed when the example was added. A live call returns the same results object plus cost, quota, and request_id.

{
  "results": {
    "overall-face": {
      "mogs": true,
      "noul": 0.8716,
      "version": 1
    }
  }
}

Overall Face

What it looks for

Input

Examples

Michelangelo's David, plaster cast

Augustus, Bevilacqua bust

Socrates, plaster cast

Try it