By topic / AI Astrology API
Reports and media
AI Astrology API: readings and chat grounded in a computed chart
A language model on its own guesses at planetary positions. These endpoints compute the chart first and give the model the computed data, so the reading or the answer to a question refers to placements that are actually in the chart. Choose a persona, a depth and a language, and keep earlier turns as chat history.
Ideas
What people build with it
An AI astrologer chat in your app
A written reading after a kundli is generated
Couple questions on a matrimony profile
Reference
The endpoints
- AI Reading: Structured readingAn AI-written reading of a birth chart, grounded in chart data the service computes from the birth (or in one report named in `context`); choose persona, tier and language. Optional JSON output.POST/v1/ai/ai-insight Metered, from 15 credits
- AI Reading: Chat answerAn AI answer to a question about a birth chart, with earlier turns as history; grounded in chart data the service computes from the birth (or in one report named in `context`).POST/v1/ai/ai-chat Metered, from 15 credits
- AI Reading: Custom lensAn AI-written reading of a birth chart through one lens (career, marriage, wealth, health, spiritual or year ahead), grounded in chart data the service computes from the birth.POST/v1/ai/ai-lens Metered, from 15 credits
- AI Reading: General questionAn AI answer to a general astrology question, grounded in chart data the service computes from the birth (or in one report named in `context`); choose persona, tier and language.POST/v1/ai/ai-general Metered, from 15 credits
- AI Chat for a CoupleAn AI answer about two people, with earlier turns as history; grounded in their computed matching report.POST/v1/ai/ai-match-chat Metered, from 15 credits
- AI Chat, WesternAn AI answer about a birth chart in the tropical tradition, with earlier turns as history; grounded in the computed Western report.POST/v1/ai/ai-western-chat Metered, from 15 credits
FAQ
Common questions
Does the AI calculate the chart?
No. The service computes the chart with the same engine as the chart endpoints, then passes that data to the model to explain.
How is AI priced?
AI readings are metered by the length of the answer, with a minimum per call. The pricing page shows the current rates.
Can I use my own model instead?
Yes. Call the chart endpoints and pass the JSON to your model. The LLM grounding guide shows how.
Guides
Read next
Start building with the AI Astrology API
5,000 free trial credits. No card required.

