← AI Astrologer engine/AI Astrologer
POST/v1/chat/respond/stream

Chat · Respond · Stream API

Streaming variant — Server-Sent Events of LLM tokens.

Get free API keyTry in playgroundFull schema in docs ↗

About the engine

Part of the AI Astrologer engine

A conversational layer over the astrology engine. Every response is anchored in a deterministic chart context — not a generic chatbot — and gated by a defense-in-depth safety layer that intercepts medical, financial, and self-harm prompts. Multi-turn memory keyed on caller-owned conversation_id; tone + confidence labels; a structured `practices` array on every reply. Streaming variant available for token-by-token UI.

Request

Try it from the command line

curl -X POST https://api.astronode.dev/v1/chat/respond/stream \
  -H 'Authorization: Bearer aie_test_YOUR_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{ "comment": "see /docs for the request schema for this endpoint" }'

All AstroNode endpoints require a bearer token from your dashboard. Test keys (`aie_test_*`) are free up to 100 calls/month.

Response

What you get back

Every AstroNode response uses the same envelope:request_id,data (the endpoint-specific payload),interpretation (optional narrative block), andmeta (engine version + computed_at timestamp). The exact data schema for POST /v1/chat/respond/stream is published in the OpenAPI 3.1 spec under /docs.

Engine highlights

What the AI Astrologer engine ships

  • Bounded reasoning — every reply grounded in the user's deterministic chart context
  • Multi-turn memory keyed on caller-owned `conversation_id`
  • Defense-in-depth safety layer on input + output (medical / financial / self-harm)
  • Structured `practices` array on every response (planet, kind, summary)
  • Tone (supportive | reflective | grounded | calm | neutral) and confidence (low | moderate | high) labels
  • Optional `partner` block triggers compatibility-aware reasoning
  • Strict JSON-schema response enforcement on Gemini + Groq + OpenAI providers
  • Streaming variant for token-by-token UI
  • Conversation history endpoints for resume + per-user transcripts

Related endpoints

Other AI Astrologer endpoints

POST/v1/chat/respond

Generate an emotionally intelligent, astrology-grounded response.

GET/v1/conversations

List past chat conversations for the active key.

GET/v1/conversations/:id

Fetch a single conversation's messages.

Ready to call POST /v1/chat/respond/stream?

Free tier covers 1,000 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.

Get free API keyTry in playground

Informational, not predictive. Not medical, legal, or financial advice.