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

Цей ендпоінт генерує письмовий щоденний гороскоп для знака зодіаку на задану дату, звертаючись до нашого LLM-шлюзу. Він повертає текст гороскопа, застереження, модель, що його створила, і мову виходу. На відміну від обчислювальних ендпоінтів, це згенероване напуття, а не детермінований результат.

## Ендпоінт

`POST /v1/horoscope/daily`

- Operation ID: `horoscope/daily`
- Вартість: 50 кредитів (тариф 3)
- Типова латентність: 1245 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/ai-horoscope/

## Що обчислює

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

## Коли використовувати

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

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `sign` | string | yes | The zodiac sign to generate the horoscope for, e.g. "taurus". |
| `date` | string (YYYY-MM-DD) | no | An optional target date in YYYY-MM-DD format; defaults to the current day when omitted. |
| `language` | string | no | An optional ISO language code, e.g. "en" or "uk", controlling the language of the generated text. |

## Приклад запиту

```bash
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"
}'
```

## Приклад відповіді

```json
{
  "ok": true,
  "data": {
    "horoscope": "Today favours steady progress…",
    "disclaimer": "For entertainment purposes…",
    "model": "gemini-2.5-flash",
    "language": "en"
  }
}
```

## Нотатки

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

## Пов’язані техніки

- https://api.astroway.info/astrology-api/transits/
- https://api.astroway.info/astrology-api/natal-chart/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md