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.

40 herramientas del lado del servidor, elección de modelo BYOK, streaming SSE con reintento automático, 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 nuestras 40 herramientas 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 40 herramientas, reintento automático ante fallos upstream, 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

40 Herramientas Astrológicas Integradas

Reintento Automático y Confiabilidad

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, activas las herramientas que quieres vía astrology.enabled_tools, y el servidor invoca hasta 40 herramientas astrológicas — cartas natales, tránsitos, sinastría, informes de análisis completos, incluso generación de informes PDF — resolviendo los datos de la carta natal a partir de IDs de sujeto (sin fechas inventadas) y devolviendo 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. El servidor también clasifica y reintenta automáticamente los fallos transitorios del modelo upstream, así que un proveedor inestable produce un error limpio en lugar de una respuesta colgada o corrupta. 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 40 Herramientas del Agente?

La plataforma expone 40 herramientas que el LLM puede invocar durante la conversación, activadas por solicitud vía astrology.enabled_tools — nada se ejecuta a menos que lo listes.

Cálculos de Carta (10 herramientas) — natal, tránsitos, sinastría, compuesta, davison, dracónica, armónica, heliocéntrica, espacio-local y cartas antiscia con posiciones planetarias y aspectos completos.

Renderizado de Cartas (11 herramientas) — el mismo conjunto de cartas como imágenes SVG, PNG, JPG, WebP o PDF, guardadas como artefactos binarios con URLs compartibles.

Informes de Análisis (4 herramientas) — informes natales completos, análisis lunar, informes de sinastría e informes de relocalización con interpretaciones multi-sección.

Generación de Informes PDF (10 herramientas) — el agente puede disparar un PDF premium a mitad del chat: mapa arquetípico, compuesta, retorno lunar, hoja de ruta multi-año, natal, relocalización, retorno de Saturno, retorno solar, sinastría o informe Vedic Kundli.

Consultas de Datos (3 herramientas) — posiciones planetarias actuales, una matriz de aspectos y la hora astrológica actual.

Horóscopo (1 herramienta) — horóscopo diario personalizado.

Rectificación (1 herramienta) — búsqueda de hora de nacimiento.

Como los nombres de las herramientas mapean directamente a las rutas de los endpoints (/charts/natal se convierte en charts_natal, no en natal_chart), un nombre mal escrito simplemente se descarta — pasa nombres exactos y siempre adjunta sujetos con birth_data, ya que las herramientas resuelven sujetos por ID en lugar de leer los datos de nacimiento de la propia llamada.

40 herramientas, activadas por solicitud — el modelo puede traer una carta real o generar un informe PDF a mitad de conversación

2 min read

¿Qué Tan Confiable Es la API de Chat? Reintento Automático y Caché de Prompts

Un pase de confiabilidad ya publicado clasifica los fallos transitorios del modelo upstream y los reintenta automáticamente antes de que lleguen a tu app.

Antes, una respuesta upstream inestable podía colgar la conexión o devolver una respuesta parcial corrupta; ahora un fallo que no se puede recuperar sale como un 502 limpio (sin streaming) o un chunk terminal del stream (SSE) — tu manejo de errores recibe una señal predecible en lugar de un bloqueo silencioso.

Eso significa muchas menos sesiones de chat rotas para quienes construyen sobre este endpoint.

Un ajuste complementario cambió cómo se ensambla el prompt de sistema: ahora se divide en un preámbulo siempre activo más un bloque de reglas de uso de herramientas que solo se carga cuando realmente se resuelven herramientas para esa solicitud.

Esto corrigió una clase de fallos de completion vacía que aparecían desproporcionadamente en los niveles de modelo más ligeros y rápidos, y significa que el comportamiento de la caché de prompts ahora sigue el conjunto de herramientas que realmente activaste en lugar de un prompt estático fijo — costos más baratos y predecibles para quienes llaman con alto volumen y varían enabled_tools entre solicitudes.

Reintento automático ante fallos transitorios upstream, más una caché que sigue las herramientas que realmente activas

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	40, activadas por solicitud vía astrology.enabled_tools
Manejo de Fallos Upstream	Clasificación y reintento automático, 502 limpio o chunk terminal del stream ante fallo
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	40 herramientas, activadas por solicitud	Constrúyelo tú mismo
Manejo de Fallos Upstream	Reintento automático + señal de error limpia	Bloqueos silenciosos o salida corrupta
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

¿Qué herramientas puede invocar la IA?

Técnico

¿Qué pasa si el modelo de IA falla a mitad de la respuesta?

Precios

¿El uso de herramientas afecta la caché de respuestas o el costo?

Construye tu Stack Completo de Astrología

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

Lanza Chatbots de Astrología

Agente compatible con OpenAI, 40 herramientas, BYOK, reintento automático ante fallos upstream 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

40 Herramientas Astrológicas Integradas

Reintento Automático y Confiabilidad

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 40 Herramientas del Agente?

¿Qué Tan Confiable Es la API de Chat? Reintento Automático y Caché de Prompts

¿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

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?

¿Puede la API de chat traer mi carta natal real durante una conversación?

¿Qué herramientas puede invocar la IA?

¿Qué pasa si el modelo de IA falla a mitad de la respuesta?

¿El uso de herramientas afecta la caché de respuestas o el costo?