API horoskopu AI

Mając znak zodiaku i opcjonalną datę, endpoint komponuje prompt i kieruje go przez naszą bramę LLM do modelu językowego, który pisze krótki horoskop dzienny. Odpowiedź niesie wygenerowany tekst horoskopu, zastrzeżenie do wyświetlenia obok niego, identyfikator modelu, który wyprodukował tekst, oraz język wyniku — zlokalizowany przez parametr language, z sensownym domyślnym ustawieniem przy pominięciu. Ponieważ na ścieżce siedzi model językowy, ten endpoint zachowuje się inaczej niż trasy arytmetyczne i efemerydalne: jest wolniejszy, zwykle od jednej do trzech sekund, a tekst to świeżo wygenerowana porada, a nie odtwarzalne obliczenie, więc dwa wywołania z identycznymi danymi wejściowymi mogą zwrócić odmiennie sformułowane odczyty. Horoskopy tygodniowe, miesięczne i roczne to endpointy siostrzane dzielące tę samą bramę i postać.

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

Sięgnij po to, gdy chcesz gotowego do wyświetlenia tekstu horoskopu bez pisania lub utrzymywania własnego potoku treści. Pasuje do powierzchni z codzienną treścią — powiadomień push, podsumowań e-mail, ekranów głównych aplikacji, widżetów — gdzie świeżo sformułowany odczyt na znak na dzień jest produktem. Zawsze renderuj zwrócone zastrzeżenie wraz z tekstem i żądaj potrzebnego języka przez parametr language, zamiast tłumaczyć po stronie klienta. Ponieważ wynik jest niedeterministyczny, a wywołanie niesie opóźnienie modelu, buforuj każdy odczyt znak-i-data raz wygenerowany, zamiast wywoływać przy każdym wyświetleniu strony, i przewidź czas odpowiedzi od jednej do trzech sekund przy generowaniu na żądanie. Dla dłuższych horyzontów przełącz się na siostrzane endpointy tygodniowe, miesięczne lub roczne.

To generowana porada, a nie deterministyczne obliczenie — identyczne dane wejściowe mogą dać odmiennie sformułowany tekst, a zastrzeżenie w odpowiedzi jest po to, by pokazać je użytkownikom końcowym. Pole model nazywa ten model, który wybrała brama, co może zmieniać się w czasie. Opóźnienie rzędu jednej do trzech sekund jest oczekiwane, ponieważ na ścieżce żądania siedzi model językowy; endpointy matematyczne odpowiadają znacznie szybciej.