/api/astro/chat/25 créditosChat de astrología
Haz una pregunta sobre una carta natal y recibe una respuesta en lenguaje llano, basada en los textos clásicos. Cada respuesta incluye los pasajes en los que se apoya, cada uno con su fuente y una puntuación de relevancia, para que puedas comprobar el razonamiento en vez de aceptarlo a ciegas. Para preguntas de compatibilidad, pasa una segunda persona en `compare_with`. Este endpoint funciona SIN ESTADO. No se guarda nada entre llamadas ni interviene ninguna cuenta: los datos de nacimiento llegan en tu solicitud, así que puedes preguntar en nombre de cualquiera de tus usuarios. Para seguir una conversación, guarda la transcripción en tu aplicación y vuelve a enviarla en `history` (hasta veinte turnos anteriores). Cada llamada cuesta 25 créditos en lugar del 1 habitual, porque cada respuesta ejecuta un modelo de lenguaje sobre la carta calculada. Una respuesta fallida o vacía no cuesta nada, como en todos los demás endpoints.
https://api.occultapi.com/api/astro/chat/Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| birth | object | obligatorio | La persona cuya carta se consulta. |
| question | string | obligatorio | La pregunta sobre la carta. |
| compare_with | object | opcional | Una segunda persona, para preguntas de compatibilidad. Opcional. |
| history | array | opcional | Turnos anteriores, del más antiguo al más reciente, como máximo 20. Este endpoint no guarda nada entre llamadas, así que vuelve a enviar todo el contexto que la respuesta deba tener en cuenta. |
Ejemplo de solicitud
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"}}'Respuesta
{
"_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"
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.