AI Horoscoop API

Gegeven een sterrenbeeld en een optionele datum, composeert de endpoint een prompt en stuurt deze via onze LLM gateway naar een taalmodel, dat een korte daghoroscoop schrijft. Het antwoord bevat de gegenereerde horoscooptekst, een disclaimer die erbij moet worden getoond, de identifier van het model dat de tekst heeft geproduceerd, en de taal van de output - gelokaliseerd via de taalparameter, met een redelijke standaardwaarde wanneer deze wordt weggelaten. Omdat een taalmodel in de pad zit, gedraagt deze endpoint zich anders dan de rekenkundige en efeemisroutes: het is langzamer, typisch één tot drie seconden, en de tekst is vers gegenereerd advies in plaats van een reproduceerbare berekening, dus twee oproepen met identieke invoer kunnen verschillend geformuleerde lezingen retourneren. Wekelijkse, maandelijkse en jaarlijkse horoscopen zijn sibling endpoints die dezelfde gateway en vorm delen.

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

Gebruik dit wanneer je klaar-om-te-tonen horoscooptekst wilt zonder zelf een content pipeline te schrijven of te onderhouden. Het is geschikt voor dagelijkse content-oppervlakken - pushmeldingen, e-mail samenvattingen, app startschermen, widgets - waar een vers geformuleerde lezing per sterrenbeeld per dag het product is. Render altijd de geretourneerde disclaimer met de tekst, en vraag de taal die je nodig hebt via de taalparameter in plaats van client-side te vertalen. Omdat de output niet-deterministisch is en de oproep modellatentie met zich meebrengt, cache elke sterrenbeeld-en-datum lezing nadat deze is gegenereerd in plaats van bij elke paginaweergave te bellen, en plan voor de één-tot-drie-seconden reactie bij het genereren op aanvraag. Voor langere tijdspannes, schakel over naar de wekelijkse, maandelijkse of jaarlijkse sibling endpoints.

Dit is gegenereerd advies, geen deterministische berekening - identieke invoer kunnen verschillend geformuleerde tekst opleveren, en de disclaimer in het antwoord is er om aan eindgebruikers te worden getoond. Het modelveld noemt welk model de gateway heeft geselecteerd, wat in de tijd kan variëren. Latentie van ongeveer één tot drie seconden wordt verwacht omdat een taalmodel in de aanvraagpad zit; de wiskunde endpoints reageren veel sneller.