/api/astro/chat/25 кредитовАстрологический чат
Задайте вопрос о натальной карте и получите понятный ответ, опирающийся на классические тексты. К каждому ответу прилагаются фрагменты, на которых он основан, — с источником и оценкой релевантности, — поэтому рассуждение можно проверить, а не принимать на веру. Для вопросов о совместимости передайте второго человека в `compare_with`. Этот эндпоинт НЕ ХРАНИТ СОСТОЯНИЕ. Между вызовами ничего не сохраняется, и аккаунт не нужен: данные рождения берутся из вашего запроса, поэтому вы можете спрашивать от имени любого из своих пользователей. Чтобы продолжить разговор, храните переписку в своём приложении и передавайте её обратно в `history` — до двадцати предыдущих реплик. Вызов стоит 25 кредитов вместо обычного 1, потому что каждый ответ формирует языковая модель на основе рассчитанной карты. Неудачный или пустой ответ ничего не стоит, как и на всех остальных эндпоинтах.
https://api.occultapi.com/api/astro/chat/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| birth | object | обязательный | Чьей карты касается вопрос. |
| question | string | обязательный | Вопрос о карте. |
| compare_with | object | необязательный | Второй человек для вопросов о совместимости. Необязательно. |
| history | array | необязательный | Предыдущие реплики, от самой ранней, не более 20. Этот эндпоинт ничего не хранит между вызовами, поэтому передавайте весь контекст, который должен учитывать ответ. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/chat/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"Which planet rules my ascendant, and what does it say about my career?","birth":{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"place":"Jaipur, India","name":"Asha","gender":"female"}}'Ответ
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"answer\": \"Asha, your ascendant or rising sign is Leo, which is ruled by the Sun. \\n\\nWith the Sun as the ruler of your ascendant (Leo), it highlights qualities such as leadership, confidence, and a desire to be in the spotlight. This influence often urges you to pursue a career where you can shine or be in a position of authority. Roles that allow you to take charge, make decisions, and impact others positively are likely appealing to you. \\n\\nGiven the Sun's influence on your career house (the 10th house), roles in management, administration, public relations, or any profession that allows you to showcase your talents and earn recognition might be particularly fulfilling for you.\", \"question\": \"Which planet rules my ascendant, and what does it say about my career?\", \"sources\": [{\"source\": \"Planets in Signs and Houses.txt\", \"snippet\": \"Pluto in the Ninth House: Can't stand religious hypocrisy, can you? Can anybody? Well, nobody\\r\\nLIKES...\", \"score\": 0.021327968686819077}, {\"source\": \"54418030-PRASHNA-by-Gayatri-D-Vasudev.txt\", \"snippet\": \"Ascendant or the Ascendant lord, or if the Ascen-\\r\\ndant and 11th lords are favourably disposed,\\r\\npre...\", \"score\": 0.018708257004618645}, {\"source\": \"Graha_Yuddha.txt\", \"snippet\": \"the Ascendant lord is\\r\\ninvolved. Mars as loser brings exceptional results. Graha Yuddha is not consi...\", \"score\": 0.01666666753590107}, {\"source\": \"kalyana-varma-saravali.txt\", \"snippet\": \"the 10th from the Moon, or\\r\\nfrom the Ascendant; whichever is stronger will prevail. The earnings (li...\", \"score\": 0.01666666753590107}, {\"source\": \"Book. Key to Learn - K.P. cuspal system - S.P. Khullar.txt\", \"snippet\": \"but the Blind Test results ignited\\r\\nmy interest sufficient for me to get fully involved in the syste...\", \"score\": 0.016393441706895828}, {\"source\": \"Planets and Children KN Rao.txt\", \"snippet\": \"that old Brahmin I have talked of, with a sense of gratitude,1\\r\\n\\\"No child in this world is born unle...\", \"score\": 0.016129031777381897}, {\"source\": \"Applications of Cuspal Interlinks Part 1 Baskaran.txt\", \"snippet\": \"of natal\\r\\nnature of the Asc leads the stage. But, in the\\r\\nperiods of Dasas and Bhukthies, that are\\r\\n...\", \"score\": 0.016129031777381897}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"in Anuradha Nakshatra ruled by Saturn, it makes\\r\\nthe native cautious, calculative and pragmatic.\\r\\nEd...\", \"score\": 0.01612432301044464}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"Ascendant is simultaneously linked to cusps 5 & 9 through its Star\\r\\nlord, it indicates a very poor p...\", \"score\": 0.01587301678955555}, {\"source\": \"Prashna Deepika English.txt\", \"snippet\": \"11. Defective speech and Stammering ?\\r\\n12. Can I learn music ?\\r\\n13. Am I to Commit Suicide ?\\r\\n14. Wh...\", \"score\": 0.01587301678955555}, {\"source\": \"Book. Key to Learn - K.P. cuspal system - S.P. Khullar.txt\", \"snippet\": \"effort that must have gone in preparing these lessons and the way\\r\\nthey have been presented by Mr. K...\", \"score\": 0.015625}, {\"source\": \"Kalyana Varmas Saravali.txt\", \"snippet\": \"be the aspecting planet with reference to the Ascendant one will be interested in\\r\\nreligious observa...\", \"score\": 0.015625}, {\"source\": \"Practical Horary Astrology Gayathri Vasudev.txt\", \"snippet\": \"or the house to which the question refers.\\r\\n\\r\\nSuppose the question is 'Will I succeed in a\\r\\nparticul...\", \"score\": 0.01547067891806364}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"The\\r\\npotential of the Ascendant fixes the ultimate limit to which a\\r\\nperson can rise in any walk ofl...\", \"score\": 0.015384615398943424}, {\"source\": \"Predicting through Karakamsha and Jaimini_s Mandook Dasha.txt\", \"snippet\": \"was almost no hope of\\r\\nmy surviving.\\r\\n7. My schooling started, after coaching at home, at the age of...\", \"score\": 0.015384615398943424}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"is symbolic of drive,\\r\\ndetenll"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.