Что такое Astrology Chat API и чем он отличается от обычного чат-бота?

Astrology Chat API - это агентная платформа, а не просто обёртка над чат-ботом. Когда вы отправляете сообщение, сервер автономно решает, какие из 16 астрологических инструментов вызвать (натальные карты, транзиты, синастрия и т.д.), выполняет их на наших 82 расчётных эндпоинтах и синтезирует обоснованный ответ. В отличие от обычных чат-ботов, которые галлюцинируют астрологические данные, каждая интерпретация подкреплена реальными вычислениями эфемерид. Весь цикл агента выполняется на сервере в одном API-вызове.

Могу ли я использовать OpenAI SDK на Python или TypeScript с этим API?

Да - это основной принцип проектирования. Мы реализуем стандартный протокол OpenAI /chat/completions, поэтому вы используете официальный OpenAI SDK на любом языке: TypeScript (пакет openai npm), Python (пакет openai pip), Go, Rust или любой HTTP-клиент. Просто измените base URL на наш эндпоинт. Ваш существующий код для OpenAI работает с минимальными изменениями. Это также означает мгновенную совместимость с LangChain, Vercel AI SDK и любым OpenAI-совместимым фреймворком.

Какие LLM-модели поддерживаются с BYOK?

BYOK поддерживает три провайдера с 50+ моделями. OpenAI: GPT-5, GPT-5-mini, GPT-5-nano, семейства o3, o4. Anthropic: Claude Opus 4, Sonnet 4, Haiku 4. OpenRouter: любая модель, которую они хостят - Gemini 3, Grok 4, Llama, Mistral, Qwen и другие. Вы передаёте свой API-ключ и ID модели. Платформа автоматически обрабатывает все провайдер-специфичные особенности (например, различия параметров reasoning-моделей).

Сколько кредитов стоит каждый ход чата?

Стоимость каждого хода складывается из трёх компонентов. 1) Плата за платформу: Hosted - 25 кредитов/ход (LLM включён), BYOK - 2 кредита/ход. 2) Кредиты за endpoint: каждый вызов инструмента тарифицируется как обычный API-запрос (например, natal = 1 кредит, synastry = 2 кредита). 3) Расходы на LLM (только BYOK): оплата напрямую вашему провайдеру за токены. Пример: агент вызывает natal endpoint для интерпретации. Hosted: 25 + 1 = 26 кредитов (~$0.02 на тарифе Professional, $37/месяц, 55 000 кредитов). BYOK: 2 + 1 + расходы LLM = 3 кредита (~$0.002) + стоимость токенов провайдера. Альтернативы берут $0.25-$0.87 за запрос. Бесплатный тариф включает 50 запросов/месяц - достаточно для разработки и тестирования.

Как работает мультисубъектный чат для синастрии и совместимости?

Передайте несколько субъектов в массиве astrology.subjects, каждый с семантическим ID ('me', 'partner', 'child') и данными рождения. LLM ссылается на субъектов по ID при вызове инструментов - сервер разрешает ID в полные координаты рождения. Это позволяет проводить синастрию, строить композитные карты и многоперсональный анализ в одном разговоре. Ни одно конкурентное решение не поддерживает более одного субъекта за сессию.

Может ли чат генерировать PDF-отчёты и SVG-изображения карт?

Да - бинарные артефакты это уникальная функция. Попросите 'Сгенерируй мою натальную карту', и агент вызовет инструмент render_natal, создаст SVG (или PNG/PDF), сохранит его как артефакт и вернёт URL для совместного доступа. То же самое для PDF натальных отчётов - многостраничные профессиональные документы с визуализацией колеса, интерпретациями и темами. Артефакты хранятся в Supabase с 24-часовым хранением и URL для совместного доступа.

Насколько быстр Astrology Chat API по сравнению с альтернативами?

Наш слой расчётов отвечает менее чем за 300мс на вызов инструмента. Общее время ответа (расчёт + генерация LLM) обычно 2-5 секунд со стримингом. Конкурентные решения для астрологических чатов в среднем отвечают за 8-24 секунды даже на премиум-тарифах. Со стримингом наши пользователи видят первые токены менее чем за 2 секунды, пока агент продолжает работать.

Что такое расширенные события SSE-стриминга?

Помимо стандартных текстовых чанков OpenAI, мы отправляем кастомные SSE-события: tool_start (когда агент начинает вызывать инструмент - ваш UI может показать 'Рассчитываю натальную карту...'), tool_end (когда инструмент завершил работу - с временем выполнения) и astrology.error (если инструмент завершился с ошибкой). Это позволяет создавать насыщенные UI реального времени, показывающие процесс рассуждений агента.

Как работают сессии и память разговора?

Передайте astrology.session_id в вашем запросе. При первом ходе сервер создаёт сессию на Redis. При последующих ходах с тем же ID сервер загружает предыдущие сообщения и субъектов перед обработкой нового сообщения. Сессии имеют скользящий TTL 24 часа - каждое взаимодействие продлевает окно. Сервер обрабатывает сжатие сообщений для длинных разговоров, поэтому вам не нужно управлять контекстными окнами.

Какие языки программирования и фреймворки поддерживаются?

Подойдёт любой язык с HTTP-клиентом, но OpenAI SDK обеспечивают лучший опыт: TypeScript/JavaScript (openai), Python (openai), Go (openai-go), Rust, C#, Java, PHP, Ruby. Совместимость с фреймворками: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI, Haystack - всё, что говорит на протоколе OpenAI. Большинство разработчиков интегрируются менее чем за 30 минут.

Это просто обёртка над GPT или используются реальные астрономические данные?

Каждая астрологическая интерпретация основана на реальных вычислениях эфемерид. Когда агент вызывает charts_natal, он рассчитывает фактические планетарные позиции с помощью Swiss Ephemeris - того же движка, который используется в профессиональном астрологическом ПО. LLM получает реальные данные карты (позиции планет, расположение по домам, аспекты с точными орбисами) и синтезирует интерпретации на их основе. Никаких галлюцинированных планетарных позиций, никаких выдуманных аспектов.

Как контролировать стиль и длину ответа?

Три уровня контроля: 1) Системное сообщение - задайте любую личность ('тёплый юнгианский психолог', 'лаконичный британский классик' и т.д.). 2) astrology.defaults.detail_level - 'brief' (до 100 слов), standard (200-350 слов) или 'detailed' (500-800 слов). 3) astrology.defaults.tradition - classical, psychological, event-oriented или universal. Явная инструкция пользователя ('кратко' или 'подробно') перекрывает всё.

Какие астрологические традиции и системы домов поддерживаются?

Четыре традиции интерпретации: Классическая (эллинистическая/средневековая), Психологическая (юнгианская), Событийная (хорарная/элективная) и Универсальная (сбалансированная). Двадцать три системы домов, включая Плацидус, Кох, Целые знаки, Равную, Кампанус, Региомонтанус, Порфирий и другие. Устанавливается через astrology.defaults.house_system - сервер применяет настройку ко всем вызовам инструментов автоматически.

Можно ли использовать это как white-label продукт?

Безусловно. Системный промпт (messages[0] с role='system') контролирует всю личность. Задайте голос бренда, персону астролога, языковой стиль - пользователь никогда не увидит наш брендинг. BYOK даёт контроль над расходами. Персистентность сессий обеспечивает модели подписки. Стандартные тарифные планы поддерживают коммерческое распространение.

Что происходит, если вызов инструмента завершается ошибкой во время разговора?

Мягкая деградация. Если инструмент возвращает ошибку (некорректные данные рождения, неподдерживаемый расчёт), агент получает сообщение об ошибке и адаптируется - может попробовать другой инструмент, запросить у пользователя уточнение или предоставить частичный ответ. Со стримингом вы получаете событие astrology.error. Разговор не падает; LLM обрабатывает ошибки в разговорном режиме, как это сделал бы живой астролог.

Можно ли создать астрологический виджет с помощью Lovable, Claude Code или Cursor?

Да, и это одно из главных преимуществ нашего API. Поскольку Astrology Chat API использует стандартный протокол OpenAI Chat Completions, любой ИИ-инструмент для кода — Lovable, Claude Code, Cursor, Windsurf — уже знает, как с ним работать. Вам не нужно объяснять формат запросов или загружать документацию: просто опишите, что хотите построить. Например, промпт «Создай React-компонент астрологического чата с SSE-стримингом через OpenAI SDK» выдаст рабочий код с первой попытки. Разработчики уже собирают Telegram-ботов, Streamlit-дашборды и Next.js-виджеты за один вечер. Это и есть vibe coding — вы описываете идею, ИИ пишет код, а стандартный протокол гарантирует, что интеграция заработает сразу.

Чем Astrology Chat API отличается от создания собственного решения на основе сырых API-эндпоинтов?

API с сырыми данными предоставляют только расчётный JSON - вы строите весь агентный слой самостоятельно: схемы инструментов, оркестрация LLM, обработка ошибок, управление сессиями, хранение артефактов. Это месяцы инженерной работы. Наша платформа поставляет всё это готовым. Один API-вызов заменяет сотни строк кода агентного фреймворка. Если вы уже используете LangChain или CrewAI, наш эндпоинт подключается как единый инструмент - ваш существующий агентный фреймворк обрабатывает остальное.

НОВИНКА: ИИ-агентная платформа

Больше, чем чат. Создавайте ИИ-агентов астрологии

Единственная OpenAI-совместимая агентная платформа для астрологии.

16 серверных инструментов, BYOK-выбор модели, SSE-стриминг, мультисубъектные сессии. Один API-вызов - полный цикл агента.

Документация API

Инструментов агента

Эндпоинтов внутри

Языков

<2с

Общее время ответа

Замена OpenAI SDK

Bring Your Own Key

Серверный цикл агента

Агент в действии

Реальные диалоги на базе серверной оркестрации инструментов

Astrology Chat APILive Demo

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.astrology-api.io/api/v3/chat",
  apiKey: "your-astrology-api-key",
});

const response = await client.chat.completions.create({
  model: "astro-default",
  stream: true,
  messages: [
    { role: "system", content: "Warm, insightful astrologer." },
    { role: "user", content: "Analyze my natal chart" }
  ],
  astrology: {
    subjects: [{ id: "me", birth_data: {
        year: 1990, month: 3, day: 15,
        hour: 14, minute: 30,
        city: "New York", country_code: "US"
      } }],
    enabled_tools: ["charts_natal"],
    defaults: { language: "ru", tradition: "psychological" }
  }
} as any);

for await (const chunk of response) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

Работает с любым из 16 наших endpoint или их комбинациями

Vedic Jyotish

Хорарные вопросы

Human Design

Astrocartography

Нумерология

Tarot Reading

Синастрия отношений

Транзитный прогноз

Любая комбинация endpoint в одной сессии — natal, Vedic, horary, BaZi, astrocartography и другие.Hosted: 25 + кредиты endpoint/ход · BYOK: 2 + кредиты endpoint + расходы LLM

Привязка к неизвестным проприетарным моделям без выбора и прозрачности
Кастомные JSON API, требующие уникального кода интеграции для каждой платформы
Создавайте свой цикл инструментов: парсинг эндпоинтов, управление состоянием, обработка ошибок
8-24 секунды ответа - большинство решений мучительно медленные
$0.25-$0.87 за ИИ-запрос на конкурентных платформах - расходы растут лавинообразно

Трансформируйте с

BYOK: выбирайте GPT-5, Claude 4, Gemini 3, Grok или любую модель OpenRouter
Замена OpenAI SDK - работает с LangChain, Vercel AI SDK, любым клиентом
Серверный цикл агента: 16 инструментов вызываются автоматически, субъекты разрешаются, артефакты генерируются
Субсекундные расчёты + скорость LLM - 2-5с итого против 8-24с у конкурентов
Hosted: 25 кредитов/ход (LLM включён) · BYOK: 2 кредита/ход + ваши расходы на LLM · + кредиты за endpoint на каждый вызов инструмента

Производительность платформы

Корпоративная скорость, дружелюбные цены для разработчиков

Инструменты агента

<300мс

Скорость расчётов

Языки

50+

LLM-модели

Полный набор функций агентной платформы

Всё необходимое для создания ИИ-астрологических приложений

Bring Your Own Key (BYOK)

SSE-стриминг и события

16 автогенерируемых инструментов агента

Мультисубъект и сессии

Готов для Виджетов с ИИ-Инструментами для Кода

Бинарные артефакты и вывод

Что такое Astrology Chat API? Полное руководство для разработчиков

Всё, что нужно для создания ИИ-астрологических приложений

Что если можно добавить полнофункционального ИИ-агента астрологии в ваше приложение одним API-вызовом? Именно это делает Astrology Chat API. Это не просто эндпоинт чат-бота - это полноценная агентная платформа, которая выполняет весь цикл вызова инструментов на сервере. Вы отправляете сообщение пользователя, а сервер автономно решает, какие из 16 астрологических инструментов вызвать, разрешает данные натальной карты по ID субъектов (без галлюцинаций дат), генерирует PDF-отчёты или SVG-карты как бинарные артефакты и возвращает связный ответ - всё через OpenAI-совместимый эндпоинт /chat/completions. Это значит, что вы можете использовать стандартный OpenAI SDK на TypeScript, Python, Go или любом другом языке. Никакого кастомного кода интеграции. Никакого создания собственного агентного фреймворка. Никакого управления схемами инструментов. Существующие решения для астрологических чатов берут $0.25-$0.87 за запрос, отвечают за 8-24 секунды, привязывают к проприетарным моделям и используют кастомные JSON-форматы, требующие уникального кода интеграции для каждой платформы. Мы - единственная платформа, которая поставляет готового агента с поддержкой BYOK - выбирайте собственную LLM из GPT-5, Claude, Gemini, Grok или любой из 50+ моделей на OpenRouter.

Как работает агентный Chat API?

Astrology Chat API работает как специализированный ИИ-агент, который глубоко разбирается в астрологии.

Вот процесс: 1) Вы отправляете сообщение через стандартный OpenAI-эндпоинт /chat/completions.

2) Сервер инжектирует астрологический контекст - данные рождения ваших субъектов, активные инструменты, языковые предпочтения.

3) LLM решает, какие инструменты вызвать (расчёт натальной карты, анализ транзитов, отчёт синастрии и т.д.).

4) Сервер выполняет эти инструменты внутренне, обращаясь к нашим 82 астрологическим эндпоинтам - никаких дополнительных API-вызовов с вашей стороны.

5) Результаты инструментов передаются обратно в LLM для синтеза.

6) Вы получаете связную, обоснованную интерпретацию с реальными планетарными данными.

Весь цикл инструментов выполняется на сервере в рамках одного запроса.

Вы никогда не видите сообщения о вызовах инструментов - только финальный ответ.

С включённым стримингом (SSE) вы также получаете расширенные события реального времени, такие как tool_start и tool_end, чтобы ваш UI мог показывать 'Рассчитываю транзитную карту...' пока агент работает.

Весь цикл агента выполняется на сервере в одном API-вызове

1 min read

Что такое BYOK и почему это важно?

BYOK - Bring Your Own Key - означает, что вы сами выбираете, какая LLM управляет вашим астрологическим агентом.

Каждое другое решение для астрологического чата на рынке привязывает к единственной проприетарной модели без альтернатив - некоторые даже не раскрывают, какую модель используют.

С нашим BYOK-эндпоинтом (/chat/completions/byok) вы передаёте собственный API-ключ и ID модели.

Мы поддерживаем три провайдера: OpenAI (GPT-5, GPT-5-mini, GPT-5-nano, o3, o4), Anthropic (Claude Opus 4, Claude Sonnet 4, Claude Haiku 4) и OpenRouter (50+ моделей, включая Gemini 3, Grok 4, Llama, Mistral и другие).

Почему это важно? Контроль расходов - GPT-5-nano в 10 раз дешевле GPT-5-pro.

Настройка качества - Claude превосходит в нюансированных интерпретациях, Gemini быстрее для простых запросов.

Комплаенс - некоторые предприятия требуют конкретных провайдеров моделей.

BYOK стоит всего 2 кредита/ход (наша плата за платформу) плюс то, что взимает ваш LLM-провайдер.

50+ LLM-моделей на выбор - вы контролируете стоимость, качество и провайдера

1 min read

Почему это единственный OpenAI-совместимый вариант?

Совместимость с OpenAI означает, что вы используете стандартный OpenAI SDK - ту же клиентскую библиотеку, которую знают миллионы разработчиков.

Не нужно изучать новый SDK, не нужно создавать кастомный HTTP-клиент.

На TypeScript: new OpenAI({ baseURL: 'https://api.astrology-api.io/api/v3/chat' }).

На Python: OpenAI(base_url='...').

Вот и всё.

Ваш существующий код для ChatGPT работает с минимальными изменениями.

Это также означает мгновенную совместимость с каждым фреймворком, построенным на протоколе OpenAI: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI.

Если ваш фреймворк говорит на OpenAI - он говорит на Astrology Chat API.

Ни один другой провайдер астрологии не предлагает этого - существующие решения используют кастомные эндпоинты с проприетарными форматами запросов/ответов, требующие уникального кода интеграции для каждой поддерживаемой платформы.

Работает с любым OpenAI SDK - TypeScript, Python, Go, Rust и каждым ИИ-фреймворком

1 min read

Идеально для Vibe Coding — Создавайте Астрологические Виджеты за Минуты

Astrology Chat API использует стандартный протокол OpenAI Chat Completions — и это меняет всё для разработчиков, использующих ИИ-инструменты для кода.

Lovable, Claude Code, Cursor, Windsurf и любой другой ИИ-ассистент мгновенно понимают, как работать с нашим API, потому что формат запросов и ответов им уже знаком.

Никаких проприетарных форматов.

Никакой документации, которую нужно скармливать модели.

Вы просто пишете промпт: «Создай React-виджет натальной карты, который подключается к Astrology Chat API» — и получаете рабочий код за минуты.

Vibe-кодеры уже собирают полноценные астрологические приложения за часы, а не за недели.

Телеграм-боты, виджеты для Notion, Streamlit-дашборды, Next.js-лендинги с персонализированными гороскопами — всё это создаётся одним промптом, потому что протокол стандартный.

Это не упрощённый API для новичков — это та же агентная платформа с 16 инструментами, BYOK и стримингом, просто она говорит на языке, который понимает каждый ИИ-инструмент для кода.

Скопируйте этот промпт в Lovable, Claude Code, Cursor или любой ИИ-инструмент для кода:

Lovable, Claude Code, Cursor, Windsurf — любой ИИ-инструмент для кода мгновенно создаёт рабочие интеграции

1 min read

Что могут 16 инструментов агента?

Платформа предоставляет 16 инструментов, которые LLM может автономно вызывать во время разговора.

Они автогенерируются из наших 82 существующих API-эндпоинтов с помощью динамического реестра - инструментами становятся только эндпоинты с тегом 'chat-safe'.

Инструменты покрывают: Анализ (3 инструмента) - натальные отчёты с многосекционными интерпретациями, лунный анализ с фазами Луны и лунными стоянками, синастрические отчёты с индексом совместимости.

Расчёт карт (4 инструмента) - натальные, синастрические, композитные и транзитные карты с полными планетарными позициями и аспектами.

Рендеринг карт (4 инструмента) - натальные, синастрические, транзитные и композитные карты в SVG, PNG, JPG, WebP или PDF.

Сгенерированные карты сохраняются как бинарные артефакты с URL для совместного доступа.

Данные (3 инструмента) - текущие планетарные позиции, эфемериды на любую дату и матрицы аспектов.

Гороскоп (1 инструмент) - персонализированный ежедневный гороскоп с 6 сферами жизни, рейтингами и планетарными влияниями.

PDF (1 инструмент) - профессиональный многостраничный натальный отчёт с визуализацией колеса, интерпретациями и темами.

Добавление новых инструментов не требует изменений кода чат-эндпоинта - просто пометьте существующий эндпоинт как 'chat-safe'.

16 инструментов автогенерируются из 82 эндпоинтов - новые инструменты не требуют изменений кода чата

1 min read

Как работают мультисубъектные сессии и артефакты?

Две функции, которых нет ни у одного конкурента: мультисубъектные сессии и бинарные артефакты.

Мультисубъектность означает, что вы можете передать несколько натальных карт в одном разговоре - например, 'я' и 'партнёр'.

LLM ссылается на субъектов по их семантическому ID при вызове инструментов, а сервер разрешает их в полные данные рождения.

Это позволяет анализировать синастрию, сравнивать композитные карты и исследовать семейную динамику - всё в одной чат-сессии, без повторной отправки данных рождения.

Ни один другой чат-API не поддерживает более одного субъекта за разговор.

Бинарные артефакты позволяют чату генерировать скачиваемые файлы.

Попросите 'Сгенерируй мою натальную карту' и получите SVG-изображение карты.

Попросите 'Создай PDF-отчёт' и получите профессиональный многостраничный документ.

Артефакты хранятся в Supabase с URL для совместного доступа и 24-часовым хранением.

Сессии сохраняются через Redis с 24-часовым скользящим TTL.

Передавайте один и тот же session_id между ходами, и сервер восстановит историю разговора, субъектов и контекст - настоящая многоходовая память без управления состоянием на стороне клиента.

Мультисубъектные сессии и бинарные артефакты - обе функции уникальны для нашей платформы

1 min read

Производительность и цены по сравнению с конкурентами

Давайте поговорим о цифрах.

Самые быстрые конкурентные решения для астрологических чатов отвечают за 8-12 секунд.

Стандартные тарифы на рынке в среднем 19-24 секунды.

Наш слой расчётов отвечает менее чем за 300мс - общее время ответа зависит только от скорости LLM, обычно 2-5 секунд со стримингом.

Это в 4-10 раз быстрее.

По ценам стоимость каждого хода складывается из трёх компонентов: 1) Плата за платформу - 25 кредитов hosted (LLM включён) или 2 кредита BYOK.

2) Кредиты за endpoint - каждый вызов инструмента тарифицируется как обычный API-запрос (например, natal = 1 кредит).

3) Расходы на LLM - только в BYOK-режиме, оплата напрямую вашему провайдеру.

Пример: агент вызывает natal endpoint для интерпретации.

Hosted: 25 + 1 = 26 кредитов (~$0.02 на Professional).

BYOK: 2 + 1 + расходы LLM = 3 кредита (~$0.002) + стоимость токенов вашего провайдера.

Альтернативы на рынке берут $0.25-$0.87 за ИИ-запрос - поверх ежемесячных подписок.

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

Мы включаем чат в наш стандартный бесплатный тариф: 50 запросов в месяц, без кредитной карты.

В 4-10 раз быстрее и в 10-100 раз дешевле конкурентов

1 min read

Use Cases

Астрологические мобильные приложения

Добавьте разговорного ИИ-астролога в ваше iOS или Android-приложение. Пользователи задают вопросы на естественном языке, получают персонализированные интерпретации, подкреплённые реальными расчётами карт. OpenAI SDK нативно работает с React Native и Flutter.

Дейтинг и платформы совместимости

Мультисубъектные сессии обеспечивают анализ совместимости двух пользователей в реальном времени. Агент рассчитывает синастрию, композитные карты и динамику отношений - всё в рамках одного разговорного потока.

Конвейеры генерации контента

Генерируйте персонализированные гороскопы, еженедельные прогнозы и натальные отчёты в масштабе. BYOK с экономичной моделью (GPT-5-nano) и пакетная обработка 10 000+ пользователей для ежедневного email- или push-контента.

Велнес и ментальное здоровье

Интегрируйте астрологические инсайты в приложения осознанности, терапевтические инструменты и платформы саморефлексии. Режим психологической традиции предоставляет юнгианские интерпретации, ориентированные на рост и самопознание.

SaaS-платформы астрологии

Используйте агента как white-label продукт. Кастомные системные промпты задают личность, BYOK контролирует расходы, а персистентность сессий обеспечивает многоходовые консультации для платных подписчиков.

Фреймворки ИИ-агентов

Подключайте напрямую к LangChain, CrewAI, AutoGen или любому OpenAI-совместимому агентному фреймворку. Наш API становится специализированным астрологическим инструментом в вашей мультиагентной системе - без кастомных адаптеров.

Vibe Coding с ИИ-Инструментами

Lovable, Claude Code, Cursor и Windsurf мгновенно генерируют рабочие интеграции с нашим API — протокол OpenAI знаком каждой ИИ-модели. Напишите один промпт и получите готовый астрологический виджет, Telegram-бота или дашборд за минуты, а не недели ручного кодирования.

Technical Specifications

Протокол API	OpenAI Chat Completions (v1)
Эндпоинты	/chat/completions (hosted) + /chat/completions/byok
Инструменты агента	16 автогенерируемых из 82 эндпоинтов
Скорость расчётов	<300мс на вызов инструмента
Общее время ответа	2-5с со стримингом
Стриминг	SSE с расширенными событиями tool_start/tool_end
BYOK-провайдеры	OpenAI, Anthropic, OpenRouter (50+ моделей)
Hosted-модель	astro-default (оптимизирована для астрологии)
Персистентность сессий	Redis, скользящий TTL 24ч
Мультисубъект	Неограниченное кол-во субъектов в сессии
Бинарные артефакты	SVG, PNG, JPG, WebP, PDF через чат
Языки	9 (en, de, fr, es, it, pt, ru, zh, hi)
Традиции	Классическая, Психологическая, Событийная, Универсальная
Аутентификация	Bearer-токен (API-ключ)
Ограничение запросов	По API-ключу, настраиваемое

Сравнение Astrology Chat API

Feature	Astrology API	Others
Совместимость с OpenAI SDK	Да (замена)	Нет (кастомные API)
BYOK-выбор модели	50+ моделей (3 провайдера)	Фиксированная проприетарная модель
Серверный цикл агента	16 инструментов, автоматически	Создавайте сами
Мультисубъектные сессии	Неограниченно субъектов	Одна натальная карта
Бинарные артефакты	PDF, SVG, PNG через чат	Недоступно
Время ответа	2-5с (стриминг)	8-24 секунды
Цена за запрос	$0.001-$0.02	$0.25-$0.87
Стриминг	SSE + расширенные события	Базовый или отсутствует
Бесплатный тариф	50 запросов/месяц	Нет или платный sandbox
ИИ-Инструменты для Кода (Vibe Coding)	Работает мгновенно (протокол OpenAI)	Проприетарные форматы, только ручное кодирование

Связанные астрологические API

Natal Chart API

Расчёт полных натальных карт с планетарными позициями, домами и аспектами

Synastry API

Анализ совместимости отношений между двумя картами

Transit API

Текущие планетарные транзиты и их влияние на натальные карты

PDF Report API

Генерация профессиональных многостраничных астрологических PDF-отчётов

Документация API

Полный технический справочник с интерактивными примерами

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Скопируйте этот промпт в Lovable, Claude Code, Cursor или любой ИИ-инструмент для кода:

Build an astrology chat widget using the OpenAI SDK. Use base URL https://api.astrology-api.io/api/v3/chat and read the API docs at https://api.astrology-api.io/md/chat-completions for the full request schema. The widget should have: a birth data form (date, time, city), a streaming chat interface with message bubbles, and display tool call events (like 'Calculating natal chart...') as the agent works. Use the astrology namespace for subjects and enabled_tools as documented.

Простые, прозрачные цены

Начните бесплатно, масштабируйтесь по мере роста. Без скрытых платежей и сюрпризов.

Всегда бесплатно

Начать бесплатно

Идеально для обучения, тестирования и небольших личных проектов

50 API-запросов/месяц

Базовые натальные карты

5 систем домов

Поддержка сообщества

Pro

$11/месяц

Для небольших приложений и личных проектов

Все базовые эндпоинты
12 систем домов
Поддержка по email

Лучшая цена

Pro Plus

$21/месяц

Для растущих приложений и среднего трафика

Все расширенные эндпоинты
18 систем домов
Интерпретации на основе ИИ
Приоритетная поддержка по email

Ultra

$37/месяц

Для профессиональных астрологических приложений

Расчёт кредитов ↓

Все премиум-эндпоинты
23 системы домов
Продвинутые интерпретации на основе ИИ
Приоритетная поддержка

Планы для больших объёмов

Для приложений корпоративного масштаба

Business

$99/месяц

Для высоконагруженных приложений

Расчёт кредитов ↓

ВСЕ эндпоинты
Готовность к white-label
Индивидуальная настройка ИИ
Поддержка по телефону

БЕЗЛИМИТ

Enterprise

$399+в месяц

Безлимитные запросы с выделенной инфраструктурой

Выделенная серверная инфраструктура
Гарантированная задержка менее 300 мс
Круглосуточная выделенная поддержка 24/7
SLA с аптаймом 99,99%

Все планы включают подробную документацию и SDK

Есть вопросы? Поговорите с нашей командой

Часто задаваемые вопросы об Astrology Chat API

Реальные ответы об агентной платформе астрологии

Создайте свой полный астрологический стек

Chat API оркестрирует эти эндпоинты автоматически, но вы можете использовать их и напрямую:

Natal Chart API для сырых расчётов карт Synastry API для анализа отношений Transit API для текущих планетарных влияний PDF Report API для профессиональных документов MCP Astrology Server для интеграции с Claude Desktop

Начните создавать

Присоединяйтесь к разработчикам, создающим астрологические приложения нового поколения. Один API-вызов, полный цикл агента, любая LLM.

Начать бесплатно Документация API

50 бесплатных запросов/месяц

Совместимость с OpenAI SDK

Без платы за подключение

Больше, чем чат. Создавайте ИИ-агентов астрологии

Агент в действии

Создавать ИИ-астрологию сложнее, чем должно быть

Полноценная агентная платформа, а не просто Chat API

Производительность платформы

Полный набор функций агентной платформы

Bring Your Own Key (BYOK)

SSE-стриминг и события

16 автогенерируемых инструментов агента

Мультисубъект и сессии

Готов для Виджетов с ИИ-Инструментами для Кода

Бинарные артефакты и вывод

Что такое Astrology Chat API? Полное руководство для разработчиков

Как работает агентный Chat API?

Что такое BYOK и почему это важно?

Почему это единственный OpenAI-совместимый вариант?

Идеально для Vibe Coding — Создавайте Астрологические Виджеты за Минуты

Что могут 16 инструментов агента?

Как работают мультисубъектные сессии и артефакты?

Производительность и цены по сравнению с конкурентами

Use Cases

Астрологические мобильные приложения

Дейтинг и платформы совместимости

Конвейеры генерации контента

Велнес и ментальное здоровье

SaaS-платформы астрологии

Фреймворки ИИ-агентов

Vibe Coding с ИИ-Инструментами

Technical Specifications

Сравнение Astrology Chat API

Связанные астрологические API

Natal Chart API

Synastry API

Transit API

PDF Report API

Документация API

References & Standards

Простые, прозрачные цены

Всегда бесплатно

Pro

Pro Plus

Ultra

Планы для больших объёмов

Business

Enterprise

Часто задаваемые вопросы об Astrology Chat API

Что такое Astrology Chat API и чем он отличается от обычного чат-бота?

Могу ли я использовать OpenAI SDK на Python или TypeScript с этим API?

Какие LLM-модели поддерживаются с BYOK?

Сколько кредитов стоит каждый ход чата?

Как работает мультисубъектный чат для синастрии и совместимости?

Может ли чат генерировать PDF-отчёты и SVG-изображения карт?

Насколько быстр Astrology Chat API по сравнению с альтернативами?

Что такое расширенные события SSE-стриминга?

Как работают сессии и память разговора?

Какие языки программирования и фреймворки поддерживаются?

Это просто обёртка над GPT или используются реальные астрономические данные?

Как контролировать стиль и длину ответа?

Какие астрологические традиции и системы домов поддерживаются?

Можно ли использовать это как white-label продукт?

Что происходит, если вызов инструмента завершается ошибкой во время разговора?

Можно ли создать астрологический виджет с помощью Lovable, Claude Code или Cursor?

Чем Astrology Chat API отличается от создания собственного решения на основе сырых API-эндпоинтов?

Создайте свой полный астрологический стек

Начните создавать

Агент в действии

Создавать ИИ-астрологию сложнее, чем должно быть

Полноценная агентная платформа, а не просто Chat API

Производительность платформы

Полный набор функций агентной платформы

Bring Your Own Key (BYOK)

SSE-стриминг и события

16 автогенерируемых инструментов агента

Мультисубъект и сессии

Готов для Виджетов с ИИ-Инструментами для Кода

Бинарные артефакты и вывод

Что такое Astrology Chat API? Полное руководство для разработчиков

Как работает агентный Chat API?

Что такое BYOK и почему это важно?

Почему это единственный OpenAI-совместимый вариант?