\r \r

Appearance scoring (predict)\r

\r

Endpoint\r

\r

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

Response JSON\r

\r Top level:\r \r

• code: 200 means success\r
• message: human-readable status text\r
• data: present on success; may be incomplete on failure\r \r Inside data:\r \r
• count: number of scored faces\r
• size: { "width", "height" } of the original image in pixels\r
• faces: array of items with:\r
  • region: { x1, y1, x2, y2, width, height } in original-image pixels\r
  • score: float; you may round for display\r \r On errors or no faces, read message; data.faces may be empty.\r \r

Examples\r

\r curl\r \r

curl -sS -X POST "https://synerunify.com/api/process/appearance/predict" \\r
  -F "image=@/path/to/photo.jpg"\r
```\r
\r
**Python**\r
\r
```python\r
import requests\r
\r
url = "https://synerunify.com/api/process/appearance/predict"\r
with open("photo.jpg", "rb") as f:\r
    r = requests.post(url, files={"image": ("photo.jpg", f, "image/jpeg")}, timeout=120)\r
r.raise_for_status()\r
payload = r.json()\r
if payload.get("code") != 200:\r
    raise RuntimeError(payload.get("message", "API error"))\r
faces = payload["data"]["faces"]\r
scores = [round(f["score"]) for f in sorted(faces, key=lambda x: x["region"]["x1"])]\r
```\r
\r
## Agent rules\r
\r
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.\r
2. When multiple faces are present, sort by `region.x1` (left-to-right) before reporting scores.\r
3. On failure, surface `message` and the HTTP status first.\r