AI Reading: Structured reading API
BetaAn 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.
Call it with POST /v1/ai/ai-insight. Input: specific input. Output: JSON, as a direct response. Each successful call costs metered, from 15 credits. It offers 3 options, such as Persona: coach, Persona: pandit and Persona: analyst.
- Endpoint
- POST /v1/ai/ai-insight
- Input
- Specific input
- Output
- JSON
- Delivery
- Direct response
- Cost
- Metered, from 15 credits
- Compute class
- AI
Options
- Persona: coach
- Persona: pandit
- Persona: analyst
Example response
Fields in data (inferred from the example)
mode· stringtext· stringtier· stringpersona· stringas_of· stringgrounding· object
Example response (illustrative)
Written by hand from the documented shape: AI readings are not captured automatically. Real text, token counts and credits differ.
Loading the example…
Request schema and every field: the AI interpretation reference.
AI Reading: Structured reading API: common questions
What does the AI Reading: Structured reading API return?
An 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. The response's data object includes mode, text, tier, persona, as_of and grounding. See the reference for an example response.
What input does AI Reading: Structured reading need?
Specific input. It accepts 3 options, for example Persona: coach, Persona: pandit and Persona: analyst.
How much does a AI Reading: Structured reading call cost?
Metered, from 15 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.
Can I try it before paying?
Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.