¿Qué es la API de Chat de Astrología y en qué se diferencia de un chatbot normal?

La API de Chat de Astrología es una plataforma agéntica — no solo un wrapper de chatbot. Cuando envías un mensaje, el servidor decide de forma autónoma cuál de las 16 herramientas astrológicas invocar (cartas natales, tránsitos, sinastría, etc.), las ejecuta contra nuestros 82 endpoints de cálculo y sintetiza una respuesta fundamentada. A diferencia de los chatbots genéricos que alucinan datos astrológicos, cada interpretación está respaldada por cálculos reales de efemérides. Todo el ciclo de agente se ejecuta del lado del servidor en una sola llamada API.

¿Puedo usar el SDK de Python o TypeScript de OpenAI con esta API?

Sí — ese es el principio de diseño fundamental. Implementamos el protocolo estándar de OpenAI /chat/completions, así que usas el SDK oficial de OpenAI en cualquier lenguaje: TypeScript (paquete npm openai), Python (paquete pip openai), Go, Rust o cualquier cliente HTTP. Solo cambia la base URL a nuestro endpoint. Tu código existente de OpenAI funciona con cambios mínimos. Esto también significa compatibilidad instantánea con LangChain, Vercel AI SDK y cualquier framework compatible con OpenAI.

¿Qué modelos LLM son compatibles con BYOK?

BYOK soporta tres proveedores con 50+ modelos. OpenAI: familias GPT-5, GPT-5-mini, GPT-5-nano, o3, o4. Anthropic: Claude Opus 4, Sonnet 4, Haiku 4. OpenRouter: cualquier modelo que alojen — Gemini 3, Grok 4, Llama, Mistral, Qwen y más. Pasas tu propia API key e ID de modelo. La plataforma gestiona automáticamente las particularidades de cada proveedor (como diferencias de parámetros en modelos de razonamiento).

¿Cuánto cuesta cada turno de chat en créditos?

Cada turno tiene dos componentes de costo: créditos de plataforma + créditos de endpoint por llamadas de herramientas. Modo hosted: 25 créditos/turno (LLM incluido) + créditos de endpoint (p. ej. natal = 1, tránsito = 1, astrocartography = 5, PDF = 35). Modo BYOK: 2 créditos/turno + mismos créditos de endpoint + tus costos de proveedor LLM. Ejemplo: una interpretación de carta natal = 25 + 1 = 26 créditos hosted (~$0.02), o 2 + 1 = 3 créditos BYOK (~$0.002) + ~$0.003 de costo LLM. En el plan Professional ($37/mes, 55.000 créditos) son ~2.100 turnos hosted o ~18.000 turnos BYOK. Nivel gratuito: 50 requests/mes.

¿Cómo funciona el chat multi-sujeto para sinastría y compatibilidad?

Pasa varios sujetos en el array astrology.subjects, cada uno con un ID semántico ('me', 'partner', 'child') y datos de nacimiento. El LLM referencia los sujetos por ID al invocar herramientas — el servidor resuelve los IDs a las coordenadas de nacimiento completas. Esto permite sinastría, cartas compuestas y análisis multi-persona en una sola conversación. Ningún competidor soporta más de un sujeto por sesión.

¿Puede el chat generar informes PDF e imágenes SVG de cartas?

Sí — los artefactos binarios son una funcionalidad exclusiva. Pide 'Genera mi carta natal' y el agente invoca la herramienta render_natal, produce un SVG (o PNG/PDF), lo almacena como artefacto y devuelve una URL compartible. Lo mismo para informes PDF natales — documentos profesionales multipágina con visualización de rueda, interpretaciones y temas. Los artefactos se guardan en Supabase con retención de 24 horas y URLs compartibles.

¿Qué tan rápida es la API de Chat de Astrología comparada con las alternativas?

Nuestra capa de cálculo responde en menos de 300ms por llamada de herramienta. El tiempo de respuesta total (cálculo + generación LLM) es típicamente 2-5 segundos con streaming. Las soluciones de chat de astrología competidoras promedian 8-24 segundos por respuesta, incluso en planes premium. Con streaming, nuestros usuarios ven los primeros tokens en menos de 2 segundos mientras el agente sigue trabajando.

¿Qué son los eventos de extensión del streaming SSE?

Además de los chunks de texto estándar de OpenAI, emitimos eventos SSE personalizados: tool_start (cuando el agente empieza a llamar a una herramienta — tu UI puede mostrar 'Calculando carta natal...'), tool_end (cuando la herramienta responde — con tiempo de ejecución) y astrology.error (si una herramienta falla con elegancia). Permiten UIs ricas en tiempo real que muestran el proceso de razonamiento del agente mientras trabaja.

¿Cómo funcionan las sesiones y la memoria de la conversación?

Pasa astrology.session_id en tu request. En el primer turno, el servidor crea una sesión respaldada por Redis. En los turnos siguientes con el mismo ID, el servidor carga los mensajes y sujetos previos antes de procesar tu nuevo mensaje. Las sesiones tienen un TTL deslizante de 24 horas — cada interacción extiende la ventana. El servidor gestiona la compresión de mensajes en conversaciones largas, así que no necesitas administrar ventanas de contexto.

¿Qué lenguajes de programación y frameworks son compatibles?

Cualquier lenguaje con cliente HTTP funciona, pero los SDKs de OpenAI ofrecen la mejor experiencia: TypeScript/JavaScript (openai), Python (openai), Go (openai-go), Rust, C#, Java, PHP, Ruby. Frameworks compatibles: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI, Haystack — cualquier cosa que hable el protocolo OpenAI. La mayoría de los desarrolladores integran en menos de 30 minutos.

¿Es solo un wrapper de GPT o usa datos astronómicos reales?

Cada interpretación astrológica está fundamentada en cálculos reales de efemérides. Cuando el agente invoca charts_natal, calcula posiciones planetarias reales con la Swiss Ephemeris — el mismo motor que usa el software profesional de astrología. El LLM recibe datos reales de la carta (posiciones planetarias, ubicaciones en casas, aspectos con orbes exactos) y sintetiza interpretaciones a partir de esos datos. Sin posiciones planetarias alucinadas, sin aspectos inventados.

¿Cómo controlo el estilo y la longitud de las respuestas?

Tres capas de control: 1) Mensaje de sistema — define cualquier personalidad ('psicóloga jungiana cálida', 'clasicista británico conciso', etc.). 2) astrology.defaults.detail_level — 'brief' (menos de 100 palabras), standard (200-350 palabras) o 'detailed' (500-800 palabras). 3) astrology.defaults.tradition — classical, psychological, event-oriented o universal. La instrucción explícita del usuario ('brevemente' o 'en detalle') anula todo lo demás.

¿Qué tradiciones astrológicas y sistemas de casas son compatibles?

Cuatro tradiciones de interpretación: Clásica (helenística/medieval), Psicológica (jungiana), Orientada a Eventos (horaria/electiva) y Universal (equilibrada). Veintitrés sistemas de casas, incluyendo Placidus, Koch, Signo Completo, Igual, Campanus, Regiomontanus, Porfirio y más. Se configura vía astrology.defaults.house_system — el servidor lo aplica a todas las llamadas de herramienta automáticamente.

¿Puedo ofrecerlo como mi propio producto con marca blanca?

Por supuesto. El prompt de sistema (messages[0] con role='system') controla toda la personalidad. Define la voz de tu marca, la persona del astrólogo, el estilo de lenguaje — el usuario nunca ve nuestra marca. BYOK te da control de costos. La persistencia de sesión habilita modelos de suscripción. Los planes de precios estándar permiten la redistribución comercial.

¿Qué pasa si una llamada de herramienta falla durante la conversación?

Degradación elegante. Si una herramienta devuelve un error (datos de nacimiento inválidos, cálculo no soportado), el agente recibe el mensaje de error y se adapta — puede intentar otra herramienta, pedir aclaración al usuario o dar una respuesta parcial. Con streaming, recibes un evento astrology.error. La conversación no se rompe; el LLM gestiona los errores de forma conversacional, como lo haría un astrólogo humano.

¿Puedo construir un widget de astrología con Lovable, Claude Code o Cursor?

Sí — es la API ideal para vibe coding. Como implementamos el protocolo estándar de OpenAI /chat/completions, las herramientas de código IA como Lovable, Claude Code, Cursor, Windsurf, Bolt y Replit Agent ya saben cómo integrarla. Solo pide: 'Construye un widget de chat de astrología usando el SDK de OpenAI con base URL https://api.astrology-api.io/api/v3/chat'. La IA genera un componente de chat con streaming funcional — formulario de datos de nacimiento, burbujas de mensaje, indicadores de escritura — con cero depuración manual. Ninguna otra API de astrología ofrece esto porque todas usan formatos JSON propietarios que las herramientas de IA no entienden.

¿Cómo se compara la API de Chat de Astrología con construir la mía propia con RoxyAPI o endpoints de datos crudos?

RoxyAPI y APIs similares solo de datos te dan el JSON de cálculo en crudo — construyes toda la capa de agente tú mismo: esquemas de herramientas, orquestación LLM, manejo de errores, gestión de sesiones, almacenamiento de artefactos. Eso son meses de ingeniería. Nuestra plataforma entrega todo eso listo para usar. Una llamada API reemplaza cientos de líneas de código de framework de agente. Si ya usas LangChain o CrewAI, nuestro endpoint encaja como una sola herramienta — tu framework de agente existente hace el resto.

¿Qué es to_prompt_text() y por qué debería importarle a los desarrolladores de chatbots?

to_prompt_text() es un formateador que convierte los datos de la carta en markdown compacto listo para LLM. Suéltalo en cualquier prompt (Claude, GPT, Gemini, Grok) para fundamentar el modelo en datos reales sin volcar JSON. La salida está en lenguaje natural — 'Mars square Saturn within 2°' en lugar de códigos crípticos — así el LLM la interpreta correctamente a la primera. El gasto medio de tokens cae ~60% frente al JSON crudo, y las lecturas alucinadas caen notablemente porque el modelo sí puede leer los datos.

¿Cuánto reduce el formateador de prompt los costos de tokens del LLM?

Un volcado JSON crudo natal ocupa 1.500-3.000 tokens. El preset 'minimal' usa 150-250 tokens, 'full' usa 500-800, 'traditional' usa 600-900. Eso es ~60% de reducción de media — y el ahorro se acumula a lo largo de sesiones multi-turno. Con precios de la clase GPT-4, un chatbot que haga 10.000 lecturas natales al mes ahorra unos $150-$300 en tokens de prompt. Menos contexto también significa que las conversaciones largas caben antes de que se llene la ventana.

¿Qué idiomas soporta to_prompt_text()?

Siete idiomas, con ~40 strings localizados que cubren aspectos, dignidades, secta, casas y modalidades: inglés (en), alemán (de), español (es), francés (fr), italiano (it), portugués (pt), ruso (ru). Pasa el código de idioma y el formateador devuelve el markdown en ese idioma — listo para soltarlo en un prompt de chatbot localizado. Sin traducción del lado del cliente.

¿Cómo se formatean los aspectos en lenguaje natural?

Los aspectos salen como frases legibles con orbes precisos. Ejemplos: 'Mars square Saturn within 2°', 'Venus trine Jupiter within 0°45'', 'Moon opposite Sun within 1°15''. El nombre del aspecto (square, trine, opposition, sextile, conjunction) se escribe completo, el orbe se muestra en grados y minutos, y los planetas están a cada lado de la palabra de relación — tal y como lo escribiría un astrólogo. Los LLMs lo interpretan correctamente a la primera.

¿Qué significan los prefijos t. y n. en la salida formateada?

't.' marca planetas en tránsito, 'n.' marca planetas natales. Cuando formateas una lectura de tránsitos, cada línea de aspecto muestra claramente la fuente — por ejemplo 't.Jupiter trine n.Venus within 1°' significa que Júpiter en tránsito está en trígono con la Venus natal. Este único cambio elimina la alucinación más común en los chatbots de astrología: la confusión de identidad planetaria entre la carta natal y el cielo actual. El LLM nunca tiene que adivinar.

NUEVO: Plataforma de Agentes IA

Más que un Chat. Construye Agentes de IA Astrológica

La única plataforma agéntica compatible con OpenAI para astrología.

16 herramientas del lado del servidor, elección de modelo BYOK, streaming SSE, sesiones multi-sujeto. Una llamada API, ciclo de agente completo.

Ver Documentación API

Presets de Contexto LLM

Idiomas del Prompt

60%

Reducción de Tokens

Herramientas de Agente

Drop-in con OpenAI SDK

Trae Tu Propia Clave

Ciclo de Agente del Lado del Servidor

Ve al Agente en Acción

Conversaciones reales impulsadas por orquestación de herramientas del lado del servidor

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: "es", tradition: "psychological" }
  }
} as any);

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

Compatible con cualquiera de nuestros 16 endpoints o combinaciones

Vedic Jyotish

Preguntas Horarias

Human Design

Astrocartography

Numerología

Tarot

Sinastría Relacional

Pronóstico de Tránsitos

Cualquier combinación de endpoints en una sola sesión — natal, Vedic Jyotish, horaria, BaZi, astrocartography y más.Hosted: 25 + créditos de endpoint/turno · BYOK: 2 + créditos de endpoint + costos LLM

Un volcado completo del JSON natal consume 1.500-3.000 tokens por carta — la ventana de contexto se llena rápido
Nombres de campo crípticos como 'Mars 0d 90.0 Saturn' confunden al modelo y producen lecturas erróneas
Datos de tránsitos y natal mezclados sin prefijos — el LLM inventa qué planeta es cuál
Atado a modelos de chat propietarios sin opción BYOK ni control de costos
Contexto de prompt solo en inglés que bloquea el despliegue de chatbots multilingües
Construir desde cero tu propio ciclo de herramientas, formateador de prompts y gestor de sesiones

Transforma con

Formateador to_prompt_text(): 3 presets (minimal 150-250, full 500-800, traditional 600-900 tokens) — ~60% de reducción frente al JSON crudo
Aspectos en lenguaje natural: 'Mars square Saturn within 2°' en lugar de códigos crípticos
Prefijos t. / n. distinguen tránsito de natal (p. ej. 't.Jupiter trine n.Venus') — se acabaron los planetas alucinados
i18n en 7 idiomas (~40 strings) cubre EN, DE, ES, FR, IT, PT, RU para chatbots globales
BYOK: GPT-5, Claude 4, Gemini 3, Grok o cualquiera de los 50+ modelos de OpenRouter
Ciclo de agente del lado del servidor con 16 herramientas, sesiones multi-sujeto y artefactos binarios

Rendimiento de la Plataforma

Contexto optimizado en tokens, herramientas listas para agentes, cálculos rápidos

Presets de Contexto LLM

Idiomas del Prompt

~60%

Reducción de Tokens vs JSON

~40

Strings i18n en el Formateador

Herramientas de Agente

<300ms

Velocidad de Cálculo

Idiomas de Interpretación

50+

Modelos LLM

Funcionalidades Completas de la Plataforma de Agentes

Todo lo que necesitas para construir experiencias de astrología con IA

Formateador de Contexto LLM to_prompt_text()

Bring Your Own Key (BYOK)

Streaming SSE y Eventos

16 Herramientas de Agente Auto-Generadas

Multi-Sujeto y Sesiones

Listo para Widgets con Herramientas de Código IA

Artefactos Binarios y Salidas

¿Qué Es la API de Chat de Astrología? Guía Completa para Desarrolladores

Todo lo que necesitas para construir experiencias de astrología con IA

¿Y si pudieras añadir un agente de IA astrológica totalmente funcional a tu app con una sola llamada API? Eso es justo lo que hace la API de Chat de Astrología. No es solo un endpoint de chatbot — es una plataforma agéntica completa que ejecuta todo el ciclo de tool-calling del lado del servidor. Envías un mensaje del usuario y el servidor decide de forma autónoma cuál de las 16 herramientas astrológicas invocar, resuelve los datos de la carta natal a partir de IDs de sujeto (sin fechas inventadas), genera informes PDF o cartas SVG como artefactos binarios y devuelve una respuesta coherente — todo a través de un endpoint /chat/completions compatible con OpenAI. Eso significa que puedes usar el SDK estándar de OpenAI en TypeScript, Python, Go o cualquier lenguaje. Sin código de integración personalizado. Sin construir tu propio framework de agente. Sin gestionar esquemas de herramientas. Las soluciones de chat de astrología existentes cobran $0.25-$0.87 por consulta, tardan 8-24 segundos en responder, te atan a modelos propietarios y usan formatos JSON propios que exigen código de integración a medida. Somos la única plataforma que entrega un agente listo para usar con soporte BYOK — elige tu propio LLM entre GPT-5, Claude, Gemini, Grok o cualquiera de los 50+ modelos en OpenRouter.

¿Cómo Funciona la API de Chat Agéntica?

La API de Chat de Astrología funciona como un agente de IA especializado que sabe de astrología en profundidad.

Este es el flujo: 1) Envías un mensaje a través del endpoint estándar OpenAI /chat/completions.

2) El servidor inyecta el contexto astrológico — datos de nacimiento de tus sujetos, herramientas activas, preferencias de idioma.

3) El LLM decide qué herramientas invocar (cálculo de carta natal, análisis de tránsitos, informe de sinastría, etc.).

4) El servidor ejecuta esas herramientas internamente contra nuestros 82 endpoints de astrología — sin llamadas API extra desde tu lado.

5) Los resultados se devuelven al LLM para la síntesis.

6) Recibes una interpretación coherente y fundamentada con datos planetarios reales.

Todo el ciclo se ejecuta del lado del servidor en una sola solicitud.

Nunca ves mensajes de tool-call — solo la respuesta final.

Con streaming activado (SSE), también recibes eventos de extensión en tiempo real como tool_start y tool_end, para que tu UI pueda mostrar 'Calculando carta de tránsitos...' mientras el agente trabaja.

Todo el ciclo de agente se ejecuta del lado del servidor en una sola llamada API

1 min read

¿Qué Es BYOK y Por Qué Importa?

BYOK — Bring Your Own Key — significa que tú eliges qué LLM impulsa tu agente astrológico.

Cualquier otra solución de chat de astrología te ata a un único modelo propietario sin alternativas — algunas ni siquiera revelan qué modelo usan.

Con nuestro endpoint BYOK (/chat/completions/byok), pasas tu propia API key e ID de modelo.

Soportamos tres proveedores: OpenAI (GPT-5, GPT-5-mini, GPT-5-nano, o3, o4), Anthropic (Claude Opus 4, Claude Sonnet 4, Claude Haiku 4) y OpenRouter (50+ modelos, incluyendo Gemini 3, Grok 4, Llama, Mistral y más).

¿Por qué importa? Control de costos — GPT-5-nano es 10x más barato que GPT-5-pro.

Ajuste de calidad — Claude destaca en interpretaciones matizadas, Gemini es más rápido para consultas simples.

Cumplimiento — algunas empresas requieren proveedores específicos.

BYOK cuesta solo 2 créditos/turno (nuestra tarifa de plataforma) más lo que cobre tu proveedor LLM.

50+ modelos LLM disponibles — tú eliges costo, calidad y proveedor

1 min read

¿Por Qué Es la Única Opción Compatible con OpenAI?

Compatibilidad con OpenAI significa que usas el SDK estándar de OpenAI — la misma librería cliente que millones de desarrolladores ya conocen.

Sin SDK nuevo que aprender, sin cliente HTTP a medida.

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

En Python: OpenAI(base_url='...').

Eso es todo.

Tu código existente para ChatGPT funciona con cambios mínimos.

Esto también significa compatibilidad instantánea con cada framework construido sobre el protocolo de OpenAI: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI.

Si tu framework habla OpenAI, habla API de Chat de Astrología.

Ningún otro proveedor de astrología ofrece esto — las soluciones existentes usan endpoints personalizados con formatos de request/response propietarios, lo que obliga a escribir código de integración a medida para cada plataforma que soportes.

Funciona con cualquier SDK de OpenAI — TypeScript, Python, Go, Rust y todo framework de IA

1 min read

Perfecto para Vibe Coding — Construye Widgets de Astrología en Minutos

Como nuestra API usa el protocolo estándar de OpenAI, cualquier herramienta de código con IA ya sabe trabajar con ella.

Dile a Lovable 'Constrúyeme un widget de chat de astrología usando esta API' y genera un componente React funcional — UI con streaming, formulario de datos de nacimiento, burbujas de chat, todo.

Claude Code y Cursor pueden montar una integración completa con un solo prompt porque entienden el SDK de OpenAI de forma nativa.

Sin adaptadores a medida, sin documentación oscura, sin depurar formatos JSON propietarios.

Lo mismo aplica a Windsurf, Bolt, Replit Agent y cualquier herramienta de IA que pueda escribir código contra la API de OpenAI.

Esto es lo que hace que nuestra plataforma sea única para vibe coding: describes el widget que quieres, la IA lo construye y funciona a la primera — porque la API subyacente es el mismo protocolo con el que esas herramientas fueron entrenadas.

Los vibe coders están publicando apps de astrología en horas, no en semanas.

Widgets de chat, comprobadores de compatibilidad, generadores de horóscopo diario, intérpretes de carta natal — todo construido describiendo lo que quieres a un asistente de código IA.

Copia este prompt en cualquier herramienta de código IA para empezar al instante:

Lovable, Claude Code, Cursor, Windsurf — cualquier herramienta de código IA construye integraciones funcionales al instante

2 min read

¿Qué Pueden Hacer las 16 Herramientas del Agente?

La plataforma expone 16 herramientas que el LLM puede invocar de forma autónoma durante una conversación.

Se auto-generan desde nuestros 82 endpoints API existentes mediante un registro dinámico — solo los endpoints marcados como 'chat-safe' se convierten en herramientas.

Las herramientas cubren: Análisis (3 herramientas) — informes natales con interpretaciones multi-sección, análisis lunar con fases y mansiones, informes de sinastría con puntuaciones de índice de relación.

Cálculos de Carta (4 herramientas) — cartas natal, sinastría, compuesta y de tránsitos con posiciones planetarias y aspectos completos.

Renderizado de Cartas (4 herramientas) — cartas natal, sinastría, tránsitos y compuesta como SVG, PNG, JPG, WebP o PDF.

Las cartas generadas se guardan como artefactos binarios con URLs compartibles.

Datos (3 herramientas) — posiciones planetarias actuales, efemérides para cualquier fecha y matrices de aspectos.

Horóscopo (1 herramienta) — horóscopo diario personalizado con 6 áreas de vida, puntuaciones e influencias planetarias.

PDF (1 herramienta) — informe natal profesional multipágina con visualización de rueda, interpretaciones y temas.

Añadir nuevas herramientas requiere cero cambios de código en el endpoint de chat — solo marca un endpoint existente como 'chat-safe'.

16 herramientas auto-generadas desde 82 endpoints — las nuevas herramientas no requieren cambios en el código del chat

1 min read

¿Cómo Funcionan las Sesiones Multi-Sujeto y los Artefactos?

Dos funcionalidades que ningún competidor ofrece: sesiones multi-sujeto y artefactos binarios.

Multi-sujeto significa que puedes pasar varias cartas natales en una sola conversación — por ejemplo, 'me' y 'partner'.

El LLM referencia los sujetos por su ID semántico al invocar herramientas y el servidor los resuelve a los datos de nacimiento completos.

Esto permite análisis de sinastría, comparaciones de cartas compuestas y dinámicas familiares — todo en una sola sesión de chat, sin reenviar datos de nacimiento.

Ninguna otra API de chat soporta más de un sujeto por conversación.

Los artefactos binarios permiten que el chat genere archivos descargables.

Pide 'Genera mi carta natal' y recibe una imagen SVG de la carta.

Pide 'Crea un informe PDF' y obtén un documento profesional multipágina.

Los artefactos se almacenan en Supabase con URLs compartibles y retención de 24 horas.

Las sesiones persisten vía Redis con un TTL deslizante de 24 horas.

Pasa el mismo session_id entre turnos y el servidor restaura el historial, los sujetos y el contexto — memoria multi-turno real sin gestión de estado del lado del cliente.

Sesiones multi-sujeto y artefactos binarios — ambas exclusivas de nuestra plataforma

1 min read

Cómo to_prompt_text() Reduce los Costos de Tokens del LLM en ~60%

La mayoría de los desarrolladores fundamentan sus chatbots LLM volcando el JSON completo de la carta en el prompt.

Una carta natal en JSON ocupa 1.500-3.000 tokens — eso es $0.015-$0.030 por request en modelos de la clase GPT-4, además de llenar la ventana de contexto en pocos turnos.

Peor aún, el modelo a menudo malinterpreta códigos crípticos como 'Mars 0d 90.0 Saturn' y produce interpretaciones erróneas.

Nuestro formateador to_prompt_text() resuelve ambos problemas.

Convierte los datos de la carta en markdown compacto y legible con aspectos en lenguaje natural.

Tres presets te dejan elegir el presupuesto de tokens adecuado: 'minimal' (~150-250 tokens) cubre sol/luna/asc, aspectos clave y tránsitos actuales — ideal para respuestas de chat.

'full' (~500-800 tokens) añade dignidades, casas, modalidades y secta para interpretaciones más ricas.

'traditional' (~600-900 tokens) incluye profundidad helenística y medieval — partes, almuten, hayz, antiscia — para lecturas de estilo clásico.

Suelta el markdown formateado en cualquier prompt de LLM (Claude, GPT, Gemini, Grok) para fundamentar el modelo en datos reales sin volcar JSON.

Ahorro medio de tokens: ~60% frente a un volcado JSON crudo, con menos alucinaciones medibles.

3 presets, 150-900 tokens, ~60% más barato que volcar JSON

1 min read

Aspectos en Lenguaje Natural y Prefijos t./n.

Los LLMs leen mejor el lenguaje natural que los códigos de campo — así que to_prompt_text() emite los aspectos como los escribiría un astrólogo.

En lugar de 'Mars 0d 90.0 Saturn' obtienes 'Mars square Saturn within 2°'.

El orbe sigue siendo preciso, pero el modelo lo interpreta a la primera.

Cuando el formateador incluye datos de tránsitos junto a la carta natal, cada planeta se etiqueta con un prefijo: 't.' para tránsito, 'n.' para natal.

Así, una lectura de tránsitos muestra 't.Jupiter trine n.Venus within 1°' — el modelo nunca tiene que adivinar a qué carta pertenece cada planeta.

Este único cambio elimina la causa más común de lecturas alucinadas en chatbots de astrología: la confusión de identidad planetaria entre cartas.

Combinado con la i18n en 7 idiomas (EN, DE, ES, FR, IT, PT, RU — ~40 strings que cubren aspectos, secta, dignidades, casas, modalidades), puedes lanzar un chatbot multilingüe que fundamente a Claude o GPT en contexto localizado de la carta sin traducir nada del lado del cliente.

Aspectos en lenguaje natural + prefijos transit/natal eliminan las lecturas alucinadas

1 min read

Rendimiento y Precios vs Competidores

Hablemos de números.

Las soluciones de chat de astrología más rápidas del mercado tardan 8-12 segundos por respuesta.

Los planes estándar promedian 19-24 segundos.

Nuestra capa de cálculo responde en menos de 300ms — el tiempo total depende solo de la velocidad del LLM, típicamente 2-5 segundos con streaming.

Eso es 4-10x más rápido.

En precios, las alternativas cobran $0.25-$0.87 por consulta IA — además de la cuota mensual.

Nuestro precio tiene tres componentes: (1) créditos de plataforma por turno — 25 hosted o 2 BYOK, (2) créditos de endpoint por cada herramienta que invoca el agente (p.

ej.

carta natal = 1 crédito, astrocartography = 5 créditos, informe PDF = 35 créditos) y (3) tus propios costos de LLM si usas BYOK.

Ejemplo: un turno de interpretación natal cuesta 25 + 1 = 26 créditos hosted (~$0.02), o 2 + 1 = 3 créditos BYOK (~$0.002) más ~$0.003 de costo LLM.

Eso es 10-100x más barato por turno de conversación que las alternativas.

Incluimos el chat en nuestro nivel gratuito estándar: 50 requests al mes, sin tarjeta de crédito.

4-10x más rápido y 10-100x más barato que los competidores

1 min read

Use Cases

Apps Móviles de Astrología

Añade un astrólogo conversacional con IA a tu app iOS o Android. Los usuarios preguntan en lenguaje natural y obtienen interpretaciones personalizadas respaldadas por cálculos reales de carta. El SDK de OpenAI funciona de forma nativa con React Native y Flutter.

Plataformas de Citas y Compatibilidad

Las sesiones multi-sujeto permiten análisis de compatibilidad en tiempo real entre dos usuarios. El agente calcula sinastría, cartas compuestas y dinámicas de relación — todo en un solo flujo de conversación.

Pipelines de Generación de Contenido

Genera horóscopos personalizados, pronósticos semanales e informes natales a escala. BYOK con un modelo costo-eficiente (GPT-5-nano) y procesa por lotes 2.800+ usuarios para contenido diario de email o notificaciones push.

Plataformas de Bienestar y Salud Mental

Integra insights astrológicos en apps de mindfulness, herramientas terapéuticas y plataformas de auto-reflexión. El modo de tradición psicológica ofrece interpretaciones de estilo jungiano centradas en el crecimiento y la autoconciencia.

Plataformas SaaS de Astrología

Marca blanca del agente completo como tu propio producto. Los prompts de sistema personalizados definen la personalidad, BYOK controla los costos y la persistencia de sesión habilita consultas multi-turno para suscriptores de pago.

Frameworks de Agentes IA

Conéctate directamente a LangChain, CrewAI, AutoGen o cualquier framework de agentes compatible con OpenAI. Nuestra API se convierte en una herramienta de astrología especializada dentro de tu sistema multi-agente — sin adaptadores personalizados.

Vibe Coding con Herramientas de IA

Dile a Lovable, Claude Code, Cursor o Windsurf que te construya un widget de astrología — y obtén una app funcional en minutos. Como nuestra API sigue el protocolo de OpenAI, las herramientas de código IA generan integraciones correctas a la primera. Widgets de chat, generadores de horóscopo, comprobadores de compatibilidad — descríbelo y publícalo.

Technical Specifications

Protocolo API	OpenAI Chat Completions (v1)
Endpoints	/chat/completions (hosted) + /chat/completions/byok
Formateador de Contexto LLM	to_prompt_text() con 3 presets
Valores de Preset	minimal \| full \| traditional
Rango de Tokens por Preset	minimal 150-250 · full 500-800 · traditional 600-900
Formato de Aspectos	'Mars square Saturn within 2°' (lenguaje natural)
Prefijos Tránsito/Natal	t.Jupiter trine n.Venus
Idiomas del Formateador de Prompt	7 (en, de, es, fr, it, pt, ru)
Strings i18n en el Formateador	~40 en 7 idiomas
Herramientas de Agente	16 auto-generadas desde 82 endpoints
Velocidad de Cálculo	<300ms por llamada de herramienta
Tiempo de Respuesta Total	2-5s con streaming
Streaming	SSE con eventos de extensión tool_start/tool_end
Proveedores BYOK	OpenAI, Anthropic, OpenRouter (50+ modelos)
Modelo Hosted	astro-default (optimizado para astrología)
Persistencia de Sesión	Respaldado por Redis, TTL deslizante de 24h
Multi-Sujeto	Sujetos ilimitados por sesión
Artefactos Binarios	SVG, PNG, JPG, WebP, PDF vía chat
Idiomas de Interpretación	9 (en, de, fr, es, it, pt, ru, zh, hi)
Tradiciones	Clásica, Psicológica, Orientada a Eventos, Universal
Autenticación	Bearer token (API key)
Límite de Tasa	Por API key, configurable

API de Chat de Astrología vs Enfoque DIY de Volcado JSON

Feature	Astrology API	Others
Tokens del Prompt LLM (por carta)	150-900 (según preset)	1.500-3.000 (JSON crudo)
Costo de Tokens por Prompt	~60% menos que el volcado JSON	Gasto total de tokens en cada turno
Legibilidad de Aspectos	'Mars square Saturn within 2°'	'Mars 0d 90.0 Saturn' (críptico)
Desambiguación Tránsito/Natal	Prefijos t. / n. incorporados	El modelo adivina (alucinaciones)
Contexto de Prompt Multilingüe	7 idiomas (~40 strings i18n)	Solo inglés o traduce tú mismo
Tasa de Alucinaciones	Baja — fundamentado en lenguaje natural	Alta — códigos crípticos confunden a los LLMs
Compatible con OpenAI SDK	Sí (drop-in)	No (APIs personalizadas)
Elección de Modelo BYOK	50+ modelos (3 proveedores)	Modelo propietario bloqueado
Ciclo de Agente del Servidor	16 herramientas, automático	Constrúyelo tú mismo
Sesiones Multi-Sujeto	Sujetos ilimitados	Una sola carta natal
Artefactos Binarios	PDF, SVG, PNG vía chat	No disponible
Tiempo de Respuesta	2-5s (streaming)	8-24 segundos
Precio por Consulta	$0.001-$0.02	$0.25-$0.87
Nivel Gratuito	50 requests/mes	Ninguno o sandbox de pago
Herramientas de Código IA (Vibe Coding)	Funciona al instante (protocolo OpenAI)	Formatos propietarios, solo código manual

APIs de Astrología Relacionadas

API de Carta Natal

Calcula cartas natales completas con posiciones planetarias, casas y aspectos

API de Tránsitos

Tránsitos planetarios actuales — combina con to_prompt_text() para contexto de chatbot

API de Astrología Tradicional

Técnicas helenísticas y medievales — encaja con la profundidad del preset 'traditional'

API de Timing

Timing electivo y de eventos — útil en prompts de chat para preguntas de pronóstico

API de Horaria

Endpoint horario con IA — combina de forma natural con el agente de chat para lecturas basadas en preguntas

API de Sinastría

Análisis de compatibilidad entre dos cartas

API de Informes PDF

Genera informes profesionales de astrología en PDF multipágina

Documentación de API

Referencia técnica completa con ejemplos interactivos

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

Copia este prompt en Lovable, Claude Code, Cursor o cualquier herramienta de código IA:

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.

Precios Simples y Transparentes

Comienza gratis, escala a medida que creces. Sin cargos ocultos.

Siempre Gratis

Sin Tarjeta de Credito

Perfecto para aprender, probar y proyectos personales pequenos

50 llamadas API/mes

Cartas natales basicas

5 sistemas de casas

Soporte comunitario

Pro

$11/mes

Para apps pequenas y proyectos personales

Todos los endpoints basicos
12 sistemas de casas
Soporte por email

Mejor Valor

Pro Plus

$21/mes

Para apps en crecimiento y trafico medio

Todos los endpoints mejorados
18 sistemas de casas
Interpretaciones con IA
Soporte email prioritario

Ultra

$37/mes

Para aplicaciones de astrologia profesionales

Credit math ↓

Todos los endpoints premium
23 sistemas de casas
Interpretaciones IA avanzadas
Soporte prioritario

Planes de Alto Volumen

Para aplicaciones a escala empresarial

Business

$99/mes

Para aplicaciones de alto volumen

Credit math ↓

TODOS los endpoints
Listo para marca blanca
Ajuste fino de IA personalizado
Soporte telefonico

ILIMITADO

Enterprise

$399+por mes

Peticiones ilimitadas con infraestructura dedicada

Infraestructura de servidor dedicado
Sub-300ms garantizado
Soporte dedicado 24/7
99.99% uptime SLA

Todos los planes incluyen documentacion completa y SDKs

Preguntas? Habla con nuestro equipo

Preguntas Frecuentes Sobre la API de Chat de Astrología

Respuestas reales sobre la plataforma agéntica de astrología

Construye tu Stack Completo de Astrología

La API de Chat orquesta estos endpoints de forma automática, pero también puedes usarlos directamente:

API de Carta Natal cálculos de carta crudos detrás del chat API de Tránsitos influencias planetarias actuales para el contexto del prompt API de Astrología Tradicional profundidad helenística — encaja con el preset 'traditional'API de Timing timing electivo y consultas de pronóstico API de Horaria endpoint horario con IA — encaja con el agente de chat API de Sinastría análisis de relaciones y compatibilidad API de Informes PDF documentos profesionales multipágina Servidor MCP de Astrología integración con Claude Desktop

Lanza Chatbots de Astrología

Agente compatible con OpenAI, 16 herramientas, BYOK y contexto to_prompt_text() en 7 idiomas. Reduce los costos de tokens del LLM en ~60% frente a volcar JSON crudo.

Empieza Gratis Ver Documentación API

50 requests gratis/mes

Compatible con OpenAI SDK

Sin tarifas de configuración

Más que un Chat. Construye Agentes de IA Astrológica

Ve al Agente en Acción

Volcar JSON Crudo en los Prompts del LLM Desperdicia Tokens y Provoca Alucinaciones

Contexto LLM Optimizado en Tokens + Plataforma de Agentes Completa en Una Sola API

Rendimiento de la Plataforma

Funcionalidades Completas de la Plataforma de Agentes

Formateador de Contexto LLM to_prompt_text()

Bring Your Own Key (BYOK)

Streaming SSE y Eventos

16 Herramientas de Agente Auto-Generadas

Multi-Sujeto y Sesiones

Listo para Widgets con Herramientas de Código IA

Artefactos Binarios y Salidas

¿Qué Es la API de Chat de Astrología? Guía Completa para Desarrolladores

¿Cómo Funciona la API de Chat Agéntica?

¿Qué Es BYOK y Por Qué Importa?

¿Por Qué Es la Única Opción Compatible con OpenAI?

Perfecto para Vibe Coding — Construye Widgets de Astrología en Minutos

¿Qué Pueden Hacer las 16 Herramientas del Agente?

¿Cómo Funcionan las Sesiones Multi-Sujeto y los Artefactos?

Cómo to_prompt_text() Reduce los Costos de Tokens del LLM en ~60%

Aspectos en Lenguaje Natural y Prefijos t./n.

Rendimiento y Precios vs Competidores

Use Cases

Apps Móviles de Astrología

Plataformas de Citas y Compatibilidad

Pipelines de Generación de Contenido

Plataformas de Bienestar y Salud Mental

Plataformas SaaS de Astrología

Frameworks de Agentes IA

Vibe Coding con Herramientas de IA

Technical Specifications

API de Chat de Astrología vs Enfoque DIY de Volcado JSON

APIs de Astrología Relacionadas

API de Carta Natal

API de Tránsitos

API de Astrología Tradicional

API de Timing

API de Horaria

API de Sinastría

API de Informes PDF

Documentación de API

References & Standards

Precios Simples y Transparentes

Siempre Gratis

Pro

Pro Plus

Ultra

Planes de Alto Volumen

Business

Enterprise

Preguntas Frecuentes Sobre la API de Chat de Astrología

¿Qué es la API de Chat de Astrología y en qué se diferencia de un chatbot normal?

¿Puedo usar el SDK de Python o TypeScript de OpenAI con esta API?

¿Qué modelos LLM son compatibles con BYOK?

¿Cuánto cuesta cada turno de chat en créditos?

¿Cómo funciona el chat multi-sujeto para sinastría y compatibilidad?

¿Puede el chat generar informes PDF e imágenes SVG de cartas?

¿Qué tan rápida es la API de Chat de Astrología comparada con las alternativas?

¿Qué son los eventos de extensión del streaming SSE?

¿Cómo funcionan las sesiones y la memoria de la conversación?

¿Qué lenguajes de programación y frameworks son compatibles?

¿Es solo un wrapper de GPT o usa datos astronómicos reales?

¿Cómo controlo el estilo y la longitud de las respuestas?

¿Qué tradiciones astrológicas y sistemas de casas son compatibles?

¿Puedo ofrecerlo como mi propio producto con marca blanca?

¿Qué pasa si una llamada de herramienta falla durante la conversación?

¿Puedo construir un widget de astrología con Lovable, Claude Code o Cursor?

¿Cómo se compara la API de Chat de Astrología con construir la mía propia con RoxyAPI o endpoints de datos crudos?

¿Qué es to_prompt_text() y por qué debería importarle a los desarrolladores de chatbots?

¿Qué preset debería usar — minimal, full o traditional?

¿Cuánto reduce el formateador de prompt los costos de tokens del LLM?

¿Qué idiomas soporta to_prompt_text()?

¿Cómo se formatean los aspectos en lenguaje natural?

¿Qué significan los prefijos t. y n. en la salida formateada?

Construye tu Stack Completo de Astrología

Lanza Chatbots de Astrología

Ve al Agente en Acción

Volcar JSON Crudo en los Prompts del LLM Desperdicia Tokens y Provoca Alucinaciones

Contexto LLM Optimizado en Tokens + Plataforma de Agentes Completa en Una Sola API