# API ωροσκοπίων και AI-ερμηνειών

10 AI endpoints — μέρος των 700+ endpoints της πλατφόρμας AstroWay (16 κατηγορίες). 5 για гороσκόπια (ημερήσια, εβδομαδιαία, μηνιαία, ετήσια, συμβατότητα) και 5 για ερμηνείες (νατάλ, συναστρία, μεταβάσεις, στοιχεία, τοποθετήσεις). Όλα βασίζονται σε πραγματικούς υπολογισμούς του Swiss Ephemeris (αυτό που χρησιμοποιούν το Solar Fire και το Astrodienst) — όχι σε πρότυπα ή σε ψευδαισθήσεις καθαρών LLM.

## Πώς λειτουργεί

1. Το API υπολογίζει έναν πραγματικό αστρολογικό χάρτη (μεταβάσεις, νατάλ, συναστρία) μέσω του Swiss Ephemeris
2. Το αποτέλεσμα αποστέλλεται στην πύλη AI μας πάνω από τις κορυφαίες αγορές μοντέλων (Google Gemini → Groq Llama 3.3 → OpenRouter με GPT-4 / Claude / DeepSeek → Cerebras → SambaNova → Mistral) με ένα αστρολογικό system prompt και αυτόματο failover
3. Το LLM παράγει κείμενο με ενσωματωμένα safety guardrails (απαγόρευση ιατρικών/νομικών/οικονομικών συμβουλών)
4. Η απάντηση περιλαμβάνει disclaimer και audit trail

<Aside type="tip">
Τα AI endpoints επιστρέφουν τόσο τους υπολογισμούς όσο και το κείμενο. Μπορείς να χρησιμοποιήσεις μόνο τους υπολογισμούς (φθηνότερα endpoints) και να παράγεις το κείμενο με το δικό σου LLM.
</Aside>

## Endpoints — гороσκόπια

| Endpoint | Πιστώσεις | Τι παράγει |
|---|---|---|
| `/v1/horoscope/daily` | 20 | Ημερήσιο гороσκόπιο βασισμένο στις τρέχουσες μεταβάσεις |
| `/v1/horoscope/weekly` | 20 | Εβδομαδιαία επισκόπηση |
| `/v1/horoscope/monthly` | 20 | Μηνιαία πρόβλεψη |
| `/v1/horoscope/yearly` | 50 | Ετήσια πρόβλεψη |
| `/v1/horoscope/compatibility` | 50 | Κειμενική ανάλυση συμβατότητας |

## Endpoints — ερμηνείες

| Endpoint | Πιστώσεις | Τι ερμηνεύει |
|---|---|---|
| `/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>

## Safety guardrails

Όλα τα AI endpoints διαθέτουν ενσωματωμένη προστασία:

- **System prompt** με σαφή απαγόρευση ιατρικών, νομικών, οικονομικών συμβουλών
- **Auto-injected disclaimer** σε κάθε απάντηση
- **Content filter** — μετα-φιλτράρισμα για συγκεκριμένες λέξεις-κλειδιά
- **Audit trail** — καταγραφή των prompts και των απαντήσεων (διάρκεια 90 ημερών)
- **`disclaimer_inline: true`** — παράμετρος για enterprise πελάτες που θέλουν κείμενο ήδη με disclaimer

<Aside type="caution">
Οι AI ερμηνείες προορίζονται για ψυχαγωγικούς σκοπούς. Δεν υποκαθιστούν τη συμβουλή ενός επαγγελματία αστρολόγου, γιατρού, δικηγόρου ή οικονομικού συμβούλου.
</Aside>

## Ποιοι το χρησιμοποιούν

- **Πλατφόρμες περιεχομένου** — ημερήσια гороσκόπια για το κοινό τους
- **Εφαρμογές αστρολογίας** — εξατομικευμένες ερμηνείες αντί για γενικά κείμενα
- **AI agents** — μέσω του MCP server ή απευθείας κλήση API
- **ΜΜΕ** — παραγωγή αστρολογικού περιεχομένου βασισμένο σε πραγματικά δεδομένα

## Κόστος

Το ημερήσιο гороσκόπιο κοστίζει **20 πιστώσεις**. Η πλήρης ερμηνεία νατάλ χάρτη κοστίζει **50 πιστώσεις**. Στο δωρεάν πρόγραμμα παρέχονται 250 ημερήσια гороσκόπια ή 100 ερμηνείες ανά μήνα.

<CardGrid>
  <LinkCard title="Γρήγορη εκκίνηση →" href="/getting-started/" description="Το πρώτο σου αίτημα σε 5 λεπτά" />
  <LinkCard title="AI agents & MCP" href="/use-cases/ai-agents/" description="Ενσωμάτωση με Claude, ChatGPT" />
  <LinkCard title="Πρόγραμμα τιμών" href="/pricing/" description="Από δωρεάν έως Enterprise" />
</CardGrid>