API horoskopů s umělou inteligencí

Na základě znamení zvěrokruhu a volitelného data endpoint sestaví prompt a směruje jej přes naši LLM bránu k jazykovému modelu, který napíše krátký denní horoskop. Odpověď obsahuje vygenerovaný text horoskopu, upozornění, které se má zobrazit spolu s ním, identifikátor modelu, který text vytvořil, a jazyk výstupu – lokalizovaný pomocí parametru jazyka, s rozumnou výchozí hodnotou, pokud je vynechán. Protože v cestě leží jazykový model, tento endpoint se chová odlišně od aritmetických a efemeridových cest: je pomalejší, typicky jednu až tři sekundy, a text je čerstvě generované vodítko, nikoli reprodukovatelný výpočet, takže dvě volání se stejnými vstupy mohou vrátit odlišně formulované výklady. Týdenní, měsíční a roční horoskopy jsou sourozenecké endpointy sdílející stejnou bránu a tvar.

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

Použij tento endpoint, když chceš hotový text horoskopu k zobrazení, aniž bys musel psát nebo udržovat vlastní obsahovou pipeline. Hodí se pro plochy s denním obsahem – push notifikace, e-mailové souhrny, domovské obrazovky aplikací, widgety – kde je produktem čerstvě formulovaný výklad pro každé znamení každý den. Vždy zobraz vrácené upozornění s textem a požaduj jazyk, který potřebuješ, pomocí parametru jazyka, namísto překládání na straně klienta. Protože výstup je nedeterministický a volání s sebou nese latenci modelu, cachuj každý výklad pro znamení a datum, jakmile je vygenerován, namísto volání při každém zobrazení stránky, a počítej s odezvou jedné až tří sekund při generování na vyžádání. Pro delší časové horizonty přepni na sourozenecké endpointy pro týdenní, měsíční nebo roční horoskopy.

Jedná se o generované vodítko, nikoli o deterministický výpočet – identické vstupy mohou vést k odlišně formulovanému textu a upozornění v odpovědi je určeno k zobrazení koncovým uživatelům. Pole modelu pojmenovává model, který brána vybrala, což se může časem měnit. Očekává se latence zhruba jedné až tří sekund, protože v cestě požadavku je jazykový model; matematické endpointy reagují mnohem rychleji.