API AI-гороскопа

За знаком зодіаку та необов'язковою датою ендпоінт складає запит і маршрутизує його через наш LLM-шлюз до мовної моделі, яка пише короткий щоденний гороскоп. Відповідь несе згенерований текст гороскопа, застереження, яке слід показувати поряд із ним, ідентифікатор моделі, що створила текст, і мову виходу — локалізовану через параметр language з розумним значенням за замовчуванням, якщо його не вказано. Оскільки в ланцюжку стоїть мовна модель, цей ендпоінт поводиться інакше, ніж арифметичні та ефемеридні маршрути: він повільніший, зазвичай від однієї до трьох секунд, а текст є щойно згенерованим напуттям, а не відтворюваним обчисленням, тож два виклики з однаковими вхідними даними можуть повернути по-різному сформульовані трактування. Тижневий, місячний і річний гороскопи — споріднені ендпоінти з тим самим шлюзом і структурою.

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

Звертайтеся до нього, коли потрібен готовий до показу текст гороскопа без власного контентного конвеєра, який доводиться писати й підтримувати. Він пасує для поверхонь зі щоденним контентом — push-сповіщень, email-дайджестів, головних екранів застосунку, віджетів — де щойно сформульоване трактування на кожен знак щодня і є продуктом. Завжди показуйте повернуте застереження разом із текстом і запитуйте потрібну мову через параметр language замість перекладу на боці клієнта. Оскільки вихід недетермінований, а виклик несе латентність моделі, кешуйте кожне трактування за знаком і датою після першої генерації замість виклику при кожному перегляді, і закладайте оту секунду-три на відповідь при генерації на вимогу. Для довших горизонтів перемикайтеся на тижневий, місячний чи річний споріднені ендпоінти.

Це згенероване напуття, а не детерміноване обчислення — однакові вхідні дані можуть дати по-різному сформульований текст, а застереження у відповіді призначене для показу кінцевим користувачам. Поле model називає ту модель, яку обрав шлюз, і вона може змінюватися з часом. Латентність приблизно від однієї до трьох секунд очікувана, бо в ланцюжку запиту стоїть мовна модель; математичні ендпоінти відповідають значно швидше.