Appearance scoring (predict)#

Endpoint#

• Method: POST
• URL: https://synerunify.com/api/process/appearance/predict
• Content-Type: multipart/form-data
• Field: image (required; image file; use a real image MIME such as image/jpeg)
• Query: Omit; server defaults apply.

Response JSON#

Top level:

• code: 200 means success
• message: human-readable status text
• data: present on success; may be incomplete on failure

Inside data:

• count: number of scored faces

• size: { "width", "height" } of the original image in pixels

• faces: array of items with:

  • region: { x1, y1, x2, y2, width, height } in original-image pixels
  • score: float; you may round for display

On errors or no faces, read message; data.faces may be empty.

Examples#

curl

bash

curl -sS -X POST "https://synerunify.com/api/process/appearance/predict" \
  -F "image=@/path/to/photo.jpg"

Python

python

import requests

url = "https://synerunify.com/api/process/appearance/predict"
with open("photo.jpg", "rb") as f:
    r = requests.post(url, files={"image": ("photo.jpg", f, "image/jpeg")}, timeout=120)
r.raise_for_status()
payload = r.json()
if payload.get("code") != 200:
    raise RuntimeError(payload.get("message", "API error"))
faces = payload["data"]["faces"]
scores = [round(f["score"]) for f in sorted(faces, key=lambda x: x["region"]["x1"])]

Agent rules#

1. Upload only via multipart field image; do not append query params; do not switch to JSON/Base64 unless the API docs explicitly say so.
2. When multiple faces are present, sort by region.x1 (left-to-right) before reporting scores.
3. On failure, surface message and the HTTP status first.