By topic / Palm Reading API
Palm Reading API: a reading from one photo
Send one photo. A vision model reports what it can see, and bases its reading on that. You can ask for one section, the whole reading, a question of your own, or compatibility from two palms. The person in the photo must have agreed, and we do not store it.
What people build with it
- A palm reading feature in an astrology app
- A printable palm report
- Couple compatibility
The endpoints
- Whole Palm Reading
Every section of a palm reading from one photo, for the price of one call: hand type, fingers, lines, mounts and life themes.
POST /v1/palmistry/palm-reading
Metered, from 15 credits
- Palm: Major Lines
The life, head, heart and fate lines. Read from one photo of the palm by a vision model; the photo is not stored.
POST /v1/palmistry/palm-major-lines
Metered, from 15 credits
- Palm: Ask a Question
One question of your own, up to 300 characters, answered from a photo of the palm, with the full reading it draws on.
POST /v1/palmistry/palm-question
Metered, from 15 credits
- Palm Compatibility
How two people connect, how their lives fit and what guidance follows, from a photo of each palm.
POST /v1/palmistry/palm-compatibility
Metered, from 15 credits
- Palm: Lines Traced
The life, head, heart and fate lines traced on a photo of the palm, with confidence for each, and an SVG overlay to lay over your copy. The photo is not stored or sent back.
POST /v1/palmistry/palm-lines-image
Metered, from 15 credits
Common questions
- Do you keep the photo?
- No. It is passed to the model and not stored. To get a PDF, send us the reading you already have.
- Does it predict illness or how long someone will live?
- No, on purpose. No photo can show these, and saying so could do real harm.