Mask-outline-image | AstrologyAPI Developers

🌍 Astrocartography API and ✋ Palmistry API are now live. Ship them in your app today.Get Started

Mask Outline Image

POSThttps://vision.astrologyapi.com/face-reading/mask-outline-image

Copy

Returns a processed face image URL with mask outline data and detected traits for a previously scanned face.

POST/face-reading/mask-outline-image

Copy

1curl --location 'https://vision.astrologyapi.com/face-reading/mask-outline-image' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "face_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
6}'
7

200Response

Copy

1{
2  "status": true,
3  "message": "success",
4  "data": {
5    "processed_image_url": "https://sample-image.jpg",
6    "traits": {
7      "confidence": {
8        "score": 65,
9        "note": "steady gaze suggests a quiet self assurance"
10      },
11      "energy": {
12        "score": 40,
13        "note": "relaxed posture and neutral expression show low energy"
14      },
15      "calmness": {
16        "score": 85,
17        "note": "very composed and serene facial features"
18      },
19      "happiness": {
20        "score": 30,
21        "note": "neutral mouth with no visible smile"
22      },
23      "approachability": {
24        "score": 60,
25        "note": "soft eyes make the subject seem open"
26      }
27    }
28  }
29}

Request Headers

x-astrologyapi-key

string

required

API Access Token to authenticate requests. Send your access token in this custom header.

Accept-Language

string

Preferred language for the response content

Properties

English - en

Request Body (JSON)

face_id

string

required

Unique face reading ID returned by get-face-id

Request Description

Generate the processed mask outline image for a stored face reading.

Errors

400

Bad Request

Something is wrong with your request format or parameters.

401

Unauthorized

Your API key is missing or invalid.

403

Forbidden

You don't have permission to access this specific resource.

404

Not Found

The API endpoint you're trying to reach doesn't exist.

500

Internal Server Error

Our server is having a temporary glitch.

POST/face-reading/mask-outline-image

Copy

1curl --location 'https://vision.astrologyapi.com/face-reading/mask-outline-image' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "face_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
6}'
7

200Response

Copy

1{
2  "status": true,
3  "message": "success",
4  "data": {
5    "processed_image_url": "https://sample-image.jpg",
6    "traits": {
7      "confidence": {
8        "score": 65,
9        "note": "steady gaze suggests a quiet self assurance"
10      },
11      "energy": {
12        "score": 40,
13        "note": "relaxed posture and neutral expression show low energy"
14      },
15      "calmness": {
16        "score": 85,
17        "note": "very composed and serene facial features"
18      },
19      "happiness": {
20        "score": 30,
21        "note": "neutral mouth with no visible smile"
22      },
23      "approachability": {
24        "score": 60,
25        "note": "soft eyes make the subject seem open"
26      }
27    }
28  }
29}