Astrology Chat API क्या है और ये regular chatbot से कैसे अलग है?

Astrology Chat API एक एजेंटिक प्लेटफॉर्म है — सिर्फ chatbot wrapper नहीं। जब आप message भेजते हैं, सर्वर खुद तय करता है 16 ज्योतिष tools में से किसको invoke करना है (natal charts, transits, synastry, आदि), उनको हमारे 82 calculation endpoints पर execute करता है, और grounded response synthesize करता है। Generic chatbots जो ज्योतिष data hallucinate करते हैं उनके उलट, हर interpretation real ephemeris calculations पर based है। पूरा एजेंट लूप एक API कॉल में सर्वर-साइड चलता है।

क्या मैं OpenAI Python या TypeScript SDK इस API के साथ use कर सकता हूँ?

हाँ — यही core design principle है। हम standard OpenAI /chat/completions protocol implement करते हैं, तो आप official OpenAI SDK किसी भी भाषा में use कर सकते हैं: TypeScript (openai npm package), Python (openai pip package), Go, Rust, या कोई भी HTTP client। बस base URL हमारे endpoint पर change करें। आपका मौजूदा OpenAI code minimal changes के साथ काम करता है। इसका मतलब LangChain, Vercel AI SDK, और किसी भी OpenAI-संगत framework के साथ instant compatibility भी।

BYOK के साथ कौन से LLM models supported हैं?

BYOK तीन providers को 50+ models के साथ support करता है। OpenAI: GPT-5, GPT-5-mini, GPT-5-nano, o3, o4 families। Anthropic: Claude Opus 4, Sonnet 4, Haiku 4। OpenRouter: कोई भी model जो वो host करते हैं — Gemini 3, Grok 4, Llama, Mistral, Qwen, और बहुत कुछ। आप अपनी खुद की API key और model ID pass करते हैं। प्लेटफॉर्म सभी provider-specific quirks (जैसे reasoning model parameter differences) automatically handle करता है।

हर chat turn की credits में कितनी cost है?

हर turn में दो cost components हैं: platform credits + tool calls के लिए endpoint credits। Hosted mode: 25 credits/turn (LLM included) + endpoint credits (जैसे natal = 1, transit = 1, astrocartography = 5, PDF = 35)। BYOK mode: 2 credits/turn + वही endpoint credits + आपके LLM provider costs। उदाहरण: natal chart interpretation = 25 + 1 = 26 credits hosted (~$0.02), या 2 + 1 = 3 credits BYOK (~$0.002) + ~$0.003 LLM cost। Professional plan ($37/month, 55,000 credits) पर ये ~2,100 hosted turns या ~18,000 BYOK turns हैं। Free tier: 50 requests/month।

Synastry और compatibility के लिए multi-subject chat कैसे काम करता है?

astrology.subjects array में multiple subjects pass करें, हर एक semantic ID ('me', 'partner', 'child') और birth data के साथ। LLM tools call करते समय subjects को ID से reference करता है — सर्वर IDs को full birth coordinates में resolve करता है। ये एक ही conversation में synastry, composite charts, और multi-person analysis enable करता है। कोई competitor एक session में एक से ज़्यादा subject support नहीं करता।

क्या chat PDF reports और SVG chart images generate कर सकता है?

हाँ — binary artifacts एक unique feature है। पूछें 'मेरा natal chart generate करो' और एजेंट render_natal tool call करता है, SVG (या PNG/PDF) produce करता है, artifact के रूप में store करता है, और shareable URL return करता है। PDF natal reports के लिए भी वही — multi-page professional documents wheel visualization, interpretations, और themes के साथ। Artifacts Supabase में 24-hour retention और shareable URLs के साथ store होते हैं।

Astrology Chat API alternatives की तुलना में कितनी तेज़ है?

हमारी calculation layer प्रति tool call 300ms से कम में respond करती है। Total response time (calculation + LLM generation) typically streaming के साथ 2-5 seconds है। Competing ज्योतिष chat solutions average प्रति response 8-24 seconds, premium tiers पर भी। Streaming के साथ हमारे users पहले tokens 2 seconds से कम में देखते हैं जब एजेंट काम जारी रखता है।

SSE streaming extension events क्या हैं?

Standard OpenAI text chunks के अलावा, हम custom SSE events emit करते हैं: tool_start (जब एजेंट tool call शुरू करता है — आपका UI दिखा सकता है 'Calculating natal chart...'), tool_end (जब tool return होता है — execution time के साथ), और astrology.error (अगर tool gracefully fail हो)। ये rich, real-time UIs enable करते हैं जो एजेंट का reasoning process दिखाते हैं जब वो काम कर रहा हो।

Sessions और conversation memory कैसे काम करते हैं?

अपने request में astrology.session_id pass करें। पहले turn पर, सर्वर Redis-backed session बनाता है। वही ID वाले बाद के turns पर, सर्वर आपका नया message process करने से पहले prior messages और subjects load करता है। Sessions का 24-hour sliding TTL है — हर interaction window extend करता है। सर्वर long conversations के लिए message compression handle करता है, तो आपको context windows manage करने की ज़रूरत नहीं।

कौन सी programming languages और frameworks supported हैं?

HTTP client वाली कोई भी भाषा काम करती है, लेकिन OpenAI SDKs सबसे अच्छा experience देते हैं: TypeScript/JavaScript (openai), Python (openai), Go (openai-go), Rust, C#, Java, PHP, Ruby। Framework compatibility: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI, Haystack — कुछ भी जो OpenAI protocol बोलता है। ज़्यादातर developers 30 minutes से कम में integrate करते हैं।

क्या ये सिर्फ GPT wrapper है या real astronomical data use करता है?

हर astrological interpretation real ephemeris calculations में grounded है। जब एजेंट charts_natal call करता है, ये Swiss Ephemeris use करके actual planetary positions compute करता है — वही engine जो professional ज्योतिष software use करता है। LLM को real chart data मिलता है (planet positions, house placements, exact orbs वाले aspects) और उस data से interpretations synthesize करता है। कोई hallucinated planetary positions नहीं, कोई made-up aspects नहीं।

मैं response style और length कैसे control करूं?

Control की तीन layers: 1) System message — कोई भी personality set करें ('warm Jungian psychologist', 'concise British classicist', आदि)। 2) astrology.defaults.detail_level — 'brief' (100 words से कम), standard (200-350 words), या 'detailed' (500-800 words)। 3) astrology.defaults.tradition — classical, psychological, event-oriented, या universal। User का explicit instruction ('briefly' या 'in detail') सब override करता है।

कौन सी ज्योतिष traditions और house systems supported हैं?

चार interpretation traditions: Classical (Hellenistic/medieval), Psychological (Jungian), Event-Oriented (horary/electional), और Universal (balanced)। तेईस house systems जिनमें Placidus, Koch, Whole Sign, Equal, Campanus, Regiomontanus, Porphyry, और बहुत कुछ। astrology.defaults.house_system के through set करें — सर्वर सभी tool calls पर automatically apply करता है।

क्या मैं इसे अपने product के रूप में white-label कर सकता हूँ?

बिल्कुल। System prompt (messages[0] with role='system') पूरी personality control करता है। अपनी brand voice, astrologer persona, language style set करें — user कभी हमारी branding नहीं देखता। BYOK cost control देता है। Session persistence subscription models enable करता है। Standard pricing plans commercial redistribution support करते हैं।

अगर conversation के दौरान tool call fail हो जाए तो क्या होता है?

Graceful degradation। अगर tool error return करे (invalid birth data, unsupported calculation), एजेंट को error message मिलता है और वो adapt करता है — हो सकता है दूसरा tool try करे, user से clarification मांगे, या partial answer दे। Streaming के साथ आपको astrology.error event मिलता है। Conversation crash नहीं होती; LLM errors को conversationally handle करता है, जैसे human astrologer करता।

क्या मैं Lovable, Claude Code, या Cursor से ज्योतिष widget बना सकता हूँ?

हाँ — vibe coding के लिए ये ideal API है। क्योंकि हम standard OpenAI /chat/completions protocol implement करते हैं, AI coding tools जैसे Lovable, Claude Code, Cursor, Windsurf, Bolt, और Replit Agent पहले से जानते हैं कैसे integrate करना है। बस prompt करें: 'Build an astrology chat widget using OpenAI SDK with base URL https://api.astrology-api.io/api/v3/chat'। AI working streaming chat component generate करता है — birth data form, message bubbles, typing indicators — zero manual debugging के साथ। कोई दूसरी ज्योतिष API ये offer नहीं करती क्योंकि सब proprietary JSON formats use करती हैं जो AI tools नहीं समझते।

Astrology Chat API RoxyAPI या raw data endpoints से खुद बनाने की तुलना में कैसा है?

RoxyAPI और similar data-only APIs आपको raw calculation JSON देती हैं — आप पूरा agent layer खुद बनाते हैं: tool schemas, LLM orchestration, error handling, session management, artifact storage। यानी महीनों की engineering। हमारा प्लेटफॉर्म ये सब ready-made ship करता है। एक API कॉल agent framework code की hundreds of lines replace करती है। अगर आप पहले से LangChain या CrewAI use करते हैं, हमारा endpoint एक single tool के रूप में plug हो जाता है — आपका मौजूदा agent framework बाकी handle करता है।

to_prompt_text() क्या है और chatbot developers को क्यों care करना चाहिए?

to_prompt_text() एक formatter है जो chart data को compact, LLM-ready markdown में बदलता है। किसी भी prompt (Claude, GPT, Gemini, Grok) में drop करें model को real chart data में ground करने के लिए, बिना JSON dump किए। Output नैचुरल-लैंग्वेज है — cryptic field codes की जगह 'Mars square Saturn within 2°' — तो LLM इसे पहली बार में correctly parse करता है। Raw JSON की तुलना में average token spend ~60% गिरता है, और hallucinated readings sharply गिरते हैं क्योंकि model data पढ़ सकता है।

Prompt formatter LLM टोकन costs कितनी कम करता है?

Raw natal JSON dump 1,500-3,000 टोकन लेता है। 'minimal' preset 150-250 टोकन use करता है, 'full' 500-800, 'traditional' 600-900। ये average ~60% कमी है — और savings multi-turn sessions पर compound होती हैं। GPT-4-class pricing पर, 10,000 natal readings प्रति month करने वाला chatbot prompt tokens में roughly $150-$300 बचाता है। Smaller context का मतलब longer conversations window भरने से पहले fit होती हैं।

to_prompt_text() कौन सी भाषाएं support करता है?

सात भाषाएं, ~40 localized strings के साथ जो aspects, dignities, sect, houses, और modalities cover करते हैं: English (en), German (de), Spanish (es), French (fr), Italian (it), Portuguese (pt), Russian (ru)। Language code pass करें और formatter उस भाषा में markdown return करता है — localized chatbot prompt में drop करने के लिए तैयार। कोई client-side translation नहीं चाहिए।

Aspects natural language में कैसे format होते हैं?

Aspects readable phrases के रूप में precise orbs के साथ निकलते हैं। उदाहरण: 'Mars square Saturn within 2°', 'Venus trine Jupiter within 0°45'', 'Moon opposite Sun within 1°15''। Aspect name (square, trine, opposition, sextile, conjunction) spelled out है, orb degrees और minutes में दिखता है, और planets relationship word के दोनों तरफ बैठते हैं — बिल्कुल वैसे जैसे astrologer लिखता। LLMs इसे पहली बार में correctly parse करते हैं।

Formatted output में t. और n. prefixes का क्या मतलब है?

't.' transit planets mark करता है, 'n.' natal planets mark करता है। जब आप transit reading format करते हैं, हर aspect line source clearly दिखाती है — उदाहरण के लिए 't.Jupiter trine n.Venus within 1°' मतलब transiting Jupiter natal Venus के trine है। यही एक change ज्योतिष chatbots में सबसे common hallucination खत्म कर देता है: natal chart और current sky के बीच planet identity confusion। LLM को कभी guess नहीं करना पड़ता।

नया: AI एजेंट प्लेटफॉर्म

सिर्फ चैट से ज़्यादा। AI ज्योतिष एजेंट बनाएं

ज्योतिष के लिए एकमात्र OpenAI-संगत एजेंटिक प्लेटफॉर्म। 16 सर्वर-साइड टूल्स, BYOK मॉडल चयन, SSE स्ट्रीमिंग, मल्टी-सब्जेक्ट सेशन। एक API कॉल, पूरा एजेंट लूप।

API डॉक्स देखें

LLM Context Presets

Prompt भाषाएं

60%

टोकन कमी

एजेंट टूल्स

OpenAI SDK ड्रॉप-इन

अपनी खुद की Key लाएं

सर्वर-साइड एजेंट लूप

एजेंट को Action में देखें

सर्वर-साइड tool orchestration से powered real conversations

Astrology Chat APILive Demo

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.astrology-api.io/api/v3/chat",
  apiKey: "your-astrology-api-key",
});

const response = await client.chat.completions.create({
  model: "astro-default",
  stream: true,
  messages: [
    { role: "system", content: "Warm, insightful astrologer." },
    { role: "user", content: "Analyze my natal chart" }
  ],
  astrology: {
    subjects: [{ id: "me", birth_data: {
        year: 1990, month: 3, day: 15,
        hour: 14, minute: 30,
        city: "New York", country_code: "US"
      } }],
    enabled_tools: ["charts_natal"],
    defaults: { language: "hi", tradition: "psychological" }
  }
} as any);

for await (const chunk of response) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

हमारे 16 endpoints या combinations में से किसी के साथ काम करता है

Vedic Jyotish

Horary Questions

Human Design

Astrocartography

Numerology

Tarot Reading

Relationship Synastry

Transit Forecast

एक session में कोई भी endpoint combination — natal, Vedic, horary, BaZi, astrocartography, और बहुत कुछ।Hosted: 25 + endpoint credits/turn · BYOK: 2 + endpoint credits + LLM costs

पूरा natal JSON dump हर chart पर 1,500-3,000 टोकन खाता है — context windows जल्दी भर जाती हैं
'Mars 0d 90.0 Saturn' जैसे cryptic field names model को confuse करते हैं और गलत readings देते हैं
Transit और natal data बिना prefixes के मिलते हैं — LLM खुद तय करता है कौन सा planet कौन है
Proprietary chat models में बंधे — कोई BYOK चयन या cost control नहीं
केवल-English prompt context multilingual chatbot rollouts को रोकता है
अपना खुद का tool loop, prompt formatter और session manager scratch से बनाएं

इसके साथ बदलें

to_prompt_text() formatter: 3 presets (minimal 150-250, full 500-800, traditional 600-900 टोकन) — raw JSON की तुलना में ~60% कमी
नैचुरल-लैंग्वेज एस्पेक्ट्स: cryptic field codes की जगह 'Mars square Saturn within 2°'
t. / n. prefixes transit vs natal को अलग करते हैं (जैसे 't.Jupiter trine n.Venus') — कोई hallucinated planets नहीं
7-भाषा i18n (~40 strings) में EN, DE, ES, FR, IT, PT, RU — global chatbot deployment के लिए
BYOK: GPT-5, Claude 4, Gemini 3, Grok, या OpenRouter के 50+ models में से कोई भी
सर्वर-साइड एजेंट लूप 16 tools, multi-subject sessions और binary artifacts के साथ

प्लेटफॉर्म परफॉर्मेंस

टोकन-ऑप्टिमाइज़्ड context, एजेंट-ready tooling, तेज़ calculations

LLM Context Presets

Prompt भाषाएं

~60%

JSON की तुलना में टोकन कमी

~40

Formatter में i18n Strings

एजेंट टूल्स

<300ms

Calculation स्पीड

Interpretation भाषाएं

50+

LLM Models

Complete एजेंट प्लेटफॉर्म Features

AI ज्योतिष experiences बनाने के लिए सब कुछ

to_prompt_text() LLM Context Formatter

Bring Your Own Key (BYOK)

SSE Streaming और Events

16 Auto-Generated एजेंट Tools

Multi-Subject और Sessions

AI Coding Tools के लिए Widget-Ready

Binary Artifacts और Output

Astrology Chat API क्या है? पूरी डेवलपर गाइड

AI-powered ज्योतिष experiences बनाने के लिए जो भी चाहिए

क्या होगा अगर आप एक API कॉल से अपने app में पूरी तरह से functional ज्योतिष AI एजेंट जोड़ सकें? Astrology Chat API यही करता है। यह सिर्फ एक chatbot endpoint नहीं है — यह एक पूरा एजेंटिक प्लेटफॉर्म है जो पूरा tool-calling loop सर्वर-साइड चलाता है। आप एक user message भेजते हैं, और सर्वर खुद तय करता है कि 16 ज्योतिष tools में से किसे invoke करना है, subject IDs से birth chart data resolve करता है (कोई hallucinated dates नहीं), PDF reports या SVG charts binary artifacts के रूप में generate करता है, और एक coherent response लौटाता है — सब OpenAI-संगत /chat/completions endpoint के through। इसका मतलब आप standard OpenAI SDK को TypeScript, Python, Go, या किसी भी भाषा में use कर सकते हैं। कोई custom integration code नहीं। अपना agent framework बनाने की ज़रूरत नहीं। Tool schemas manage करने की ज़रूरत नहीं। मौजूदा ज्योतिष chat solutions प्रति query $0.25-$0.87 charge करते हैं, response देने में 8-24 seconds लेते हैं, proprietary models में बंधते हैं, और custom JSON formats use करते हैं जिनको bespoke integration code चाहिए। हम एकमात्र प्लेटफॉर्म हैं जो ready-made एजेंट BYOK support के साथ देता है — अपना LLM चुनें GPT-5, Claude, Gemini, Grok, या OpenRouter पर 50+ models में से।

Agentic Chat API कैसे काम करता है?

Astrology Chat API एक specialized AI एजेंट की तरह काम करता है जो ज्योतिष को deeply जानता है। Flow ये है: 1) आप standard OpenAI /chat/completions endpoint के through message भेजते हैं। 2) सर्वर astrological context inject करता है — आपके subjects का birth data, active tools, language preferences। 3) LLM तय करता है कौन से tools call करने हैं (natal chart calculation, transit analysis, synastry report, आदि)। 4) सर्वर उन tools को internally हमारे 82 ज्योतिष endpoints पर execute करता है — आपकी तरफ से कोई extra API calls नहीं। 5) Tool results LLM को synthesis के लिए वापस feed होते हैं। 6) आपको real planetary data के साथ coherent, grounded interpretation मिलती है। पूरा tool loop एक ही request में सर्वर-साइड चलता है। आप कभी tool-call messages नहीं देखते — सिर्फ final answer। Streaming enabled (SSE) के साथ आपको real-time extension events जैसे tool_start और tool_end भी मिलते हैं, ताकि आपका UI दिखा सके 'Calculating transit chart...' जब एजेंट काम कर रहा हो।

पूरा एजेंट लूप एक API कॉल में सर्वर-साइड चलता है

1 min read

BYOK क्या है और ये क्यों ज़रूरी है?

BYOK — Bring Your Own Key — मतलब आप चुनते हैं कि आपके ज्योतिष एजेंट को कौन सा LLM power करे। मार्केट के बाकी सभी ज्योतिष chat solutions आपको एक proprietary model में बांधते हैं, बिना किसी alternative के — कुछ तो disclose भी नहीं करते कि वो कौन सा model use कर रहे हैं। हमारे BYOK endpoint (/chat/completions/byok) से आप अपनी खुद की API key और model ID pass करते हैं। हम तीन providers support करते हैं: OpenAI (GPT-5, GPT-5-mini, GPT-5-nano, o3, o4), Anthropic (Claude Opus 4, Claude Sonnet 4, Claude Haiku 4), और OpenRouter (50+ models जिनमें Gemini 3, Grok 4, Llama, Mistral, और बहुत कुछ)। ये क्यों matter करता है? Cost control — GPT-5-nano, GPT-5-pro से 10x सस्ता है। Quality tuning — Claude nuanced interpretation में excel करता है, Gemini simple queries के लिए तेज़ है। Compliance — कुछ enterprises को specific model providers चाहिए। BYOK की cost सिर्फ 2 credits/turn (हमारी platform fee) + आपका LLM provider जो charge करे।

50+ LLM models उपलब्ध — cost, quality, और provider आप चुनते हैं

1 min read

ये एकमात्र OpenAI-संगत option क्यों है?

OpenAI compatibility का मतलब आप standard OpenAI SDK use करते हैं — वही client library जो लाखों developers पहले से जानते हैं। कोई नया SDK सीखने की ज़रूरत नहीं, कोई custom HTTP client बनाने की ज़रूरत नहीं। TypeScript में: new OpenAI({ baseURL: 'https://api.astrology-api.io/api/v3/chat' })। Python में: OpenAI(base_url='...')। बस इतना। आपका मौजूदा ChatGPT code minimal changes के साथ काम करता है। इसका मतलब OpenAI के protocol पर बने हर framework के साथ instant compatibility: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI। अगर आपका framework OpenAI बोलता है, तो वो Astrology Chat API बोलता है। कोई दूसरा ज्योतिष provider ये offer नहीं करता — मौजूदा solutions custom endpoints use करते हैं proprietary request/response shapes के साथ, हर platform के लिए bespoke integration code चाहिए।

किसी भी OpenAI SDK के साथ काम करता है — TypeScript, Python, Go, Rust, और हर AI framework

1 min read

Vibe Coding के लिए perfect — मिनटों में ज्योतिष Widgets बनाएं

क्योंकि हमारी API standard OpenAI protocol use करती है, हर AI coding tool पहले से जानता है इसके साथ कैसे काम करना है। Lovable को बोलें 'इस API से ज्योतिष chat widget बनाओ' और वो working React component generate करता है — streaming UI, birth data form, chat bubbles, सब कुछ। Claude Code और Cursor एक prompt में पूरा integration scaffold कर सकते हैं क्योंकि वो OpenAI SDK को natively समझते हैं। कोई custom adapters नहीं, कोई obscure documentation नहीं, कोई proprietary JSON formats debug करने की ज़रूरत नहीं। यही बात Windsurf, Bolt, Replit Agent, और किसी भी AI tool पर लागू होती है जो OpenAI की API पर code लिख सकता है। यही हमारे प्लेटफॉर्म को vibe coding के लिए uniquely suited बनाता है: आप जो widget चाहते हैं describe करें, AI बनाता है, और पहली बार में काम करता है — क्योंकि underlying API वही protocol है जिस पर ये tools trained हैं। Vibe coders ज्योतिष apps घंटों में ship कर रहे हैं, हफ्तों में नहीं। Chat widgets, compatibility checkers, daily horoscope generators, natal chart interpreters — सब AI coding assistant को बता कर बनाए जा रहे हैं। इस prompt को किसी भी AI coding tool में copy करें instantly start करने के लिए:

Lovable, Claude Code, Cursor, Windsurf — कोई भी AI coding tool instantly working integrations बना सकता है

2 min read

16 एजेंट Tools क्या कर सकते हैं?

प्लेटफॉर्म 16 tools expose करता है जिन्हें LLM conversation के दौरान autonomously invoke कर सकता है। ये हमारे 82 मौजूदा API endpoints से dynamic registry use करके auto-generated हैं — सिर्फ 'chat-safe' tag वाले endpoints tools बनते हैं। Tools cover करते हैं: Analysis (3 tools) — multi-section interpretations वाले natal reports, moon phases और mansions के साथ lunar analysis, relationship index scores के साथ synastry reports। Chart Calculations (4 tools) — natal, synastry, composite, और transit charts पूरी planetary positions और aspects के साथ। Chart Rendering (4 tools) — natal, synastry, transit, और composite charts SVG, PNG, JPG, WebP, या PDF के रूप में। Generated charts binary artifacts के रूप में shareable URLs के साथ store होते हैं। Data (3 tools) — current planetary positions, किसी भी date के लिए ephemeris, और aspect matrices। Horoscope (1 tool) — personalized daily horoscope 6 life areas, ratings, और planetary influences के साथ। PDF (1 tool) — professional multi-page natal report wheel visualization, interpretations, और themes के साथ। नए tools add करने के लिए chat endpoint में zero code changes चाहिए — बस मौजूदा endpoint को 'chat-safe' tag करें।

82 endpoints से 16 tools auto-generated — नए tools के लिए zero chat code changes

1 min read

Multi-Subject Sessions और Artifacts कैसे काम करते हैं?

दो features जो कोई competitor नहीं देता: multi-subject sessions और binary artifacts। Multi-subject मतलब आप एक conversation में multiple birth charts pass कर सकते हैं — उदाहरण के लिए 'me' और 'partner'। LLM tools call करते समय subjects को उनके semantic ID से reference करता है, और सर्वर उनको पूरे birth data में resolve करता है। ये synastry analysis, composite chart comparisons, और family dynamics enable करता है — सब एक chat session में, बिना birth data दोबारा भेजे। कोई दूसरी chat API एक conversation में एक से ज़्यादा subject support नहीं करती। Binary artifacts से chat downloadable files generate कर सकता है। पूछें 'मेरा natal chart generate करो' और SVG chart image मिलेगा। पूछें 'PDF report बनाओ' और professional multi-page document मिलेगा। Artifacts Supabase में shareable URLs और 24-hour retention के साथ store होते हैं। Sessions Redis के through 24-hour sliding TTL के साथ persist होते हैं। वही session_id turns पर pass करें और सर्वर conversation history, subjects, और context restore करता है — true multi-turn memory बिना client-side state management के।

Multi-subject sessions और binary artifacts — दोनों हमारे प्लेटफॉर्म के unique हैं

1 min read

to_prompt_text() LLM टोकन Costs को ~60% कैसे कम करता है

ज़्यादातर developers अपने LLM chatbots को पूरा chart JSON prompt में dump करके ground करते हैं। JSON में natal chart 1,500-3,000 टोकन लेता है — GPT-4-class models पर ये $0.015-$0.030 per request है, plus कुछ turns के बाद context window भर जाता है। और बुरी बात ये कि model अक्सर 'Mars 0d 90.0 Saturn' जैसे cryptic field codes गलत पढ़ता है और गलत interpretations देता है। हमारा to_prompt_text() formatter दोनों problems solve करता है। ये chart data को compact, human-readable markdown में convert करता है नैचुरल-लैंग्वेज एस्पेक्ट्स के साथ। तीन presets सही token budget pick करने देते हैं: 'minimal' (~150-250 टोकन) sun/moon/asc, key aspects, current transits cover करता है — chat replies के लिए बढ़िया। 'full' (~500-800 टोकन) dignities, houses, modalities, और sect add करता है richer interpretations के लिए। 'traditional' (~600-900 टोकन) Hellenistic और medieval depth include करता है — lots, almuten, hayz, antiscia — classical-style readings के लिए। Formatted markdown को किसी भी LLM prompt (Claude, GPT, Gemini, Grok) में drop करें model को real chart data में ground करने के लिए, बिना JSON dump किए। Average token savings: raw JSON dump की तुलना में ~60%, measurably कम hallucinations के साथ।

3 presets, 150-900 टोकन, JSON dumps से ~60% सस्ता

1 min read

नैचुरल-लैंग्वेज एस्पेक्ट्स और t./n. Prefixes

LLMs field codes से ज़्यादा natural language बेहतर पढ़ते हैं — इसलिए to_prompt_text() aspects को वैसे output करता है जैसे एक astrologer लिखता। 'Mars 0d 90.0 Saturn' की जगह आपको 'Mars square Saturn within 2°' मिलता है। Orb precise रहता है, लेकिन model इसे पहली बार में parse करता है। जब formatter natal chart के साथ transit data include करता है, हर planet prefix के साथ tag होता है: 't.' transit के लिए, 'n.' natal के लिए। तो transit reading दिखाती है 't.Jupiter trine n.Venus within 1°' — model को कभी guess नहीं करना पड़ता कि कौन सा planet किस chart का है। यही एक change ज्योतिष chatbots में hallucinated readings का सबसे common source खत्म कर देता है: charts के बीच planet identity confusion। 7-भाषा i18n (EN, DE, ES, FR, IT, PT, RU — aspects, sect, dignities, houses, modalities cover करते हुए ~40 strings) के साथ combine करें, आप multilingual chatbot ship कर सकते हैं जो Claude या GPT को localized chart context में ground करता है, बिना client-side कुछ translate किए।

नैचुरल-लैंग्वेज एस्पेक्ट्स + transit/natal prefixes hallucinated readings खत्म करते हैं

1 min read

परफॉर्मेंस और Pricing vs Competitors

Numbers की बात करें। सबसे तेज़ competing ज्योतिष chat solutions प्रति response 8-12 seconds लेते हैं। मार्केट पर standard-tier plans average 19-24 seconds। हमारी calculation layer 300ms से कम में respond करती है — total response time सिर्फ LLM speed पर depend करता है, typically streaming के साथ 2-5 seconds। यानी 4-10x तेज़। Pricing पर, alternatives प्रति AI query $0.25-$0.87 charge करते हैं — monthly subscription fees के ऊपर। हमारी pricing के तीन components हैं: (1) प्रति turn platform credits — 25 hosted या 2 BYOK, (2) हर tool एजेंट जो call करे उसके लिए endpoint credits (जैसे natal chart = 1 credit, astrocartography = 5 credits, PDF report = 35 credits), और (3) BYOK use करने पर अपने LLM costs। उदाहरण: natal interpretation turn = 25 + 1 = 26 credits hosted (~$0.02), या 2 + 1 = 3 credits BYOK (~$0.002) + ~$0.003 LLM cost। यानी प्रति conversation turn alternatives से 10-100x सस्ता। हम chat को हमारे standard free tier में include करते हैं: 50 requests प्रति month, कोई credit card नहीं चाहिए।

Competitors से 4-10x तेज़ और 10-100x सस्ता

1 min read

Use Cases

ज्योतिष Mobile Apps

अपने iOS या Android app में conversational AI astrologer add करें। Users natural language में सवाल पूछते हैं, real chart calculations पर based personalized interpretations पाते हैं। OpenAI SDK React Native और Flutter के साथ natively काम करता है।

Dating और Compatibility प्लेटफॉर्म्स

Multi-subject sessions दो users के बीच real-time compatibility analysis enable करते हैं। एजेंट synastry, composite charts, और relationship dynamics calculate करता है — सब एक ही conversation flow में।

Content Generation Pipelines

Personalized horoscopes, weekly forecasts, और natal reports scale पर generate करें। Cost-efficient model (GPT-5-nano) के साथ BYOK use करें और 2,800+ users को daily email या push notification content के लिए batch process करें।

Wellness और Mental Health प्लेटफॉर्म्स

Mindfulness apps, therapy tools, और self-reflection प्लेटफॉर्म्स में astrological insights integrate करें। Psychological tradition mode growth और self-awareness पर focused Jungian-style interpretations देता है।

SaaS ज्योतिष प्लेटफॉर्म्स

पूरे एजेंट को अपने product के रूप में white-label करें। Custom system prompts personality set करते हैं, BYOK costs control करता है, और session persistence paying subscribers के लिए multi-turn consultations enable करता है।

AI एजेंट Frameworks

LangChain, CrewAI, AutoGen, या किसी भी OpenAI-संगत agent framework में directly plug करें। हमारी API आपके multi-agent system में specialized ज्योतिष tool बनती है — कोई custom adapters नहीं चाहिए।

AI Tools के साथ Vibe Coding

Lovable, Claude Code, Cursor, या Windsurf को बोलें ज्योतिष widget बनाने के लिए — और मिनटों में working app पाएं। क्योंकि हमारी API OpenAI protocol follow करती है, AI coding tools पहली बार में correct integrations generate करते हैं। Chat widgets, horoscope generators, compatibility checkers — describe करें और ship करें।

Technical Specifications

API Protocol	OpenAI Chat Completions (v1)
Endpoints	/chat/completions (hosted) + /chat/completions/byok
LLM Context Formatter	to_prompt_text() with 3 presets
Preset Values	minimal \| full \| traditional
प्रति Preset Token Range	minimal 150-250 · full 500-800 · traditional 600-900
Aspect Format	'Mars square Saturn within 2°' (नैचुरल लैंग्वेज)
Transit/Natal Prefixes	t.Jupiter trine n.Venus
Prompt Formatter भाषाएं	7 (en, de, es, fr, it, pt, ru)
Formatter में i18n Strings	7 भाषाओं में ~40
एजेंट Tools	82 endpoints से 16 auto-generated
Calculation स्पीड	<300ms प्रति tool call
Total Response Time	Streaming के साथ 2-5s
Streaming	SSE with tool_start/tool_end extension events
BYOK Providers	OpenAI, Anthropic, OpenRouter (50+ models)
Hosted Model	astro-default (ज्योतिष के लिए optimized)
Session Persistence	Redis-backed, 24h sliding TTL
Multi-Subject	प्रति session unlimited subjects
Binary Artifacts	chat के through SVG, PNG, JPG, WebP, PDF
Interpretation भाषाएं	9 (en, de, fr, es, it, pt, ru, zh, hi)
Traditions	Classical, Psychological, Event-Oriented, Universal
Authentication	Bearer token (API key)
Rate Limiting	प्रति API key, configurable

Astrology Chat API vs DIY JSON Dump Approach

Feature	Astrology API	Others
LLM Prompt Tokens (प्रति chart)	150-900 (preset-dependent)	1,500-3,000 (raw JSON)
प्रति Prompt Token Cost	JSON dump से ~60% कम	हर turn पर full token spend
Aspect Readability	'Mars square Saturn within 2°'	'Mars 0d 90.0 Saturn' (cryptic)
Transit/Natal Disambiguation	t. / n. prefixes built in	Model guesses (hallucinations)
Multilingual Prompt Context	7 भाषाएं (~40 i18n strings)	केवल-English या खुद translate करें
Hallucination Rate	कम — grounded natural language	ज़्यादा — cryptic codes LLMs को confuse करते हैं
OpenAI SDK Compatible	हाँ (drop-in)	नहीं (custom APIs)
BYOK Model Choice	50+ models (3 providers)	Locked proprietary model
सर्वर-Side एजेंट Loop	16 tools, automatic	खुद बनाएं
Multi-Subject Sessions	Unlimited subjects	एक birth chart
Binary Artifacts	chat के through PDF, SVG, PNG	उपलब्ध नहीं
Response Time	2-5s (streaming)	8-24 seconds
प्रति Query Price	$0.001-$0.02	$0.25-$0.87
Free Tier	50 requests/month	कोई नहीं या paid sandbox
AI Coding Tools (Vibe Coding)	Instantly काम करता है (OpenAI protocol)	Custom formats, सिर्फ manual coding

Natal Chart API

Planetary positions, houses, और aspects के साथ complete natal charts calculate करें

Transit API

Current planetary transits — chatbot context के लिए to_prompt_text() के साथ pair होता है

Traditional Astrology API

Hellenistic और medieval techniques — 'traditional' preset depth से match

Timing API

Electional और event timing — forecast questions के लिए chat prompts में drop करें

Horary API

AI horary endpoint — question-based readings के लिए chat agent के साथ naturally pair

Synastry API

दो charts के बीच relationship compatibility analysis

PDF Report API

Professional multi-page ज्योतिष PDF reports generate करें

API Documentation

Interactive examples के साथ complete technical reference

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

इस prompt को Lovable, Claude Code, Cursor, या किसी भी AI coding tool में copy करें:

Build an astrology chat widget using the OpenAI SDK. Use base URL https://api.astrology-api.io/api/v3/chat and read the API docs at https://api.astrology-api.io/md/chat-completions for the full request schema. The widget should have: a birth data form (date, time, city), a streaming chat interface with message bubbles, and display tool call events (like 'Calculating natal chart...') as the agent works. Use the astrology namespace for subjects and enabled_tools as documented.

सरल, पारदर्शी मूल्य निर्धारण

मुफ्त शुरू करें, बढ़ते हुए स्केल करें। कोई छिपी हुई फीस नहीं, कोई आश्चर्य नहीं।

हमेशा मुफ्त

सीखने, परीक्षण और छोटे व्यक्तिगत परियोजनाओं के लिए एकदम सही

50 API कॉल/माह

बुनियादी जन्म कुंडली

5 भाव प्रणालियाँ

सामुदायिक सहायता

Pro

$11/माह

छोटे ऐप्स और व्यक्तिगत परियोजनाओं के लिए

सभी बुनियादी एंडपॉइंट
12 भाव प्रणालियाँ
ईमेल सहायता

सर्वोत्तम मूल्य

Pro Plus

$21/माह

बढ़ते ऐप्स और मध्यम ट्रैफिक के लिए

सभी उन्नत एंडपॉइंट
18 भाव प्रणालियाँ
AI व्याख्याएँ
प्राथमिकता ईमेल सहायता

Ultra

$37/माह

पेशेवर ज्योतिष अनुप्रयोगों के लिए

Credit math ↓

सभी प्रीमियम एंडपॉइंट
23 भाव प्रणालियाँ
उन्नत AI व्याख्याएँ
प्राथमिकता सहायता

उच्च मात्रा योजनाएं

एंटरप्राइज-स्केल अनुप्रयोगों के लिए

बिजनेस

$99/माह

उच्च-मात्रा वाले अनुप्रयोगों के लिए

Credit math ↓

सभी एंडपॉइंट
व्हाइट-लेबल तैयार
कस्टम AI फाइन-ट्यूनिंग
फोन सहायता

असीमित

एंटरप्राइज

$399+प्रति माह

समर्पित बुनियादी ढांचे के साथ असीमित अनुरोध

समर्पित सर्वर बुनियादी ढांचा
300ms से कम गारंटी
24/7 समर्पित सहायता
99.99% अपटाइम SLA

सभी योजनाओं में व्यापक दस्तावेज़ीकरण और SDK शामिल हैं

प्रश्न? हमारी टीम से बात करें

Astrology Chat API के बारे में अक्सर पूछे जाने वाले सवाल

एजेंटिक ज्योतिष प्लेटफॉर्म के बारे में real answers

अपना Complete Astrology Stack बनाएं

Chat API इन endpoints को automatically orchestrate करती है, लेकिन आप इन्हें directly भी use कर सकते हैं:

Natal Chart API chat के पीछे raw chart calculations Transit API prompt context के लिए current planetary influences Traditional Astrology API Hellenistic depth — 'traditional' preset से match Timing API electional timing और forecast queries Horary API AI horary endpoint — chat agent के साथ pair Synastry API relationship और compatibility analysis PDF Report API professional multi-page documents MCP Astrology Server Claude Desktop integration

टोकन-Optimized Ship करें

OpenAI-संगत एजेंट, 16 tools, BYOK, और 7 भाषाओं में to_prompt_text() context। Raw JSON dump करने की तुलना में LLM टोकन costs ~60% कम करें।

फ्री शुरू करें API डॉक्स देखें

50 फ्री requests/month

OpenAI SDK संगत

कोई setup fees नहीं

सिर्फ चैट से ज़्यादा। AI ज्योतिष एजेंट बनाएं

एजेंट को Action में देखें

LLM prompts में Raw JSON डालना टोकन बर्बाद करता है और hallucinations पैदा करता है

एक API में टोकन-ऑप्टिमाइज़्ड LLM Context + पूरा एजेंट प्लेटफॉर्म

प्लेटफॉर्म परफॉर्मेंस

Complete एजेंट प्लेटफॉर्म Features

to_prompt_text() LLM Context Formatter

Bring Your Own Key (BYOK)

SSE Streaming और Events

16 Auto-Generated एजेंट Tools

Multi-Subject और Sessions

AI Coding Tools के लिए Widget-Ready

Binary Artifacts और Output

Astrology Chat API क्या है? पूरी डेवलपर गाइड

Agentic Chat API कैसे काम करता है?

BYOK क्या है और ये क्यों ज़रूरी है?

ये एकमात्र OpenAI-संगत option क्यों है?

Vibe Coding के लिए perfect — मिनटों में ज्योतिष Widgets बनाएं

16 एजेंट Tools क्या कर सकते हैं?

Multi-Subject Sessions और Artifacts कैसे काम करते हैं?

to_prompt_text() LLM टोकन Costs को ~60% कैसे कम करता है

नैचुरल-लैंग्वेज एस्पेक्ट्स और t./n. Prefixes

परफॉर्मेंस और Pricing vs Competitors

Use Cases

ज्योतिष Mobile Apps

Dating और Compatibility प्लेटफॉर्म्स

Content Generation Pipelines

Wellness और Mental Health प्लेटफॉर्म्स

SaaS ज्योतिष प्लेटफॉर्म्स

AI एजेंट Frameworks

AI Tools के साथ Vibe Coding

Technical Specifications

Astrology Chat API vs DIY JSON Dump Approach

संबंधित Astrology APIs

Natal Chart API

Transit API

Traditional Astrology API

Timing API

Horary API

Synastry API

PDF Report API

API Documentation

References & Standards

सरल, पारदर्शी मूल्य निर्धारण

हमेशा मुफ्त

Pro

Pro Plus

Ultra

उच्च मात्रा योजनाएं

बिजनेस

एंटरप्राइज

Astrology Chat API के बारे में अक्सर पूछे जाने वाले सवाल

Astrology Chat API क्या है और ये regular chatbot से कैसे अलग है?

क्या मैं OpenAI Python या TypeScript SDK इस API के साथ use कर सकता हूँ?

BYOK के साथ कौन से LLM models supported हैं?

हर chat turn की credits में कितनी cost है?

Synastry और compatibility के लिए multi-subject chat कैसे काम करता है?

क्या chat PDF reports और SVG chart images generate कर सकता है?

Astrology Chat API alternatives की तुलना में कितनी तेज़ है?

SSE streaming extension events क्या हैं?

Sessions और conversation memory कैसे काम करते हैं?

कौन सी programming languages और frameworks supported हैं?

क्या ये सिर्फ GPT wrapper है या real astronomical data use करता है?

मैं response style और length कैसे control करूं?

कौन सी ज्योतिष traditions और house systems supported हैं?

क्या मैं इसे अपने product के रूप में white-label कर सकता हूँ?

अगर conversation के दौरान tool call fail हो जाए तो क्या होता है?

क्या मैं Lovable, Claude Code, या Cursor से ज्योतिष widget बना सकता हूँ?

Astrology Chat API RoxyAPI या raw data endpoints से खुद बनाने की तुलना में कैसा है?

to_prompt_text() क्या है और chatbot developers को क्यों care करना चाहिए?

मुझे कौन सा preset use करना चाहिए — minimal, full, या traditional?

Prompt formatter LLM टोकन costs कितनी कम करता है?

to_prompt_text() कौन सी भाषाएं support करता है?

Aspects natural language में कैसे format होते हैं?

Formatted output में t. और n. prefixes का क्या मतलब है?

अपना Complete Astrology Stack बनाएं

टोकन-Optimized Ship करें

एजेंट को Action में देखें

LLM prompts में Raw JSON डालना टोकन बर्बाद करता है और hallucinations पैदा करता है

एक API में टोकन-ऑप्टिमाइज़्ड LLM Context + पूरा एजेंट प्लेटफॉर्म