Processed Palm Image

POSThttps://vision.astrologyapi.com/palmistry/get-palm-image
Copy

Runs a computer-vision model on an image URL, draws the detected heart, head, life and fate lines on the photo, and returns the overlay image URL with per-line confidence scores. Image validation: accepted formats are JPEG/JPG and PNG. Maximum image size is 5MB (configurable) - larger files are rejected with 400. The image is checked for blurriness; images scoring below are rejected

POST/get-palm-image
Copy
1curl --location 'https://vision.astrologyapi.com/palmistry/get-palm-image' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "palm_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
6}'
7
200Response
Copy
1{
2  "status": true,
3  "message": "success",
4  "data": {
5    "palm_id": "9f1c1234-5678-90ab-cdef-1234567890ab",
6    "overlay_image_url": "https://pub-xxxx.r2.dev/9f1c1234..._processed.png",
7    "original_image_url": "https://sample-image.jpg",
8    "processing_model": "palm-lines-v1.4",
9    "lines_detected": [
10      {
11        "name": "Heart Line",
12        "color": "#FF0000",
13        "present": true,
14        "confidence": 0.82
15      },
16      {
17        "name": "Head Line",
18        "color": "#0000FF",
19        "present": true,
20        "confidence": 0.71
21      },
22      {
23        "name": "Life Line",
24        "color": "#00FF00",
25        "present": true,
26        "confidence": 0.9
27      },
28      {
29        "name": "Fate Line",
30        "color": "#FFFF00",
31        "present": true,
32        "confidence": 0.12
33      }
34    ],
35    "Heart Line Confidence": 0.82,
36    "Head Line Confidence": 0.71,
37    "Life Line Confidence": 0.9,
38    "Fate Line Confidence": 0.12
39  }
40}

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)

palm_id

string

required

Unique palm reading ID returned by get-palm-id

Request Description

Detect and overlay palm lines on a palm photo supplied via URL.

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.