AI-Horoscope-API

Anhand eines Sternzeichens und eines optionalen Datums setzt der Endpunkt einen Prompt zusammen und leitet ihn über unser LLM-Gateway an ein Sprachmodell weiter, das ein kurzes Tageshoroskop schreibt. Die Antwort enthält den erzeugten Horoskoptext, einen Haftungsausschluss, der daneben anzuzeigen ist, die Kennung des Modells, das den Text erzeugt hat, und die Sprache der Ausgabe — lokalisiert über den language-Parameter, mit sinnvollem Standardwert, wenn er weggelassen wird. Da ein Sprachmodell im Pfad sitzt, verhält sich dieser Endpunkt anders als die arithmetischen und Ephemeriden-Routen: Er ist langsamer, typischerweise ein bis drei Sekunden, und der Text ist frisch erzeugte Orientierung statt einer reproduzierbaren Berechnung, sodass zwei Aufrufe mit identischen Eingaben unterschiedlich formulierte Deutungen zurückgeben können. Wochen-, Monats- und Jahreshoroskope sind Geschwister-Endpunkte, die dasselbe Gateway und dieselbe Form teilen.

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"
  }
}

Greifen Sie hierzu, wenn Sie anzeigefertigen Horoskoptext möchten, ohne Ihre eigene Content-Pipeline zu schreiben oder zu pflegen. Es eignet sich für tagesaktuelle Inhaltsflächen — Push-Benachrichtigungen, E-Mail-Digests, App-Startbildschirme, Widgets —, wo eine frisch formulierte Deutung pro Zeichen und Tag das Produkt ist. Rendern Sie stets den zurückgegebenen Haftungsausschluss zusammen mit dem Text und fordern Sie die benötigte Sprache über den language-Parameter an, statt clientseitig zu übersetzen. Da die Ausgabe nicht-deterministisch ist und der Aufruf Modell-Latenz mit sich bringt, cachen Sie jede Zeichen-und-Datum-Deutung nach der Erzeugung, statt bei jedem Seitenaufruf aufzurufen, und kalkulieren Sie bei On-Demand-Erzeugung die Antwortzeit von ein bis drei Sekunden ein. Für längere Horizonte wechseln Sie zu den Wochen-, Monats- oder Jahres-Geschwister-Endpunkten.

Dies ist erzeugte Orientierung, keine deterministische Berechnung — identische Eingaben können unterschiedlich formulierten Text ergeben, und der Haftungsausschluss in der Antwort ist dazu da, Endnutzern angezeigt zu werden. Das model-Feld benennt das jeweils vom Gateway gewählte Modell, das sich im Laufe der Zeit ändern kann. Eine Latenz von etwa ein bis drei Sekunden ist zu erwarten, da ein Sprachmodell im Anfragepfad liegt; die Mathematik-Endpunkte antworten weitaus schneller.