← All endpoints / AI Narrative Layer

AI Chat (BYOLLM)

GET/api/v1/ai/chat
GEThttps://vedintelastroapi.com/api/v1/ai/chat

Streaming conversational AI astrologer. Uses whichever AI provider you've marked Default on your AI Providers page. Draws one call from your regular monthly balance — no separate AI quota. Streams Server-Sent Events (text/event-stream): data: {"token":"…"} events, then data: [DONE]. For multi-turn conversations POST the same fields as JSON with a history array (api_key in the body, the X-API-Key header or ?api_key=). Stateless: no chat_id is created or returned; keep the conversation on your side and resend it as history. /ai/chats/{chat_id} is only for assistants you create in the dashboard.

Requires a paid plan (Developer or above).

Parameters

NameInRequiredTypeDescription
api_keyqueryYesstringYour VedIntel™ AstroAPI key. Get one at https://vedintelastroapi.com/auth/signupe.g. vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
dobqueryYesstringDate of birth in DD/MM/YYYY formate.g. 01/10/1977
tobqueryYesstringTime of birth in HH:MM (24-hour) formate.g. 11:40
latqueryYesnumberBirth latitude with decimalse.g. 11
lonqueryYesnumberBirth longitude with decimalse.g. 77
tzqueryYesnumberTimezone offset from UTC. IST = 5.5e.g. 5.5
langqueryNostring
en | hi | ta | te | sa | kn | ml | bn …
default: en
Response language code. Use "auto" to detect from tz+lat.
ayanamsaqueryNostring
lahiri | raman | kp
default: lahiri
Ayanamsa system
qqueryYesstringThe user question (max 600 characters).e.g. When does my current antardasha end?
typequeryNostringvedic (default) | western | tarot

Example Request

curl -X GET "https://vedintelastroapi.com/api/v1/ai/chat?api_key=vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&dob=01%2F10%2F1977&tob=11%3A40&lat=11&lon=77&tz=5.5&lang=en&ayanamsa=lahiri&q=When%20does%20my%20current%20antardasha%20end%3F&type=VALUE" \
  -H "X-API-Key: YOUR_API_KEY"
← Back to all endpointsInteractive Docs
Get a free API key →