AI Reading: Custom lens API
BetaAn 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.
Call it with POST /v1/ai/ai-lens. 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-lens
- 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· stringlens· 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: Custom lens API: common questions
What does the AI Reading: Custom lens API return?
An 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. The response's data object includes mode, lens, text, tier, persona, as_of and grounding. See the reference for an example response.
What input does AI Reading: Custom lens need?
Specific input. It accepts 3 options, for example Persona: coach, Persona: pandit and Persona: analyst.
How much does a AI Reading: Custom lens 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.