API Horoscop AI

Dat un semn zodiacal și o dată opțională, endpoint-ul compune un prompt și îl ruthează prin gateway-ul nostru LLM către un model de limbaj, care scrie un horoscop zilnic scurt. Răspunsul conține textul horoscopului generat, o declarație de nevinovăție care trebuie afișată împreună cu el, identificatorul modelului care a produs textul și limba de ieșire - localizată prin parametrul de limbaj, cu o valoare implicită rezonabilă când este omis. Deoarece un model de limbaj se află în cale, acest endpoint se comportă diferit față de rutele aritmetice și eferide: este mai lent, de obicei una până la trei secunde, iar textul este îndrumare proaspăt generată nu o calculare reproducibilă, așadar două apeluri cu intrări identice pot returna citiri cu formulări diferite. Horoscopurile săptămânale, lunare și anuale sunt endpoint-uri surori care partajează același gateway și formă.

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

Folosește acest endpoint când dorești text de horoscop gata de afișare fără a scrie sau întreține propriul tău pipeline de conținut. Se potrivește pentru suprafețe cu conținut zilnic - notificări push, rezumate email, ecrane de start ale aplicațiilor, widget-uri - unde o citire cu formulare proaspete pe semn pe zi este produsul. Afișează mereu declarația de nevinovăție returnată împreună cu textul și solicită limba de care ai nevoie prin parametrul de limbaj în loc să traduci pe client. Deoarece ieșirea este nedeterministă și apelul are latența modelului, cachează fiecare citire pe semn și dată odată generată în loc să apelezi la fiecare vizualizare a paginii, și planifică pentru răspunsul de una până la trei secunde când generezi la cerere. Pentru orizonte mai lungi, trece la endpoint-urile surptămânale, lunare sau anuale.

Aceasta este îndrumare generată, nu o calculare deterministă - intridentice pot produce text cu formulări diferite, iar declarația de nevinovăție din răspuns este acolo pentru a fi afișată utilizatorilor finali. Câmpul model numește modelul selectat de gateway, care poate varia în timp. Se așteaptă o latență de aproximativ una până la trei secunde deoarece un model de limbaj se află în calea cererii; endpoint-urile matematice răspund mult mai repede.