AI Reports

AI Transit Narrative (single date)

Snapshot transit interpretation for a specific date. Inputs: chart + transitDate (+optional transitTime/tzOffset), language, tone, length. Returns narrative grounded in transit-to-natal aspects (orb ≤1°).

post/reports/ai/transit-narrative

Headers

X-Provider'openai' | 'anthropic' | 'google' | 'groq' | 'mistral' | 'openrouter' | 'deepseek' | 'together'

Bring your own model key: the LLM provider that should run this completion. Send together with X-Provider-Key or the request is refused: a key with no provider bills us for tokens you meant to pay for, and a provider with no key would look like it worked. The endpoint is fixed per provider on our side and is never taken from the request. There is no fallback to our own chain: if your key fails you get the provider's status and message.

X-Provider-Keystring

Your own credential for X-Provider. Never logged, stored or cached: it travels in a header because the request body is hashed into two cache keys, and a BYOK turn bypasses both caches in each direction. A provider error that quotes the key back is redacted before it reaches our logs or your response. Such a turn costs 5 credits instead of the endpoint price, and only when a completion actually ran on your key.

X-Provider-Modelstring

Optional model id, overriding the default for that provider. Defaults: openai → gpt-4o-mini, anthropic → claude-sonnet-4-5, google → gemini-2.5-flash, groq → llama-3.3-70b-versatile, mistral → mistral-large-latest, openrouter → meta-llama/llama-3.3-70b-instruct, deepseek → deepseek-chat, together → meta-llama/Llama-3.3-70B-Instruct-Turbo.

Request body

datestring
timestring
timezoneOffsetnumber nullable

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

ayanamsaIdnumber nullable
ayanamsa'fagan-bradley' | 'lahiri' | 'de-luce' | 'raman' | 'krishnamurti' | 'kp' | 'yukteshwar' | 'jn-bhasin' | 'true-citra' | 'djwhal-khul'

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}

Changes

Changed in 2 of the 13 revisions of this API.27

    • added the new optional request property ayanamsa

      new-optional-request-property

    • the request property ayanamsaId became nullable

      request-property-became-nullable

  • e637d1a9911b25See the full diff
    • the timezoneOffset request property's max was set to 14.00

      request-property-max-set

    • the timezoneOffset request property's min was set to -14.00

      request-property-min-set

    • added the new optional header request parameter X-Provider

      new-optional-request-parameter

    • added the new optional header request parameter X-Provider-Key

      new-optional-request-parameter

    • added the new optional header request parameter X-Provider-Model

      new-optional-request-parameter

    • the request property timezoneOffset became nullable

      request-property-became-nullable

    • the timezoneOffset request property default value 0 was added

      request-property-default-value-added