# राशिफल और AI-व्याख्या API

10 AI-एंडपॉइंट्स — AstroWay प्लेटफ़ॉर्म के 700+ एंडपॉइंट्स (16 श्रेणियों) का हिस्सा हैं। इनमें से 5 हॉरोस्कोप (दैनिक, साप्ताहिक, मासिक, वार्षिक, संगतता) और 5 व्याख्याओं (नैटल, सिनास्ट्री, ट्रांज़िट्स, तत्व, प्लेसमेंट) शामिल हैं। सभी वास्तविक Swiss Ephemeris गणनाओं (वही जो Solar Fire और Astrodienst में इस्तेमाल होते हैं) पर आधारित हैं — न कि टेम्प्लेट्स या LLM हैलुसिनेशन्स पर।

## यह कैसे काम करता है

1. API वास्तविक ज्योतिषीय चार्ट (ट्रांज़िट्स, नैटल, सिनास्ट्री) की गणना Swiss Ephemeris के माध्यम से करता है
2. परिणाम हमारे AI-gateway को भेजा जाता है, जो बाज़ार की शीर्ष मॉडल्स (Google Gemini → Groq Llama 3.3 → OpenRouter GPT-4 / Claude / DeepSeek → Cerebras → SambaNova → Mistral) पर काम करता है, जिसमें एक ज्योतिषीय system prompt और स्वचालित failover शामिल है
3. LLM सुरक्षा गार्डरेल्स (चिकित्सा/कानूनी/वित्तीय सलाह पर प्रतिबंध) के साथ टेक्स्ट उत्पन्न करता है
4. प्रतिक्रिया में disclaimer और audit trail शामिल होता है

<Aside type="tip">
AI-एंडपॉइंट्स गणनाओं और टेक्स्ट दोनों लौटाते हैं। आप केवल गणनाओं का उपयोग कर सकते हैं (सस्ते एंडपॉइंट्स) और अपने LLM से टेक्स्ट जनरेट कर सकते हैं।
</Aside>

## एंडपॉइंट्स — हॉरोस्कोप

| एंडपॉइंट | क्रेडिट्स | क्या जनरेट होता है |
|---|---|---|
| `/v1/horoscope/daily` | 20 | वर्तमान ट्रांज़िट्स पर आधारित दैनिक हॉरोस्कोप |
| `/v1/horoscope/weekly` | 20 | साप्ताहिक अवलोकन |
| `/v1/horoscope/monthly` | 20 | मासिक पूर्वानुमान |
| `/v1/horoscope/yearly` | 50 | वार्षिक पूर्वानुमान |
| `/v1/horoscope/compatibility` | 50 | संगतता विश्लेषण |

## एंडपॉइंट्स — व्याख्याएं

| एंडपॉइंट | क्रेडिट्स | क्या व्याख्या करता है |
|---|---|---|
| `/v1/interpret/natal` | 50 | नैटल चार्ट की पूर्ण व्याख्या |
| `/v1/interpret/synastry` | 50 | सिनास्ट्री की व्याख्या |
| `/v1/interpret/transits` | 50 | वर्तमान ट्रांज़िट्स की व्याख्या |
| `/v1/interpret/element` | 20 | एक अलग तत्व की व्याख्या (राशि में ग्रह, पहलू) |
| `/v1/interpret/placement` | 20 | प्लेसमेंट की व्याख्या (घर में ग्रह) |

## उदाहरण

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/horoscope/daily \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/horoscope/daily', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        timezoneOffset: 3,
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data: horoscope } = await r.json();
    console.log(horoscope.text);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/horoscope/daily',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'timezoneOffset': 3,
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
    )
    horoscope = r.json()['data']
    print(horoscope['text'])
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('horoscope/daily', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $horoscope = json_decode($r->getBody(), true)['data'];
    echo $horoscope['text'];
    ```
  </TabItem>
</Tabs>

## सुरक्षा गार्डरेल्स

सभी AI-एंडपॉइंट्स में अंतर्निहित सुरक्षा है:

- **System prompt** जिसमें चिकित्सा, कानूनी, वित्तीय सलाह पर स्पष्ट प्रतिबंध है
- **Auto-injected disclaimer** हर प्रतिक्रिया में शामिल
- **Content filter** — प्रमुख शब्दों पर पोस्ट-फ़िल्टरिंग
- **Audit trail** — 90 दिनों तक प्रतिक्रियाओं और प्रॉम्प्ट्स का लॉगिंग
- **`disclaimer_inline: true`** — उद्यम ग्राहकों के लिए पैरामीटर जो पहले से ही disclaimer के साथ टेक्स्ट चाहते हैं

<Aside type="caution">
AI-व्याख्याएं केवल मनोरंजन के उद्देश्यों के लिए हैं। ये पेशेवर ज्योतिषी, चिकित्सक, वकील या वित्तीय सलाहकार की सलाह का विकल्प नहीं हैं।
</Aside>

## कौन इस्तेमाल करता है

- **कंटेंट प्लेटफ़ॉर्म्स** — ऑडियंस के लिए दैनिक हॉरोस्कोप
- **ज्योतिष ऐप्स** — सामान्य टेक्स्ट के बजाय व्यक्तिगत व्याख्याएं
- **AI-एजेंट्स** — MCP सर्वर या सीधे API कॉल के माध्यम से
- **मीडिया** — वास्तविक डेटा के आधार पर ज्योतिषीय कंटेंट जनरेशन

## मूल्य

दैनिक हॉरोस्कोप — **20 क्रेडिट्स**। नैटल चार्ट की पूर्ण व्याख्या — **50 क्रेडिट्स**। Free प्लान में प्रति माह 250 दैनिक हॉरोस्कोप्स या 100 व्याख्याएं शामिल हैं।

<CardGrid>
  <LinkCard title="शीघ्र शुरुआत →" href="/getting-started/" description="पहला अनुरोध 5 मिनट में" />
  <LinkCard title="AI-एजेंट्स और MCP" href="/use-cases/ai-agents/" description="Claude, ChatGPT के साथ एकीकरण" />
  <LinkCard title="टैरिफ" href="/pricing/" description="Free से लेकर Enterprise तक" />
</CardGrid>