AI Query

Natural-language astrology answers, grounded in a real computed chart — the flagship Vedika endpoint.

AI Query answers natural-language questions grounded in a computed birth chart. Ask in plain language, in any of 14 languages; the response is a source-consistent reading plus a full token and cost breakdown. It is multi-turn, tiered for cost vs latency, and streams token-by-token for chat UIs.

#Endpoint

POST /api/v1/astrology/query: The reading endpoint. Base https://api.vedika.io. Alias: POST /api/query.
GET /api/v1/astrology/query/stream: The streaming variant — same inputs, tokens as they are produced. See Streaming.

Authenticate with your API key on either header — x-api-key or Authorization: Bearer.

#A first call

curl -s https://api.vedika.io/api/v1/astrology/query \
  -H "x-api-key: $VEDIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "When will my career take off?",
    "birthDetails": {
      "datetime": "1990-05-15T10:30:00",
      "latitude": 28.6139, "longitude": 77.2090,
      "timezone": "Asia/Kolkata"
    }
  }'

import os, requests
r = requests.post("https://api.vedika.io/api/v1/astrology/query",
    headers={"x-api-key": os.environ["VEDIKA_KEY"]},
    json={"question": "When will my career take off?",
          "birthDetails": {"datetime": "1990-05-15T10:30:00",
                            "latitude": 28.6139, "longitude": 77.2090,
                            "timezone": "Asia/Kolkata"}},
    timeout=180)
print(r.json()["answer"])

#What makes it different

GroundedEvery reading is consistent with the computed chart returned alongside it.Multi-turnA stable conversationId carries context and reconciles stated facts.Parametersspeed, version, responseFormat, language and more — one payload.Transparent costExact USD charged and token usage returned in metadata on every call.

Note

14 languages are supported: English, Hindi, Bengali, Tamil, Telugu, Kannada, Malayalam, Marathi, Gujarati, Punjabi, Nepali, Odia, Assamese and Urdu. Omit language for English; the engine also auto-detects the question's language.