Migrate to Vedika
Moving from another astrology or LLM API? Map your integration onto Vedika concept by concept.
Moving to Vedika from another astrology or LLM API? The core concepts map over directly. This page is a concept-by-concept guide for porting an existing integration — swap a handful of names, add one required field, and you are calling Vedika.
#Concept mapping
If your current provider exposes an OpenAI-shaped chat/completions endpoint (or something similar), the table below is the direct translation. OpenAI is named here only as the external wire-format standard being mapped from — not a claim about what powers Vedika; Vedika's own tiers use masked product-tier names only, as everywhere else in these docs.
| Your current provider | Vedika |
|---|---|
| Chat / completion endpoint | POST https://api.vedika.io/api/v1/astrology/query with question + birthDetails |
| API key header | x-api-key or Authorization: Bearer |
| Model name | A masked delivery tier via speed ("eco" / "standard" / "fast") plus version ("2" / "2.5") |
| Streaming | GET https://api.vedika.io/api/v1/astrology/query/stream |
| JSON / structured output | responseFormat ("text" / "markdown" / "json") |
#Migration steps
- Get a key
Create a Vedika API key from the dashboard — see API Keys.
- Swap the base URL and auth header
curl -s https://api.vedika.io/api/v1/astrology/query \ -H "x-api-key: $VEDIKA_KEY" - Add birthDetails to every request
Vedika requests carry a
birthDetailsobject alongside the question — see Key differences below for why. - Map your model selection to a tier
Replace a model-name field with
speed(and, optionally,version) as shown in the mapping table above. - Test in the sandbox first
Point the same request shape at the keyless mock sandbox before switching in a live key — no charge, no key required.
#Key differences
The one structural difference: Vedika grounds every answer in a computed birth chart, so a request carries birthDetails, not just a prompt. The chart comes back on the response too, as birthChart, so you and your users can see what the answer is grounded in. See AI Query for the full request/response contract.
chat/completions client works against Vedika with little more than a base-URL change — is on the roadmap but not built yet. See OpenAI Compatibility. Until it ships, migrate through the native endpoint above.