ИИ-резюме

Каждый расчёт возвращает десятки текстов интерпретаций. ИИ-резюме превращает самые значимые из них в несколько предложений о том, что гороскоп на самом деле означает для этого человека — или, в синастрии и композите, для двух людей вместе.

Резюме не создаётся во время расчёта. Расчёт выдаёт подписанную ссылку, и только её открытие запускает модель.

Требуемый модуль

Требуется модуль ai:summary, входящий в тарифы Premium и Deluxe. Отдельно он не продаётся.

Также нужны тексты интерпретаций того типа гороскопа, который ты резюмируешь (например natal:texts) — без текстов резюмировать нечего.

Как это работает

1. Ты вызываешь эндпоинт расчёта как обычно.
2. В ответе есть объект summary с подписанным URL.
3. Ты открываешь этот URL тогда — и если — тебе нужно резюме.

На шагах 1 и 2 ничего не рассчитывается, не сохраняется и не тарифицируется. Это сделано намеренно: вызов гороскопа не должен платить за функцию, которой большинство клиентов никогда не пользуется.

Ссылка на резюме

{
    "data": {
        "points": { "...": "..." },
        "aspects": [],
        "chart": { "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..." },
        "summary": {
            "url": "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3...",
            "method": "GET",
            "cost": 10,
            "expiresAt": "2026-08-30T10:00:00Z"
        }
    }
}

Поле	Описание
url	Подписанный URL, возвращающий резюме. Он несёт весь запрос, поэтому тело не нужно.
method	Всегда GET.
cost	Сколько запросов API списывается при генерации резюме. Резюме из кэша стоит 1.
expiresAt	Ссылка работает 7 дней. Для новой выполни расчёт заново.

Объект summary присутствует, только если подписка включает модуль. Если его нет — проверь свой тариф.

Сохраняй ссылку, а не только карту

Ссылка истекает через 7 дней и подписана ровно для одной карты. Изменить её нельзя: правка данных рождения, типа гороскопа или организации в URL делает подпись недействительной.

Получение резюме

curl "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3..." \
  -H "X-Api-Key: your-api-key"

Благодаря подписи ключ API необязателен, поэтому ссылка работает и из браузера, и из встраиваемого виджета, который не может задавать заголовки. Если ты всё же передаёшь ключ, он должен принадлежать той же организации, для которой ссылка была выдана.

Это занимает время

Генерация резюме заново выполняет расчёт, загружает тексты и обращается к языковой модели. Рассчитывай на несколько секунд. Уже сгенерированное резюме возвращается мгновенно.

Ответ

{
    "data": {
        "horoscopeType": "natal",
        "language": "ru",
        "summary": "Ты начинаешь с заметности, а не с осторожности: Солнце во Льве в десятом доме ставит работу и репутацию в центр того, как ты понимаешь себя…",
        "cached": false,
        "generatedAt": "2026-08-23T10:15:22Z",
        "model": "@cf/qwen/qwen3-30b-a3b-fp8",
        "highlights": [
            { "kind": "point", "label": "Sun in Leo in house 10" },
            { "kind": "point", "label": "Moon in Taurus in house 7" },
            { "kind": "aspect", "label": "Sun square Saturn (orb 0.4°)" }
        ]
    }
}

Поле	Описание
summary	Сгенерированный текст, от 4 до 6 предложений.
cached	true, если текст пришёл из кэша. Резюме из кэша считается за 1 запрос вместо 10.
highlights	Положения, на которых построено резюме, от самых сильных.
model	Модель, написавшая текст.

Поддерживаемые типы гороскопа

Тип	Эндпоинт	О чём резюме
natal	/api/calc/natal/summary	Кто этот человек
synastry	/api/calc/synastry/summary	Что эти двое делают друг с другом
composite	/api/calc/composite/summary	Отношения, которые они образуют вместе
transit	/api/calc/transit/summary	Предстоящий период
solar	/api/calc/solar-return/summary	Предстоящий год
lunar	/api/calc/lunar-return/summary	Предстоящий месяц
progressions	/api/calc/progressions/summary	Жизненный этап, в котором находится человек

Что попадает в резюме

Полная натальная карта даёт более 40 текстов интерпретаций. Отдать модели все — значит получить перечисление, а не разбор, и заплатить намного больше. Вместо этого положения оцениваются баллами, и остаются только самые сильные:

• Положения — светила и Асцендент весят больше всего, затем управитель карты, личные планеты и всё, что стоит в угловом доме.
• Аспекты — оцениваются по точности (насколько узок орб относительно максимума для этого аспекта), по мажорности аспекта и по тому, насколько личными являются оба его конца. Точный квадрат Солнце–Сатурн с большим отрывом обходит широкий секстиль Нептун–Плутон.
• Синастрия оставляет только межкартные аспекты, в обе стороны, с пометкой, чья планета действует на чью карту.
• Транзиты дополнительно включают дома, через которые проходят транзитные планеты.

Оценка детерминирована: одна и та же карта всегда даёт одну и ту же выборку — именно это позволяет кэшировать результат.

Модель может использовать только переданные ей тексты. Она не выдумывает положения, даты или советы, поэтому резюме отражает твои собственные тексты интерпретаций, включая отредактированные тобой в Content Editor.

Язык

Резюме пишется на языке расчёта. Передай language в запросе расчёта, и ссылка его сохранит:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": { "longitude": 4.89, "latitude": 52.37, "timezone": "Europe/Amsterdam" },
    "language": "ru",
    "includeText": true
  }'

Тексты интерпретаций уже локализованы, а модель получает указание писать на том же языке.

Сколько это стоит

Ситуация	Запросы API
Расчёт со ссылкой на резюме в ответе	1 (без изменений)
Ссылка открыта, резюме сгенерировано	10
Ссылка открыта, резюме уже в кэше	1
Запрос не удался (403, 422, просроченная ссылка)	0

Сгенерированные резюме кэшируются на 30 дней для каждой карты, языка и версии промпта, поэтому повторно открывать одну и ту же ссылку дёшево.

Заголовки ответа X-Quota-Limit, X-Quota-Remaining и X-Quota-Reset отражают взвешенную стоимость, как и отчётность по использованию в панели управления.

Ошибки

Статус	Значение
400	Ссылка повреждена или токен не относится к этому типу гороскопа.
401	Подпись недействительна или ссылка истекла.
403	В подписке нет ai:summary или текстов интерпретаций этого типа, либо ссылка принадлежит другой организации.
409	Резюме для этой карты уже генерируется. Повтори через несколько секунд — так ты не заплатишь дважды за один и тот же текст.
422	Для этой карты нет текстов интерпретаций, поэтому резюмировать нечего.

Дальше

• Контент и интерпретации — тексты, из которых пишется резюме
• Модули — что входит в твой тариф
• Ограничения запросов — квоты и взвешенные запросы