असली कुंडली पर AI चैट

आम LLM शनि के बारे में सवाल का जवाब राशि की याद के आधार पर देता है। POST /v1/ai/chat उस कुंडली से जवाब देता है जो हमने अभी-अभी कैलकुलेट की है: स्थिति, भाव, orb के साथ पहलू और अगले छह महीनों की ट्रांज़िट windows। फ़र्क पहले ही जवाब में दिख जाता है: “मकर में शनि अनुशासन का संकेत है” नहीं, बल्कि “शनि मकर 25.2° वक्री, 5वाँ भाव, चंद्रमा से युति orb 1.7°“।

बिना key के आज़माएँ

डेमो एक तय कुंडली पर चलता है, एक पते से दिन में 5 सवाल, और system prompt वही है जो paid एंडपॉइंट का है। Key की ज़रूरत नहीं।

मॉडल क्या देखता है

डेमो context फ़ील्ड लौटाता है: यह पूरा ब्लॉक है जो prompt में गया। डेमो की कुंडली के लिए 2 सितंबर 2026 की स्थिति में यह ऐसा है (ट्रांज़िट हर अनुरोध पर फिर से कैलकुलेट होते हैं, इसलिए कल windows की सूची अलग होगी):

## Natal Chart
- Sun: Taurus 24.4°, house 9
- Moon: Capricorn 26.9°, house 5
- Saturn: Capricorn 25.2° (R), house 5
- Ascendant: Virgo 20.0°
- Midheaven: Gemini 17.1°

Aspects (computed, use these instead of deriving your own):
- Sun Trine Saturn, orb 0.9°, applying
- Moon Conjunction Saturn, orb 1.7°
- Venus Square Neptune, orb 1.6°

## Transits, computed. Today is 2026-09-02; sampled monthly to 2027-03-01
(These are the only windows that exist. Report a month, not a day.)
- transiting Saturn Conjunction natal Venus: in orb on 2026-09-02, 2026-10-01, 2026-11-01, 2026-12-01, 2027-01-01, 2027-02-01, 2027-03-01 (closest 2027-03-01, orb 0.3°)
- transiting Jupiter Square natal Sun: in orb on 2026-10-01, 2026-11-01, 2026-12-01, 2027-01-01, 2027-02-01, 2027-03-01 (closest 2026-11-01, orb 0.0°)

ब्लॉक छोटा किया गया है: पूरे संस्करण में 12 ग्रह और कोण, 20 तक प्रमुख जन्म-पहलू और 12 तक ट्रांज़िट windows होती हैं। Paid एंडपॉइंट के लिए यही ब्लॉक उस कुंडली से बनता है जो आप भेजते हैं।

क्या तारीख़ बताता है और क्या नहीं

हमारा system prompt ऊपर वाले ब्लॉक में मौजूद ट्रांज़िट के लिए महीने बताने की इजाज़त देता है और किसी घटना की तारीख़ बताने से रोकता है। “मेरी शादी कब होगी” सवाल पर एंडपॉइंट ऐसे जवाब देता है (2 सितंबर 2026 के असली जवाब का अंश):

ट्रांज़िट शनि आपके जन्म-शुक्र के साथ युति बना रहा है। यह ट्रांज़िट कई महीनों तक सक्रिय रहेगा: सितंबर, अक्टूबर, नवंबर, दिसंबर 2026 में, और जनवरी, फ़रवरी और मार्च 2027 में भी, और मार्च 2027 में इसका orb सबसे निकट होगा।

यहाँ तारीख़ें गढ़ी हुई नहीं हैं: यह context ब्लॉक की पंक्ति transiting Saturn Conjunction natal Venus है। जवाब में शादी की तारीख़ नहीं है और नहीं होगी।

टिप्पणी

अगर आप ऐसा प्रोडक्ट बना रहे हैं जिसमें जवाब की ज़िम्मेदारी आपकी है, तो यह सीमा आपके पक्ष में काम करती है: आपके इंटरफ़ेस में किसी और के मॉडल की तारीख़ वाली भविष्यवाणी आपका जोखिम है, हमारा नहीं। महीने की जगह सटीक window चाहिए: /v1/transit-calendar।

Personas

persona आवाज़ बदलता है, डेटा नहीं। मान एक बंद सूची है, क्योंकि request body की स्ट्रिंग system prompt में जाती है।

persona	आवाज़
astrologer	default, जैसे पैरामीटर आने से पहले एंडपॉइंट जवाब देता था
plain	बिना persona, अभिवादन और हस्ताक्षर के
coach	सहारा और इसके साथ क्या करें
teacher	तकनीक का नाम बताता है और शब्द समझाता है

सवाल “मेरे शनि का एक अनुच्छेद में वर्णन करो”, persona: "coach":

आपका शनि मकर राशि में है, जो उसकी अपनी राशि है, और साथ ही वह वक्री है और 5वें भाव में स्थित है। यह संरचना, अनुशासन और महारत की गहरी जड़ों वाली चाह की ओर इशारा करता है, ख़ास तौर पर आत्म-अभिव्यक्ति, रचनात्मकता, प्रेम और बच्चों से जुड़े क्षेत्रों में।

persona: "teacher":

आपकी जन्म कुंडली में शनि मकर 25.2° (R) में 5वें भाव में है। शनि अनुशासन, ज़िम्मेदारी, संरचना और सीमाओं का ग्रह है; यह उन क्षेत्रों को दिखाता है जहाँ हम महारत पाना चाहते हैं और जीवन के सबक़ों का सामना करते हैं।

अज्ञात persona देने पर 400 INVALID_INPUT मिलता है, मान्य मानों की सूची के साथ, चुपचाप default नहीं।

अनुरोध और जवाब

cURL

curl -X POST https://api.astroway.info/v1/ai/chat \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Що означає моє положення Сатурна?",
    "chart": {
      "date": "1990-05-15",
      "time": "14:30:00",
      "timezoneOffset": 3,
      "latitude": 50.45,
      "longitude": 30.52
    },
    "persona": "plain",
    "language": "uk"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/ai/chat', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    message: 'Що означає моє положення Сатурна?',
    chart: { date: '1990-05-15', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
    persona: 'plain',
    language: 'uk',
  }),
});
const { data } = await r.json();
console.log(data.reply);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/ai/chat',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'message': 'Що означає моє положення Сатурна?',
        'chart': {'date': '1990-05-15', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.45, 'longitude': 30.52},
        'persona': 'plain',
        'language': 'uk',
    },
)
data = r.json()['data']
print(data['reply'])

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('ai/chat', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'message' => 'Що означає моє положення Сатурна?',
        'chart' => ['date' => '1990-05-15', 'time' => '14:30:00', 'timezoneOffset' => 3, 'latitude' => 50.45, 'longitude' => 30.52],
        'persona' => 'plain',
        'language' => 'uk',
    ],
]);
$data = json_decode($r->getBody(), true)['data'];
echo $data['reply'];

जवाब:

{
  "ok": true,
  "data": {
    "reply": "Ваш Сатурн знаходиться у знаку Козерога, у 5 домі, і є ретроградним.\n\n**Сатурн у Козерозі** означає, що Сатурн перебуває у своєму домі, де його енергії найсильніші. […] **Місяць у поєднанні з Сатурном (орб 1.7°)**: Це поєднання в Козерозі, у 5 домі, посилює серйозність ваших емоцій та потребу в безпеці.",
    "disclaimer": "Цей текст згенерований ШІ для розваги та саморефлексії. Не є медичною, юридичною чи фінансовою порадою.",
    "model": "gemini-2.5-flash",
    "language": "uk",
    "tokens": { "input": 1822, "output": 758 },
    "duration_ms": 6806,
    "persona": "plain"
  }
}

यहाँ reply छोटा किया गया है, बाक़ी फ़ील्ड जैसे हैं वैसे। model वह provider है जिसने जवाब दिया: chain अपने आप बदलती है, और उसका नाम जवाब में इसलिए है ताकि आप देख सकें कि आपके खाते ने किसके tokens गिने। अगर मॉडल token की सीमा तक पहुँच गया, तो जवाब आख़िरी पूरे वाक्य तक काटा जाता है और truncated: true जोड़ा जाता है, शब्द के बीच में नहीं टूटता।

कुंडली वैकल्पिक है

chart के बिना यह सामान्य ज्योतिष चैट है: कोई context नहीं, क़ीमत वही। chart के साथ यह किसी ख़ास व्यक्ति के बारे में जवाब देता है। 10 तक turns की history क्लाइंट भेजता है: हमारी तरफ़ कोई session नहीं है, इसलिए हर turn अपने आप में पूरा है और उसे processes के बीच ले जाया जा सकता है।

क़ीमत और सीमाएँ

एक turn की क़ीमत	100 क्रेडिट
अपनी provider key (BYOK)	प्रति turn 5 क्रेडिट, tokens आपके
Free टैरिफ़	टैरिफ़ की पाबंदी के बिना कॉल, हर महीने 10 000 क्रेडिट के भीतर
Sandbox keys aw_test_*	402, क्योंकि sandbox क्रेडिट ख़र्च नहीं करता, पर मॉडल पैसे ख़र्च करता है
एक जैसी body दोबारा	कैश से, x-cache: HIT, x-credits-used: 0
message	2000 अक्षरों तक, history 10 turns तक
भाषाएँ	21, पैरामीटर language

सावधानी

इस एंडपॉइंट पर अभी streaming नहीं है: जवाब पूरा एक साथ आता है। POST /v1/mcp/streaming SSE देता है, लेकिन वह भी पूरे जवाब का इंतज़ार करता है और उसे वाक्यों में काटता है, इसलिए पहला token आपको पहले नहीं दिखेगा।

पूरा reference अनुरोध की schema, error codes, उदाहरण

अपनी provider key X-Provider, X-Provider-Key, प्रति turn 5 क्रेडिट

टैरिफ़ हर प्लान पर महीने में कितने turns

AI एजेंट और MCP वही चैट एजेंट के टूल के रूप में