Skin

Clear, even, smooth facial skin with a healthy finish.

ImageFaceskinVersion 1

Judges the condition of visible facial skin: clarity, evenness, texture, and finish. Skin color, ethnicity, and apparent age are never factors; condition is the only thing scored.

What it looks for

Clarity: no breakouts, blemishes, or scarring
Evenness: no blotches or patchy redness
Fine, smooth texture across the cheeks and forehead
A healthy finish rather than dull, rough, or greasy

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":"skin","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: "skin", image }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);

const { mogs, noul } = data.results.skin;
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": "skin", "image": image},
    timeout=60,
)
data = res.json()
if not res.ok:
    raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")

result = data["results"]["skin"]
print(result["mogs"], result["noul"])

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

Response

{
  "results": {
    "skin": {
      "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.

Comtesse d'Haussonville by Ingres, 1845
MOGS
Jean-Auguste-Dominique Ingres (detail). Public domain. Wikimedia Commons
Rudolph Valentino, 1919
MOGS
Unknown photographer (1919). Public domain. Wikimedia Commons
Abraham Lincoln, 1863
MOGS
Alexander Gardner. Library of Congress. 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

Skin

Imageskin

Clear, even, smooth facial skin with a healthy finish.

Examples

Pre-computed, free

Scores one image, with optional text as context.

Detail of an Ingres portrait: a woman with center-parted brown hair and a red ribbon, chin resting on her hand

Comtesse d'Haussonville by Ingres, 1845

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

Comtesse d'Haussonville by Ingres, 1845, scored when the example was added. No request was sent.

POST /api/v1/mog

{
  "formula": "skin",
  "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": {
    "skin": {
      "mogs": true,
      "noul": 0.9596,
      "version": 1
    }
  }
}

Skin

What it looks for

Input

Examples

Comtesse d'Haussonville by Ingres, 1845

Rudolph Valentino, 1919

Abraham Lincoln, 1863

Try it