O que é a API de Chat Astrológico e como ela difere de um chatbot comum?

A API de Chat Astrológico é uma plataforma agêntica — não apenas um wrapper de chatbot. Quando você envia uma mensagem, o servidor decide autonomamente quais das 16 ferramentas de astrologia invocar (mapas natais, trânsitos, sinastria, etc.), executa-as contra nossos 82 endpoints de cálculo e sintetiza uma resposta fundamentada. Diferente de chatbots genéricos que alucinam dados astrológicos, cada interpretação é respaldada por cálculos reais de efemérides. Todo o loop de agente roda server-side em uma única chamada de API.

Posso usar o SDK Python ou TypeScript do OpenAI com esta API?

Sim — esse é o princípio central do design. Implementamos o protocolo padrão OpenAI /chat/completions, então você usa o SDK oficial do OpenAI em qualquer linguagem: TypeScript (pacote npm openai), Python (pacote pip openai), Go, Rust ou qualquer client HTTP. Basta trocar a base URL para nosso endpoint. Seu código OpenAI existente funciona com mudanças mínimas. Isso também significa compatibilidade instantânea com LangChain, Vercel AI SDK e qualquer framework compatível com OpenAI.

Quais modelos LLM são suportados com BYOK?

O BYOK suporta três provedores com 50+ modelos. OpenAI: famílias GPT-5, GPT-5-mini, GPT-5-nano, o3, o4. Anthropic: Claude Opus 4, Sonnet 4, Haiku 4. OpenRouter: qualquer modelo hospedado por eles — Gemini 3, Grok 4, Llama, Mistral, Qwen e mais. Você passa sua própria chave de API e ID do modelo. A plataforma lida com todas as peculiaridades específicas de cada provedor (como diferenças de parâmetros em modelos de raciocínio) automaticamente.

Como funciona o chat multi-sujeito para sinastria e compatibilidade?

Passe múltiplos sujeitos no array astrology.subjects, cada um com um ID semântico ('eu', 'parceiro(a)', 'filho(a)') e dados de nascimento. O LLM referencia sujeitos pelo ID ao chamar ferramentas — o servidor resolve IDs para coordenadas completas de nascimento. Isso possibilita sinastria, mapas compostos e análise multi-pessoa em uma única conversa. Nenhum concorrente suporta mais de um sujeito por sessão.

O chat pode gerar relatórios PDF e imagens de mapa SVG?

Sim — artefatos binários são um recurso exclusivo. Peça 'Gere meu mapa natal' e o agente chama a ferramenta render_natal, produz um SVG (ou PNG/PDF), armazena como artefato e retorna uma URL compartilhável. O mesmo vale para relatórios PDF natais — documentos profissionais multi-páginas com visualização de roda, interpretações e temas. Artefatos são armazenados no Supabase com retenção de 24 horas e URLs compartilháveis.

Quão rápida é a API de Chat Astrológico comparada às alternativas?

Nossa camada de cálculo responde em menos de 300ms por chamada de ferramenta. O tempo total de resposta (cálculo + geração do LLM) é tipicamente 2-5 segundos com streaming. O caminho padrão das soluções concorrentes leva 19-24 segundos; o 'caminho rápido' deles (apenas planos premium, $120/mês) é 8-12 segundos. Com streaming, nossos usuários veem os primeiros tokens em menos de 2 segundos enquanto o agente continua trabalhando.

O que são os eventos de extensão SSE streaming?

Além dos chunks de texto padrão do OpenAI, emitimos eventos SSE customizados: tool_start (quando o agente começa a chamar uma ferramenta — sua UI pode mostrar 'Calculando mapa natal...'), tool_end (quando a ferramenta retorna — com tempo de execução) e astrology.error (se uma ferramenta falha graciosamente). Esses eventos possibilitam UIs ricas e em tempo real que mostram o processo de raciocínio do agente enquanto trabalha.

Como funcionam as sessões e memória de conversa?

Passe astrology.session_id na sua requisição. No primeiro turno, o servidor cria uma sessão baseada em Redis. Nos turnos seguintes com o mesmo ID, o servidor carrega mensagens anteriores e sujeitos antes de processar sua nova mensagem. Sessões têm TTL deslizante de 24 horas — cada interação estende a janela. O servidor gerencia compressão de mensagens para conversas longas, então você não precisa gerenciar janelas de contexto.

Quais linguagens de programação e frameworks são suportados?

Qualquer linguagem com client HTTP funciona, mas SDKs do OpenAI oferecem a melhor experiência: TypeScript/JavaScript (openai), Python (openai), Go (openai-go), Rust, C#, Java, PHP, Ruby. Compatibilidade com frameworks: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI, Haystack — qualquer coisa que fale o protocolo OpenAI. A maioria dos desenvolvedores integra em menos de 30 minutos.

Isso é apenas um wrapper de GPT ou usa dados astronômicos reais?

Cada interpretação astrológica é fundamentada em cálculos reais de efemérides. Quando o agente chama charts_natal, ele computa posições planetárias reais usando a Swiss Ephemeris — o mesmo motor que softwares profissionais de astrologia usam. O LLM recebe dados reais do mapa (posições planetárias, casas, aspectos com orbes exatos) e sintetiza interpretações a partir desses dados. Sem posições planetárias alucinadas, sem aspectos inventados.

Como controlo o estilo e comprimento da resposta?

Três camadas de controle: 1) Mensagem de sistema — defina qualquer personalidade ('psicólogo junguiano acolhedor', 'classicista britânico conciso', etc.). 2) astrology.defaults.detail_level — 'brief' (menos de 100 palavras), standard (200-350 palavras) ou 'detailed' (500-800 palavras). 3) astrology.defaults.tradition — clássica, psicológica, evento-orientada ou universal. A instrução explícita do usuário ('brevemente' ou 'em detalhe') sobrescreve tudo.

Quais tradições astrológicas e sistemas de casas são suportados?

Quatro tradições de interpretação: Clássica (Helenística/medieval), Psicológica (Junguiana), Evento-Orientada (horária/eletiva) e Universal (equilibrada). Vinte e três sistemas de casas incluindo Placidus, Koch, Signo Inteiro, Igual, Campanus, Regiomontanus, Porphyry e mais. Configure via astrology.defaults.house_system — o servidor aplica a todas as chamadas de ferramenta automaticamente.

Posso usar white-label como meu próprio produto?

Com certeza. O prompt de sistema (messages[0] com role='system') controla toda a personalidade. Defina a voz da sua marca, persona do astrólogo, estilo de linguagem — o usuário nunca vê nossa marca. BYOK dá controle de custos. Persistência de sessão habilita modelos de assinatura. Os planos de preços padrão suportam redistribuição comercial.

O que acontece se uma chamada de ferramenta falhar durante a conversa?

Degradação graciosa. Se uma ferramenta retorna erro (dados de nascimento inválidos, cálculo não suportado), o agente recebe a mensagem de erro e se adapta — pode tentar uma ferramenta diferente, pedir esclarecimento ao usuário ou fornecer uma resposta parcial. Com streaming, você recebe um evento astrology.error. A conversa não quebra; o LLM lida com erros de forma conversacional, como um astrólogo humano faria.

Como a API de Chat Astrológico se compara a construir sua própria com RoxyAPI ou endpoints de dados brutos?

RoxyAPI e APIs similares de dados brutos fornecem JSON de cálculo bruto — você constrói toda a camada de agente por conta própria: schemas de ferramentas, orquestração de LLM, tratamento de erros, gerenciamento de sessão, armazenamento de artefatos. São meses de engenharia. Nossa plataforma entrega tudo isso pronto. Uma chamada de API substitui centenas de linhas de código de framework de agente. Se você já usa LangChain ou CrewAI, nosso endpoint se conecta como uma única ferramenta — seu framework de agente existente cuida do resto.

Posso criar um widget de astrologia com Lovable, Claude Code ou Cursor?

Sim — e essa é uma das maiores vantagens da nossa API. Como usamos o protocolo padrão OpenAI /chat/completions, qualquer ferramenta de código IA (Lovable, Claude Code, Cursor, Windsurf, Bolt, Replit Agent) já sabe gerar integrações corretas automaticamente. Descreva o que quer — 'widget de horóscopo diário com interpretação IA' — e a ferramenta produz código funcional em minutos. APIs concorrentes com formatos proprietários não funcionam nesse fluxo porque as ferramentas de IA não reconhecem o protocolo. Vibe coding com astrologia só funciona de verdade com protocolo OpenAI.

NOVO: Plataforma de Agentes IA

Mais que Chat. Crie Agentes de IA Astrológicos

A única plataforma agêntica compatível com OpenAI para astrologia.

16 ferramentas server-side, escolha de modelo BYOK, streaming SSE, sessões multi-sujeito. Uma chamada de API, loop de agente completo.

Ver Documentação da API

Ferramentas de Agente

Endpoints por Trás

Idiomas

<2s

Resposta Total

Drop-In para OpenAI SDK

Traga Sua Própria Chave

Loop de Agente Server-Side

Veja o Agente em Ação

Conversas reais impulsionadas por orquestração de ferramentas server-side

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

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

Funciona com qualquer um dos nossos 16 endpoints ou combinações

Vedic Jyotish

Perguntas Horárias

Human Design

Astrocartography

Numerologia

Tarot Reading

Sinastria de Relacionamentos

Previsão de Trânsitos

Qualquer combinação de endpoint em uma sessão — natal, Vedic, horary, BaZi, astrocartography e mais.Hosted: 25 + créditos endpoint/turno · BYOK: 2 + créditos endpoint + custos LLM

Preso a modelos proprietários desconhecidos, sem escolha ou transparência
APIs JSON personalizadas exigindo código de integração específico para cada plataforma
Construa seu próprio loop de ferramentas: parse endpoints, gerencie estado, trate erros
Tempos de resposta de 8-24 segundos em soluções concorrentes
$0.25-$0.87 por consulta de IA — custos disparam conforme os usuários crescem

Transforme com

BYOK: Escolha GPT-5, Claude 4, Gemini 3, Grok ou qualquer modelo OpenRouter
Drop-in para OpenAI SDK — funciona com LangChain, Vercel AI SDK, qualquer client
Loop de agente server-side: 16 ferramentas auto-chamadas, sujeitos resolvidos, artefatos gerados
Cálculos sub-segundo + velocidade LLM — 2-5s total vs 8-24s dos concorrentes
Hosted: 25 credits/turno (LLM incluído) · BYOK: 2 credits/turno + seus custos LLM · + créditos de endpoint por chamada de ferramenta

Performance da Plataforma

Velocidade enterprise, preços amigáveis para desenvolvedores

Ferramentas de Agente

<300ms

Velocidade de Cálculo

Idiomas

50+

Modelos LLM

Recursos Completos da Plataforma de Agentes

Tudo o que você precisa para criar experiências astrológicas com IA

Bring Your Own Key (BYOK)

Streaming SSE e Eventos

16 Ferramentas de Agente Auto-Geradas

Multi-Sujeito e Sessões

Pronto para Widgets com Ferramentas de Código IA

Artefatos Binários e Saídas

O Que É a API de Chat Astrológico? Guia Completo para Desenvolvedores

Tudo o que você precisa para criar experiências astrológicas com IA

E se você pudesse adicionar um agente de IA astrológico totalmente funcional ao seu app com uma única chamada de API? É exatamente isso que a API de Chat Astrológico faz. Não é apenas um endpoint de chatbot — é uma plataforma agêntica completa que executa todo o loop de chamada de ferramentas no server-side. Você envia uma mensagem do usuário, e o servidor decide autonomamente quais das 16 ferramentas de astrologia invocar, resolve dados do mapa natal a partir de IDs de sujeito (sem datas alucinadas), gera relatórios PDF ou gráficos SVG como artefatos binários, e retorna uma resposta coerente — tudo através de um endpoint /chat/completions compatível com OpenAI. Isso significa que você pode usar o SDK padrão do OpenAI em TypeScript, Python, Go ou qualquer linguagem. Sem código de integração personalizado. Sem construir seu próprio framework de agente. Sem gerenciar schemas de ferramentas. Soluções concorrentes ($0.25-$0.87/consulta, respostas de 8-24 segundos) e outras plataformas (modelo proprietário travado, formato JSON customizado) exigem que você construa a camada de agente por conta própria. Somos a única plataforma que entrega tudo pronto, com suporte BYOK para que você escolha seu próprio LLM — GPT-5, Claude, Gemini, Grok ou qualquer um dos 50+ modelos no OpenRouter.

Como Funciona a API de Chat Agêntica?

A API de Chat Astrológico funciona como um agente de IA especializado que conhece astrologia profundamente.

Aqui está o fluxo: 1) Você envia uma mensagem via endpoint padrão OpenAI /chat/completions.

2) O servidor injeta contexto astrológico — dados de nascimento dos seus sujeitos, ferramentas ativas, preferências de idioma.

3) O LLM decide quais ferramentas chamar (cálculo de mapa natal, análise de trânsitos, relatório de sinastria, etc.).

4) O servidor executa essas ferramentas internamente contra nossos 82 endpoints de astrologia — sem chamadas extras de API do seu lado.

5) Os resultados das ferramentas são devolvidos ao LLM para síntese.

6) Você recebe uma interpretação coerente e fundamentada com dados planetários reais.

Todo o loop de ferramentas roda server-side em uma única requisição.

Você nunca vê mensagens de chamada de ferramenta — apenas a resposta final.

Com streaming habilitado (SSE), você também recebe eventos de extensão em tempo real como tool_start e tool_end, para que sua UI possa mostrar 'Calculando mapa de trânsitos...' enquanto o agente trabalha.

Todo o loop de agente roda server-side em uma única chamada de API

1 min read

O Que É BYOK e Por Que Isso Importa?

BYOK — Bring Your Own Key (Traga Sua Própria Chave) — significa que você escolhe qual LLM alimenta seu agente astrológico.

Todas as outras APIs de chat astrológico travam você em seus modelos proprietários.

Alternativas no mercado usam modelos internos sem alternativas, e outras plataformas nem divulgam qual modelo usam.

Com nosso endpoint BYOK (/chat/completions/byok), você passa sua própria chave de API e ID do modelo.

Suportamos três provedores: OpenAI (GPT-5, GPT-5-mini, GPT-5-nano, o3, o4), Anthropic (Claude Opus 4, Claude Sonnet 4, Claude Haiku 4) e OpenRouter (50+ modelos incluindo Gemini 3, Grok 4, Llama, Mistral e mais).

Por que isso importa? Controle de custos — GPT-5-nano é 10x mais barato que GPT-5-pro.

Ajuste de qualidade — Claude se destaca em interpretação nuançada, Gemini é mais rápido para consultas simples.

Compliance — algumas empresas exigem provedores de modelo específicos.

BYOK custa apenas 2 créditos/turno (nossa taxa de plataforma) mais o que seu provedor de LLM cobrar.

50+ modelos LLM disponíveis — você escolhe custo, qualidade e provedor

1 min read

Por Que Esta É a Única Opção Compatível com OpenAI?

Compatibilidade com OpenAI significa que você usa o SDK padrão do OpenAI — a mesma biblioteca client que milhões de desenvolvedores já conhecem.

Sem novo SDK para aprender, sem client HTTP personalizado para construir.

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

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

É isso.

Seu código existente para ChatGPT funciona com mudanças mínimas.

Isso também significa compatibilidade instantânea com todo framework construído sobre o protocolo OpenAI: LangChain, LlamaIndex, Vercel AI SDK, Semantic Kernel, AutoGen, CrewAI.

Se seu framework fala OpenAI, ele fala API de Chat Astrológico.

Nenhum outro provedor de astrologia oferece isso.

Soluções concorrentes usam endpoints customizados com formatos proprietários de requisição/resposta e autenticação própria.

Todas exigem código de integração personalizado para cada plataforma que você suporta.

Funciona com qualquer OpenAI SDK — TypeScript, Python, Go, Rust e todo framework de IA

1 min read

Perfeito para Vibe Coding — Crie Widgets de Astrologia em Minutos

A API de Chat Astrológico é a escolha ideal para vibe coding — o movimento onde desenvolvedores usam ferramentas de código com IA para criar projetos funcionais em minutos, não em semanas.

Como implementamos o protocolo padrão OpenAI /chat/completions, qualquer ferramenta de código IA — Lovable, Claude Code, Cursor, Windsurf, Bolt, Replit Agent — consegue gerar integrações funcionais instantaneamente.

Basta descrever o que você quer: 'crie um widget que mostra o mapa natal do usuário com interpretação por IA'.

A ferramenta de código IA reconhece o formato OpenAI, gera o código de integração e você tem um widget funcional em minutos.

Sem documentação proprietária para estudar, sem SDKs customizados para instalar.

APIs concorrentes com formatos JSON proprietários quebram completamente nesse fluxo — as ferramentas de IA não conseguem gerar integrações porque o formato não é padronizado.

Protocolo OpenAI é a língua universal que toda ferramenta de código IA já domina.

Copie este prompt no Lovable, Claude Code, Cursor ou qualquer ferramenta de código IA:

Lovable, Claude Code, Cursor, Windsurf — qualquer ferramenta de código IA cria integrações funcionais instantaneamente

1 min read

O Que as 16 Ferramentas de Agente Podem Fazer?

A plataforma expõe 16 ferramentas que o LLM pode invocar autonomamente durante uma conversa.

Elas são auto-geradas a partir de nossos 82 endpoints existentes usando um registro dinâmico — apenas endpoints marcados como 'chat-safe' se tornam ferramentas.

As ferramentas cobrem: Análise (3 ferramentas) — relatórios natais com interpretações multi-seção, análise lunar com fases da lua e mansões, relatórios de sinastria com índices de compatibilidade.

Cálculos de Mapas (4 ferramentas) — mapas natal, sinastria, composto e trânsitos com posições planetárias completas e aspectos.

Renderização de Mapas (4 ferramentas) — mapas natal, sinastria, trânsitos e composto como SVG, PNG, JPG, WebP ou PDF.

Mapas gerados são armazenados como artefatos binários com URLs compartilháveis.

Dados (3 ferramentas) — posições planetárias atuais, efemérides para qualquer data e matrizes de aspectos.

Horóscopo (1 ferramenta) — horóscopo diário personalizado com 6 áreas da vida, classificações e influências planetárias.

PDF (1 ferramenta) — relatório natal profissional multi-páginas com visualização de roda, interpretações e temas.

Adicionar novas ferramentas não requer mudanças de código no endpoint de chat — basta marcar um endpoint existente como 'chat-safe'.

16 ferramentas auto-geradas a partir de 82 endpoints — novas ferramentas sem mudanças de código

1 min read

Como Funcionam Sessões Multi-Sujeito e Artefatos?

Dois recursos que nenhum concorrente oferece: sessões multi-sujeito e artefatos binários.

Multi-sujeito significa que você pode passar múltiplos mapas natais em uma única conversa — por exemplo, 'eu' e 'parceiro(a)'.

O LLM referencia sujeitos pelo ID semântico ao chamar ferramentas, e o servidor resolve para os dados completos de nascimento.

Isso possibilita análise de sinastria, comparações de mapa composto e dinâmicas familiares — tudo em uma sessão de chat, sem re-enviar dados de nascimento.

Nenhuma outra API de chat suporta mais de um sujeito por conversa.

Artefatos binários permitem que o chat gere arquivos baixáveis.

Peça 'Gere meu mapa natal' e receba uma imagem SVG do mapa.

Peça 'Crie um relatório PDF' e obtenha um documento profissional multi-páginas.

Artefatos são armazenados no Supabase com URLs compartilháveis e retenção de 24 horas.

Sessões persistem via Redis com TTL deslizante de 24 horas.

Passe o mesmo session_id entre turnos e o servidor restaura histórico de conversa, sujeitos e contexto — memória multi-turno real sem gerenciamento de estado no client-side.

Sessões multi-sujeito e artefatos binários — ambos exclusivos da nossa plataforma

1 min read

Performance e Preços vs Concorrentes

Vamos falar de números.

O tempo de resposta padrão das alternativas no mercado é 19-24 segundos.

O 'caminho rápido' deles (apenas planos premium) é 8-12 segundos.

Nossa camada de cálculo responde em menos de 300ms — o tempo total de resposta depende apenas da velocidade do LLM, tipicamente 2-5 segundos com streaming.

Isso é 4-10x mais rápido.

Em preços, soluções concorrentes cobram $0.25 para consultas simples, $0.47 padrão, $0.87 complexas — além de planos mensais a partir de $12.

Nosso preço tem três componentes: taxa de plataforma por turno + créditos de endpoint por chamada de ferramenta + custo LLM (apenas BYOK).

Modo hospedado: 25 credits/turno (LLM incluído) + créditos de endpoint por cada ferramenta chamada.

Modo BYOK: 2 credits/turno + créditos de endpoint + seus custos LLM diretos.

Exemplo: uma interpretação natal hospedada = 25 (plataforma) + 1 (endpoint natal) = 26 credits total (~$0.02 no plano Professional).

A mesma consulta em BYOK = 2 (plataforma) + 1 (endpoint) + custo LLM = 3 credits + LLM.

Isso é 10-100x mais barato por turno de conversa.

Outras plataformas não publicam preços de chat (baseado em créditos, opaco).

Seus endpoints padrão de cálculo custam $1 por 1.000 chamadas.

Nenhum concorrente oferece tier gratuito para chat.

Incluímos chat no nosso tier gratuito padrão: 50 requisições por mês, sem cartão de crédito.

4-10x mais rápido e 10-100x mais barato que concorrentes

2 min read

Use Cases

Apps Móveis de Astrologia

Adicione um astrólogo de IA conversacional ao seu app iOS ou Android. Usuários fazem perguntas em linguagem natural e recebem interpretações personalizadas baseadas em cálculos reais de mapa. O OpenAI SDK funciona nativamente com React Native e Flutter.

Plataformas de Namoro e Compatibilidade

Sessões multi-sujeito possibilitam análise de compatibilidade em tempo real entre dois usuários. O agente calcula sinastria, mapas compostos e dinâmicas de relacionamento — tudo em um único fluxo de conversa.

Pipelines de Geração de Conteúdo

Gere horóscopos personalizados, previsões semanais e relatórios natais em escala. BYOK com um modelo econômico (GPT-5-nano) e processe em lote 10.000+ usuários para conteúdo diário de e-mail ou notificações push.

Plataformas de Bem-Estar e Saúde Mental

Integre insights astrológicos em apps de mindfulness, ferramentas terapêuticas e plataformas de auto-reflexão. O modo de tradição psicológica fornece interpretações no estilo junguiano focadas em crescimento e autoconhecimento.

Plataformas SaaS de Astrologia

Use white-label para o agente inteiro como seu próprio produto. Prompts de sistema personalizados definem a personalidade, BYOK controla custos e persistência de sessão habilita consultas multi-turno para assinantes pagos.

Frameworks de Agentes de IA

Conecte diretamente ao LangChain, CrewAI, AutoGen ou qualquer framework de agente compatível com OpenAI. Nossa API se torna uma ferramenta especializada de astrologia no seu sistema multi-agente — sem adaptadores customizados necessários.

Vibe Coding com Ferramentas de IA

Descreva seu widget de astrologia em linguagem natural para Lovable, Claude Code, Cursor ou Windsurf e receba código funcional em minutos. O protocolo OpenAI padrão significa que ferramentas de código IA geram integrações corretas automaticamente — sem documentação proprietária, sem SDKs customizados.

Technical Specifications

Protocolo da API	OpenAI Chat Completions (v1)
Endpoints	/chat/completions (hospedado) + /chat/completions/byok
Ferramentas de Agente	16 auto-geradas a partir de 82 endpoints
Velocidade de Cálculo	<300ms por chamada de ferramenta
Tempo Total de Resposta	2-5s com streaming
Streaming	SSE com eventos de extensão tool_start/tool_end
Provedores BYOK	OpenAI, Anthropic, OpenRouter (50+ modelos)
Modelo Hospedado	astro-default (otimizado para astrologia)
Persistência de Sessão	Baseada em Redis, TTL deslizante de 24h
Multi-Sujeito	Sujeitos ilimitados por sessão
Artefatos Binários	SVG, PNG, JPG, WebP, PDF via chat
Idiomas	9 (en, de, fr, es, it, pt, ru, zh, hi)
Tradições	Clássica, Psicológica, Evento-Orientada, Universal
Autenticação	Bearer token (chave de API)
Rate Limiting	Por chave de API, configurável

Comparação de API de Chat Astrológico

Feature	Astrology API	Others
Compatível com OpenAI SDK	Sim (drop-in)	Não (APIs customizadas)
Escolha de Modelo BYOK	50+ modelos (3 provedores)	Modelo proprietário travado
Loop de Agente Server-Side	16 ferramentas, automático	Construa você mesmo
Sessões Multi-Sujeito	Sujeitos ilimitados	Mapa natal único
Artefatos Binários	PDF, SVG, PNG via chat	Não disponível
Tempo de Resposta	2-5s (streaming)	8-24 segundos
Preço Por Consulta	$0.001-$0.02	$0.25-$0.87
Streaming	SSE + eventos de extensão	Básico ou nenhum
Tier Gratuito	50 requisições/mês	Nenhum ou sandbox pago
Ferramentas de Código IA (Vibe Coding)	Funciona instantaneamente (protocolo OpenAI)	Formatos proprietários, apenas codificação manual

APIs de Astrologia Relacionadas

API Mapa Natal

Calcule mapas natais completos com posições planetárias, casas e aspectos

API Sinastria

Análise de compatibilidade de relacionamento entre dois mapas

API Trânsitos

Trânsitos planetários atuais e seus efeitos nos mapas natais

API Relatório PDF

Gere relatórios profissionais de astrologia em PDF multi-páginas

Documentação da API

Referência técnica completa com exemplos interativos

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

Copie este prompt no Lovable, Claude Code, Cursor ou qualquer ferramenta 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.

Precos Simples e Transparentes

Comece gratis, escale conforme cresce. Sem taxas ocultas.

Sempre Gratis

Sem Cartao de Credito

Perfeito para aprender, testar e pequenos projetos pessoais

50 chamadas API/mes

Mapas natais basicos

5 sistemas de casas

Suporte da comunidade

Pro

$11/mes

Para apps pequenos e projetos pessoais

Todos os endpoints basicos
12 sistemas de casas
Suporte por email

Melhor Valor

Pro Plus

$21/mes

Para apps em crescimento e trafego medio

Todos os endpoints aprimorados
18 sistemas de casas
Interpretacoes com IA
Suporte email prioritario

Ultra

$37/mes

Para aplicacoes de astrologia profissionais

Credit math ↓

Todos os endpoints premium
23 sistemas de casas
Interpretacoes IA avancadas
Suporte prioritario

Planos de Alto Volume

Para aplicacoes em escala empresarial

Business

$99/mes

Para aplicacoes de alto volume

Credit math ↓

TODOS os endpoints
Pronto para marca branca
Ajuste fino de IA personalizado
Suporte telefonico

ILIMITADO

Enterprise

$399+por mes

Requisicoes ilimitadas com infraestrutura dedicada

Infraestrutura de servidor dedicado
Sub-300ms garantido
Suporte dedicado 24/7
99,99% uptime SLA

Todos os planos incluem documentacao completa e SDKs

Duvidas? Fale com nossa equipe

Perguntas Frequentes sobre a API de Chat Astrológico

Respostas reais sobre a plataforma agêntica de astrologia

Monte Seu Stack Completo de Astrologia

A API de Chat orquestra esses endpoints automaticamente, mas você também pode usá-los diretamente:

API Mapa Natal para cálculos brutos de mapa API Sinastria para análise de relacionamento API Trânsitos para influências planetárias atuais API Relatório PDF para documentos profissionais Servidor MCP Astrologia para integração com Claude Desktop

Comece a Criar

Junte-se a desenvolvedores construindo a próxima geração de apps de astrologia. Uma chamada de API, loop de agente completo, qualquer LLM.

Começar Grátis Ver Documentação da API

50 requisições grátis/mês

Compatível com OpenAI SDK

Sem taxas de configuração

Mais que Chat. Crie Agentes de IA Astrológicos

Veja o Agente em Ação

Construir IA Astrológica É Mais Difícil Do Que Deveria

Uma Plataforma de Agente Completa, Não Apenas uma API de Chat

Performance da Plataforma

Recursos Completos da Plataforma de Agentes

Bring Your Own Key (BYOK)

Streaming SSE e Eventos

16 Ferramentas de Agente Auto-Geradas

Multi-Sujeito e Sessões

Pronto para Widgets com Ferramentas de Código IA

Artefatos Binários e Saídas

O Que É a API de Chat Astrológico? Guia Completo para Desenvolvedores

Como Funciona a API de Chat Agêntica?

O Que É BYOK e Por Que Isso Importa?

Por Que Esta É a Única Opção Compatível com OpenAI?

Perfeito para Vibe Coding — Crie Widgets de Astrologia em Minutos

O Que as 16 Ferramentas de Agente Podem Fazer?

Como Funcionam Sessões Multi-Sujeito e Artefatos?

Performance e Preços vs Concorrentes

Use Cases

Apps Móveis de Astrologia

Plataformas de Namoro e Compatibilidade

Pipelines de Geração de Conteúdo

Plataformas de Bem-Estar e Saúde Mental

Plataformas SaaS de Astrologia

Frameworks de Agentes de IA

Vibe Coding com Ferramentas de IA

Technical Specifications

Comparação de API de Chat Astrológico

APIs de Astrologia Relacionadas

API Mapa Natal

API Sinastria

API Trânsitos

API Relatório PDF

Documentação da API

References & Standards

Precos Simples e Transparentes

Sempre Gratis

Pro

Pro Plus

Ultra

Planos de Alto Volume

Business

Enterprise

Perguntas Frequentes sobre a API de Chat Astrológico

O que é a API de Chat Astrológico e como ela difere de um chatbot comum?

Posso usar o SDK Python ou TypeScript do OpenAI com esta API?

Quais modelos LLM são suportados com BYOK?

Quanto custa cada turno de chat em créditos?

Como funciona o chat multi-sujeito para sinastria e compatibilidade?

O chat pode gerar relatórios PDF e imagens de mapa SVG?

Quão rápida é a API de Chat Astrológico comparada às alternativas?

O que são os eventos de extensão SSE streaming?

Como funcionam as sessões e memória de conversa?

Quais linguagens de programação e frameworks são suportados?

Isso é apenas um wrapper de GPT ou usa dados astronômicos reais?

Como controlo o estilo e comprimento da resposta?

Quais tradições astrológicas e sistemas de casas são suportados?

Posso usar white-label como meu próprio produto?

O que acontece se uma chamada de ferramenta falhar durante a conversa?

Como a API de Chat Astrológico se compara a construir sua própria com RoxyAPI ou endpoints de dados brutos?

Posso criar um widget de astrologia com Lovable, Claude Code ou Cursor?

Monte Seu Stack Completo de Astrologia

Comece a Criar

Veja o Agente em Ação

Construir IA Astrológica É Mais Difícil Do Que Deveria

Uma Plataforma de Agente Completa, Não Apenas uma API de Chat

Performance da Plataforma

Recursos Completos da Plataforma de Agentes

Bring Your Own Key (BYOK)

Streaming SSE e Eventos

16 Ferramentas de Agente Auto-Geradas

Multi-Sujeito e Sessões

Pronto para Widgets com Ferramentas de Código IA

Artefatos Binários e Saídas

O Que É a API de Chat Astrológico? Guia Completo para Desenvolvedores

Como Funciona a API de Chat Agêntica?

O Que É BYOK e Por Que Isso Importa?

Por Que Esta É a Única Opção Compatível com OpenAI?