API Ωροσκοπίου AI

Δεδομένου ενός ζώδιου και μιας προαιρετικής ημερομηνίας, το endpoint συνθέτει ένα prompt και το στέλνει μέσω του LLM gateway μας σε ένα language model, το οποίο γράφει ένα σύντομο ημερήσιο ωροσκόπιο. Η απάντηση περιλαμβάνει το παραγόμενο κείμενο του ωροσκοπίου, μια disclaimer που εμφανίζεται μαζί του, το αναγνωριστικό του μοντέλου που το παρήγαγε, και τη γλώσσα του output – προσαρμοσμένη μέσω του language parameter, με λογική προεπιλογή όταν παραλείπεται. Επειδή ένα language model βρίσκεται στη διαδρομή, αυτό το endpoint συμπεριφέρεται διαφορετικά από τις arithmetic και ephemeris routes: είναι πιο αργό, συνήθως 1-3 δευτερόλεπτα, και το κείμενο είναι φρέσκο παραγόμενο guidance αντί για reproducible calculation, έτσι δύο κλήσεις με identical inputs μπορεί να επιστρέψουν διαφορετικά διατυπωμένα αποτελέσματα. Τα εβδομαδιαία, μηνιαία και ετήσια ωροσκόπια είναι sibling endpoints που μοιράζονται το ίδιο gateway και shape.

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sign": "taurus",
  "date": "2026-06-15",
  "language": "en"
}'

{
  "ok": true,
  "data": {
    "horoscope": "Today favours steady progress…",
    "disclaimer": "For entertainment purposes…",
    "model": "gemini-2.5-flash",
    "language": "en"
  }
}

Χρησιμοποίησέ το όταν θέλεις έτοιμο κείμενο ωροσκοπίου έτοιμο για εμφάνιση χωρίς να γράφεις ή να διαχειρίζεσαι τη δική σου ροή περιεχομένου. Ταιριάζει σε daily-content surfaces – push notifications, email digests, app home screens, widgets – όπου ένα φρέσκο διατυπωμένο ανάγνωση ανά ζώδιο ανά ημέρα είναι το προϊόν. Πάντα εμφάνισε το επιστρεφόμενο disclaimer μαζί με το κείμενο, και ζήτησε τη γλώσσα που χρειάζεσαι μέσω του language parameter αντί να το μεταφράζεις στην πλευρά του client. Επειδή το output είναι μη ντετερμινιστικό και η κλήση φέρνει model latency, cache κάθε ανάγνωση ζώδιου-ημερομηνίας μετά τη δημιουργία της αντί να καλείς σε κάθε προβολή σελίδας, και πρόγραμμάτισε για την απόκριση ενός-τριών δευτερολέπτων όταν παράγεται κατ' απαίτηση. Για μεγαλύτερες προοπτικές, άλλαξε στα weekly, monthly ή yearly sibling endpoints.

Αυτή είναι παραγόμενη καθοδήγηση, όχι μια ντετερμινιστική calculation – identical inputs μπορούν να δώσουν κείμενο με διαφορετική διατύπωση, και το disclaimer στην απάντηση υπάρχει για να εμφανίζεται στους τελικούς χρήστες. Το πεδίο model περιέχει το όνομα του μοντέλου που επέλεξε το gateway, το οποίο μπορεί να αλλάζει με τον χρόνο. Αναμένεται latency περίπου 1-3 δευτερολέπτων επειδή ένα language model βρίσκεται στη διαδρομή του αιτήματος· τα math endpoints ανταποκρίνονται πολύ πιο γρήγορα.