Documentation
Add a palm reading to your app
Take a good photo, get the person's agreement, handle photos that cannot be read, and show the reading and its traced lines.
A reading is only as good as the photo. Most of the work in this feature is in the capture screen.
Ask for agreement
Whoever is in the photo must agree, and the request must say so with "consent": true. Put a clear line in your app, and do not make it a hidden default. For a child, get a guardian's agreement.
Take a good photo
Tell people:
- Open hand, palm flat and facing the camera, with the fingers slightly apart.
- Bright, even light, without shadows across the palm.
- The whole palm in the frame, and in focus.
Make the image smaller before you send it. The limit is 3.75 MB, and about 1,600 pixels on the long side is plenty.
Make the call
curl https://api.96astroapi.com/v1/palmistry/palm-major-lines \
-H "Authorization: Bearer $ASTRO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "image_base64": "...", "mime_type": "image/jpeg", "consent": true, "tier": "fast" }'Each section has observed (what the model can see), reading and advice. Show observed too, as it lets people judge the reading for themselves.
Send "language": "hi" for Hindi, and likewise for the other languages. The notice in the answer says that a reading is for reflection. Show it.
Handle a bad photo
If the photo cannot be read, the answer is 422 image_not_usable, with a message saying what is wrong and how to retake it. You are not charged. Show that message and go back to the camera.
Show the lines
palm-lines-image traces the life, head, heart and fate lines. Lay its overlay_svg on top of the photo the user just took, stretched to the same size. It holds only the marks, because we never send a photo back.
Offer a PDF
We do not keep the photo, so send the reading you already have:
{ "capability": "palm-reading", "input": {}, "reading": { "sections": { } } }See A PDF of a palm or face reading.
What it will not do
It never gives a life expectancy, a number of marriages, a chance of divorce or a diagnosis. We recommend that you do not add these yourself. See Palm and face readings.