Documentation
Palm and face readings
AI readings from a photo of a palm or a face. Photos are not stored, and consent is required.
The palmistry and face-reading families read a photo with a vision model. Send the image with each call:
curl https://api.96astroapi.com/v1/palmistry/palm-reading -H "Authorization: Bearer $ASTRO_API_KEY" -H "Content-Type: application/json" -d '{ "image_base64": "...", "mime_type": "image/jpeg", "consent": true, "language": "en" }'| Field | Required | Meaning |
|---|---|---|
image_base64 | Yes | PNG, JPEG or WebP, base64, at most 3.75 MiB decoded |
mime_type | Yes, unless a data: URI | The image's type |
consent | Yes | Must be true: the person in the photo agreed, and is an adult or has a guardian's agreement |
language | No | Language of the reading |
tier | No | fast (default) or balanced |
Choosing a capability
palm-readingandface-readingreturn every section for one model call, so they are the cheaper way to get many sections. Keep the answer and show parts of it.- Single sections such as
palm-major-linesorface-eyesreturn one section for one call. palm-questionanswers one question from a palm.palm-compatibilitytakes two palm photos, inimage_base64andsecond_image_base64.
Each section has observed (what the model saw), reading and advice.
What it costs
These are metered by model cost, as AI readings are, using the vision tier. A photo the model cannot read returns 422 image_not_usable and is not charged.
Privacy and limits
- Photos are not stored. The image goes to the model provider for that one call. Without an
Idempotency-Keythe answer is not stored either. Check your provider's terms and your own legal duties: a face photo is personal data in most countries. - Tell your users it is an AI reading of a photo, get their consent, and do not use it on photos of children without a guardian's agreement.
- The model is told never to identify anyone or infer race, religion, caste, sexuality, disability or age, never to comment on skin colour, and never to diagnose or predict illness.
- These are for reflection, not fact. They must not be used for hiring, lending, insurance, dating decisions about a third party, or any decision about a person.
Compatibility from two palms
palm-compatibility also returns a compatibility object: score (0 to 100), level, headline, element_match, and first_person and second_person, each with love_style, brings and needs. A model judges these from what it can see, so treat the score as a talking point and not as a measurement.
Tracing a palm or a face
palm-lines-image traces the life, head, heart and fate lines, with a confidence for each. face-outline-image outlines the face and its features, and scores how the face looks in that photo: energy, calmness, happiness and approachability. Those scores describe one photo and say nothing about the person's character.
Both return the shapes as points from 0 to 1000 and an overlay_svg. Lay the SVG over your own copy of the photo: it holds only the marks, so we never send a photo back.
What we leave out on purpose
A palm reading never gives a life expectancy, a number of marriages, a chance of divorce or anything about sexual health. No photo can show these, and saying so could do real harm.