AI chat πάνω σε πραγματικό χάρτη

Ένα συνηθισμένο LLM απαντά σε μια ερώτηση για τον Κρόνο από όσα θυμάται για το ζώδιο. Το POST /v1/ai/chat απαντά από τον χάρτη που μόλις υπολογίσαμε: θέση, οίκος, όψεις με orbs και παράθυρα διελεύσεων για τους επόμενους έξι μήνες. Η διαφορά φαίνεται από την πρώτη απάντηση: όχι “ο Κρόνος στον Αιγόκερω σημαίνει πειθαρχία”, αλλά “ο Κρόνος στον Αιγόκερω 25.2° ανάδρομος, 5ος οίκος, σύνοδος με τη Σελήνη με orb 1.7°”.

Δοκίμασέ το χωρίς κλειδί

Το demo λειτουργεί με έναν σταθερό χάρτη, 5 ερωτήσεις ανά διεύθυνση την ημέρα, με το ίδιο system prompt που έχει και το επί πληρωμή endpoint. Δεν χρειάζεται κλειδί.

Τι βλέπει το μοντέλο

Το demo επιστρέφει το πεδίο context: είναι ολόκληρο το μπλοκ που μπήκε στο prompt. Ορίστε πώς ήταν στις 2 Σεπτεμβρίου 2026 για τον χάρτη του demo (οι διελεύσεις υπολογίζονται ξανά σε κάθε αίτημα, οπότε η λίστα των παραθύρων αύριο θα είναι διαφορετική):

## 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 παράθυρα διελεύσεων. Το ίδιο μπλοκ συντίθεται για το επί πληρωμή endpoint από τον χάρτη που στέλνεις εσύ.

Τι χρονολογεί και τι όχι

Το system prompt μας επιτρέπει να αναφέρονται μήνες για τις διελεύσεις που υπάρχουν στο παραπάνω μπλοκ και απαγορεύει τη χρονολόγηση ενός γεγονότος. Στην ερώτηση “πότε θα παντρευτώ” το endpoint απαντά έτσι (απόσπασμα πραγματικής απάντησης στα ουκρανικά από τις 2 Σεπτεμβρίου 2026, σε μετάφραση):

Ο διερχόμενος Κρόνος σχηματίζει σύνοδο με τη γενέθλια Αφροδίτη σας. Αυτή η διέλευση θα είναι ενεργή για αρκετούς μήνες: τον Σεπτέμβριο, τον Οκτώβριο, τον Νοέμβριο, τον Δεκέμβριο του 2026, καθώς και τον Ιανουάριο, τον Φεβρουάριο και τον Μάρτιο του 2027, φτάνοντας στο πιο στενό orb τον Μάρτιο του 2027.

Οι ημερομηνίες εδώ δεν είναι επινοημένες: είναι η γραμμή transiting Saturn Conjunction natal Venus από το μπλοκ του context. Ημερομηνία γάμου δεν υπάρχει στην απάντηση και δεν θα υπάρξει.

Σημείωση

Αν χτίζεις ένα προϊόν όπου εσύ είσαι υπεύθυνος για την απάντηση, αυτό το όριο δουλεύει υπέρ σου: μια χρονολογημένη πρόβλεψη γεγονότος από ξένο μοντέλο μέσα στο δικό σου interface είναι δικός σου κίνδυνος, όχι δικός μας. Χρειάζεσαι ακριβές παράθυρο αντί για μήνα: /v1/transit-calendar.

Περσόνες

Το persona αλλάζει τη φωνή, όχι τα δεδομένα. Οι τιμές είναι κλειστή λίστα, γιατί η συμβολοσειρά από το body του αιτήματος καταλήγει στο system prompt.

persona	Φωνή
astrologer	προεπιλογή, όπως απαντούσε το endpoint πριν εμφανιστεί η παράμετρος
plain	χωρίς περσόνα, χαιρετισμό και υπογραφή
coach	υποστήριξη και τι να κάνεις με αυτό
teacher	ονομάζει την τεχνική και εξηγεί τους όρους

Ερώτηση “Περίγραψε τον Κρόνο μου σε μία παράγραφο”, persona: "coach":

Ο Κρόνος σας βρίσκεται στο ζώδιο του Αιγόκερω, που είναι η δική του κατοικία, και επιπλέον είναι ανάδρομος, τοποθετημένος στον 5ο οίκο. Αυτό δείχνει μια βαθιά ριζωμένη επιθυμία για δομή, πειθαρχία και δεξιοτεχνία, ιδιαίτερα στους τομείς που σχετίζονται με την αυτοέκφραση, τη δημιουργικότητα, τον έρωτα και τα παιδιά.

persona: "teacher":

Στον γενέθλιο χάρτη σας ο Κρόνος βρίσκεται στον Αιγόκερω 25.2° (R) στον 5ο οίκο. Ο Κρόνος είναι ο πλανήτης της πειθαρχίας, της ευθύνης, της δομής και των περιορισμών. Δείχνει τους τομείς όπου επιδιώκουμε τη δεξιοτεχνία και συναντάμε τα μαθήματα της ζωής.

Μια άγνωστη περσόνα δίνει 400 INVALID_INPUT με τη λίστα των επιτρεπτών τιμών, όχι μια σιωπηλή προεπιλογή.

Αίτημα και απάντηση

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 που απάντησε: η αλυσίδα αλλάζει μόνη της, και το όνομά του είναι στην απάντηση ώστε να βλέπεις ποιανού τα tokens μέτρησε ο λογαριασμός σου. Αν το μοντέλο έφτασε στο ανώτατο όριο tokens, η απάντηση κόβεται στην τελευταία ολοκληρωμένη πρόταση και προστίθεται truncated: true, αντί να σπάσει στη μέση μιας λέξης.

Ο χάρτης είναι προαιρετικός

Χωρίς chart είναι ένα κανονικό αστρολογικό chat: δεν υπάρχει context, η τιμή είναι η ίδια. Με chart απαντά για ένα συγκεκριμένο πρόσωπο. Το history έως 10 γύρων το στέλνει ο client: δεν υπάρχουν sessions από τη μεριά μας, οπότε κάθε γύρος είναι αυτάρκης και μπορεί να μεταφερθεί ανάμεσα σε διεργασίες.

Τιμή και όρια

Τιμή ανά γύρο	100 credits
Δικό σου κλειδί provider (BYOK)	5 credits ανά γύρο, τα tokens είναι δικά σου
Πλάνο Free	καλείται χωρίς περιορισμούς πλάνου, εντός των 10 000 credits τον μήνα
Κλειδιά sandbox aw_test_*	402, γιατί το sandbox δεν ξοδεύει credits, ενώ το μοντέλο ξοδεύει χρήματα
Επανάληψη πανομοιότυπου body	από την cache, x-cache: HIT, x-credits-used: 0
message	έως 2000 χαρακτήρες, history έως 10 γύρους
Γλώσσες	21, παράμετρος language

Προσοχή

Streaming σε αυτό το endpoint δεν υπάρχει ακόμη: η απάντηση έρχεται ολόκληρη. Το POST /v1/mcp/streaming επιστρέφει SSE, αλλά κι αυτό περιμένει την πλήρη απάντηση και την κόβει σε προτάσεις, οπότε δεν θα δεις το πρώτο token νωρίτερα.

Πλήρης αναφορά Σχήμα αιτήματος, κωδικοί σφάλματος, παραδείγματα

Δικό σου κλειδί provider X-Provider, X-Provider-Key, 5 credits ανά γύρο

Πλάνα Πόσοι γύροι τον μήνα σε κάθε πλάνο

AI agents και MCP Το ίδιο chat ως εργαλείο agent