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.

40 ferramentas server-side, escolha de modelo BYOK, streaming SSE com retry automático, sessões multi-sujeito. Uma chamada de API, loop de agente completo.

Ver Documentação da API

Presets de Contexto LLM

Idiomas do Prompt

60%

Redução de Tokens

Ferramentas de Agente

Drop-In para OpenAI SDK

Traga Sua Própria Chave

Loop de Agente Server-Side

Veja o Agente em Ação

Conversas reais alimentadas por orquestração de ferramentas no 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: "pt", tradition: "psychological" }
  }
} as any);

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

Funciona com qualquer uma das nossas 40 ferramentas ou combinações

Jyotish Védico

Perguntas Horárias

Human Design

Astrocartografia

Numerologia

Leitura de Tarô

Sinastria de Relacionamento

Previsão de Trânsito

Qualquer combinação de endpoints em uma sessão — natal, védico, horária, BaZi, astrocartografia e mais.Hosted: 25 + créditos de endpoint/turno · BYOK: 2 + créditos de endpoint + custos de LLM

Um dump completo do JSON natal consome 1.500-3.000 tokens por mapa — a janela de contexto enche rápido
Nomes de campos crípticos como 'Mars 0d 90.0 Saturn' confundem o modelo e produzem leituras erradas
Dados de trânsito e natal misturados sem prefixos — o LLM inventa qual planeta é qual
Preso em modelos de chat proprietários, sem opção BYOK ou controle de custo
Contexto de prompt só em inglês bloqueia rollouts de chatbots multilíngues
Construir do zero seu próprio loop de ferramentas, formatador de prompt e gerenciador de sessão

Transforme com

Formatador to_prompt_text(): 3 presets (minimal 150-250, full 500-800, traditional 600-900 tokens) — ~60% de redução vs JSON bruto
Aspectos em linguagem natural: 'Mars square Saturn within 2°' em vez de códigos crípticos
Prefixos t. / n. desambiguam trânsito vs natal (ex.: 't.Jupiter trine n.Venus') — sem mais planetas alucinados
i18n em 7 idiomas (~40 strings) cobre EN, DE, ES, FR, IT, PT, RU para deploy global de chatbot
BYOK: GPT-5, Claude 4, Gemini 3, Grok ou qualquer um dos 50+ modelos do OpenRouter
Loop de agente server-side com 40 ferramentas, retry automático em falhas upstream, sessões multi-sujeito e artefatos binários

Performance da Plataforma

Contexto otimizado em tokens, ferramentas prontas para agentes, cálculos rápidos

Presets de Contexto LLM

Idiomas do Prompt

~60%

Redução de Tokens vs JSON

~40

Strings i18n no Formatador

Ferramentas de Agente

<300ms

Velocidade de Cálculo

Idiomas de Interpretação

50+

Modelos LLM

Funcionalidades Completas da Plataforma de Agente

Tudo que você precisa para criar experiências de astrologia com IA

Formatador de Contexto LLM to_prompt_text()

Bring Your Own Key (BYOK)

Streaming SSE & Eventos

40 Ferramentas Astrológicas Nativas

Retry Automático & Confiabilidade

Multi-Sujeito & Sessões

Widget-Ready para Ferramentas de Codificação com IA

Artefatos Binários & Saída

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

Tudo que você precisa para criar experiências de astrologia com IA

E se você pudesse adicionar um agente astrológico de IA totalmente funcional ao seu app com uma única chamada de API? É exatamente isso que a API de Chat Astrológico faz. Não é só um endpoint de chatbot — é uma plataforma agêntica completa que executa todo o loop de chamadas de ferramentas no servidor. Você envia uma mensagem, opta pelas ferramentas que quer usar via astrology.enabled_tools, e o servidor chama até 40 ferramentas astrológicas — mapas natais, trânsitos, sinastria, relatórios completos de análise, até geração de relatórios em PDF — resolvendo dados do mapa natal a partir de IDs de sujeito (sem datas alucinadas) e retornando uma resposta coerente, tudo via um endpoint /chat/completions compatível com OpenAI. Isso significa que você usa o SDK OpenAI padrão em TypeScript, Python, Go ou qualquer linguagem. Sem código de integração customizado. Sem construir seu próprio framework de agente. Sem gerenciar schemas de ferramentas. O servidor também classifica e refaz automaticamente falhas transitórias do modelo upstream, então um provedor instável aparece como um erro limpo em vez de uma resposta travada ou corrompida. Soluções concorrentes de chat astrológico cobram US$0,25-US$0,87 por consulta, levam 8-24 segundos para responder, prendem você em modelos proprietários e usam formatos JSON customizados que exigem código de integração específico. Somos a única plataforma que entrega um agente pronto com suporte BYOK — escolha seu próprio LLM entre 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 em profundidade.

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ânsito, relatório de sinastria, etc.).

4) O servidor executa essas ferramentas internamente contra nossos 82 endpoints astrológicos — nenhuma chamada extra do seu lado.

5) Os resultados das ferramentas voltam para o LLM sintetizar.

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

Todo o loop de ferramentas roda no servidor em uma única requisição.

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

Com streaming ativado (SSE), você ainda recebe eventos de extensão em tempo real como tool_start e tool_end, então sua UI pode mostrar 'Calculando mapa de trânsito...' enquanto o agente trabalha.

Loop de agente completo roda no servidor em uma única chamada de API

1 min read

O Que É BYOK e Por Que Importa?

BYOK — Bring Your Own Key — significa que você escolhe qual LLM alimenta seu agente astrológico.

Todas as outras soluções de chat astrológico do mercado prendem você em um único modelo proprietário sem alternativas — algumas nem revelam qual modelo usam.

Com nosso endpoint BYOK (/chat/completions/byok), você passa sua própria API key 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 custo — GPT-5-nano é 10x mais barato que GPT-5-pro.

Ajuste de qualidade — Claude se destaca em interpretação refinada, Gemini é mais rápido para perguntas 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 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 OpenAI padrão — a mesma biblioteca cliente que milhões de desenvolvedores já conhecem.

Sem SDK novo para aprender, sem cliente HTTP customizado 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 da 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 existentes usam endpoints customizados com formatos proprietários de request/response, exigindo código de integração específico para cada plataforma que você suporta.

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

1 min read

Perfeito para Vibe Coding — Crie Widgets Astrológicos em Minutos

Como nossa API usa o protocolo padrão OpenAI, toda ferramenta de codificação com IA já sabe trabalhar com ela.

Diga ao Lovable 'Crie um widget de chat astrológico usando esta API' e ele gera um componente React funcional — UI com streaming, formulário de dados de nascimento, balões de chat, tudo.

Claude Code e Cursor montam uma integração completa em um único prompt porque entendem o SDK OpenAI nativamente.

Sem adapters customizados, sem documentação obscura, sem debugar formatos JSON proprietários.

O mesmo vale para Windsurf, Bolt, Replit Agent e qualquer ferramenta de IA que saiba escrever código contra a API da OpenAI.

É isso que torna nossa plataforma única para vibe coding: você descreve o widget que quer, a IA constrói e funciona de primeira — porque a API por baixo usa o mesmo protocolo que essas ferramentas foram treinadas.

Vibe coders estão lançando apps de astrologia em horas, não semanas.

Widgets de chat, verificadores de compatibilidade, geradores de horóscopo diário, intérpretes de mapa natal — todos construídos descrevendo o que você quer para um assistente de IA.

Copie este prompt em qualquer ferramenta de codificação com IA para começar agora:

Lovable, Claude Code, Cursor, Windsurf — qualquer ferramenta de codificação com IA cria integrações funcionais na hora

1 min read

O Que as 40 Ferramentas do Agente Fazem?

A plataforma expõe 40 ferramentas que o LLM pode invocar durante a conversa, opt-in por requisição via astrology.enabled_tools — nada roda a menos que você liste.

Cálculos de Mapa (10 ferramentas) — natal, trânsito, sinastria, composto, davison, dracônico, harmônico, heliocêntrico, espaço local e antiscia, com posições planetárias e aspectos completos.

Renderização de Mapas (11 ferramentas) — o mesmo conjunto de mapas como imagens SVG, PNG, JPG, WebP ou PDF, armazenadas como artefatos binários com URLs compartilháveis.

Relatórios de Análise (4 ferramentas) — relatórios natais completos, análise lunar, relatórios de sinastria e relatórios de relocação com interpretações multi-seção.

Geração de Relatórios PDF (10 ferramentas) — o agente pode disparar um PDF premium no meio da conversa: mapa arquetípico, composto, retorno lunar, roadmap multi-anual, natal, relocação, retorno de Saturno, retorno solar, sinastria ou relatório de Kundli Védico.

Consultas de Dados (3 ferramentas) — posições planetárias atuais, matriz de aspectos e o horário astrológico atual.

Horóscopo (1 ferramenta) — horóscopo diário personalizado.

Retificação (1 ferramenta) — busca de horário de nascimento.

Como os nomes das ferramentas mapeiam direto para os caminhos dos endpoints (/charts/natal vira charts_natal, não natal_chart), um nome digitado errado simplesmente é descartado — passe os nomes exatos e sempre anexe sujeitos com birth_data, já que as ferramentas resolvem sujeitos por ID em vez de ler dados de nascimento da própria chamada.

40 ferramentas, opt-in por requisição — o modelo pode puxar um mapa real ou gerar um relatório PDF no meio da conversa

2 min read

Quão Confiável É a API de Chat? Retry Automático e Cache de Prompt

Uma correção de confiabilidade já em produção agora classifica falhas transitórias do modelo upstream e as refaz automaticamente, antes que cheguem ao seu app.

Antes, uma resposta upstream instável podia travar a conexão ou retornar uma resposta parcial corrompida; agora, uma falha que não pode ser recuperada aparece como um 502 limpo (não-streaming) ou um chunk terminal de stream (SSE) — seu tratamento de erros recebe um sinal previsível em vez de uma travada silenciosa.

Isso significa consideravelmente menos sessões de chat quebradas para quem constrói sobre esse endpoint.

Uma correção complementar mudou como o system prompt é montado: agora ele é dividido em um preâmbulo sempre ativo mais um bloco de regras de uso de ferramentas que só carrega quando ferramentas são de fato resolvidas para aquela requisição.

Isso corrigiu uma classe de falhas de completion vazia que aparecia desproporcionalmente em tiers de modelo mais leves e rápidos, e significa que o comportamento do prompt-cache agora acompanha o conjunto de ferramentas que você realmente habilitou, em vez de um prompt estático fixo — custos mais baratos e previsíveis para quem faz muitas chamadas variando enabled_tools entre requisições.

Retry automático em falhas upstream transitórias, mais cache que acompanha as ferramentas que você realmente habilita

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 vários mapas natais em uma única conversa — por exemplo, 'eu' e 'parceiro'.

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

Isso permite análise de sinastria, comparações de mapas compostos e dinâmicas familiares — tudo em uma única sessão de chat, sem reenviar dados de nascimento.

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

Artefatos binários permitem que o chat gere arquivos para download.

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

Peça 'Crie um relatório PDF' e ganhe um documento profissional de várias 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 da conversa, sujeitos e contexto — memória multi-turno real, sem gerenciamento de estado no cliente.

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

1 min read

Como to_prompt_text() Corta Custos de Tokens LLM em ~60%

A maioria dos devs ancora seus chatbots LLM jogando o JSON completo do mapa no prompt.

Um mapa natal em JSON ocupa 1.500-3.000 tokens — isso é US$0,015-US$0,030 por requisição em modelos da classe GPT-4, e a janela de contexto enche depois de alguns turnos.

Pior: o modelo frequentemente lê errado códigos crípticos como 'Mars 0d 90.0 Saturn' e produz interpretações incorretas.

Nosso formatador to_prompt_text() resolve os dois problemas.

Ele converte dados do mapa em markdown compacto e legível com aspectos em linguagem natural.

Três presets deixam você escolher o orçamento certo de tokens: 'minimal' (~150-250 tokens) cobre sol/lua/asc, aspectos-chave, trânsitos atuais — ótimo para respostas de chat.

'full' (~500-800 tokens) adiciona dignidades, casas, modalidades e seita para interpretações mais ricas.

'traditional' (~600-900 tokens) inclui profundidade helenística e medieval — partes, almuten, hayz, antiscia — para leituras em estilo clássico.

Cole o markdown formatado em qualquer prompt LLM (Claude, GPT, Gemini, Grok) para ancorar o modelo em dados reais do mapa sem despejar JSON.

Economia média de tokens: ~60% vs dump bruto de JSON, com menos alucinações mensuráveis.

3 presets, 150-900 tokens, ~60% mais barato que dumps de JSON

1 min read

Aspectos em Linguagem Natural e Prefixos t./n.

LLMs leem linguagem natural melhor que códigos de campo — então to_prompt_text() retorna aspectos da forma como um astrólogo escreveria.

Em vez de 'Mars 0d 90.0 Saturn' você recebe 'Mars square Saturn within 2°'.

O orbe continua preciso, mas o modelo lê na primeira passada.

Quando o formatador inclui dados de trânsito junto do mapa natal, cada planeta é marcado com um prefixo: 't.' para trânsito, 'n.' para natal.

Então uma leitura de trânsito mostra 't.Jupiter trine n.Venus within 1°' — o modelo nunca precisa adivinhar qual planeta pertence a qual mapa.

Essa única mudança elimina a fonte mais comum de leituras alucinadas em chatbots astrológicos: confusão de identidade planetária entre mapas.

Combinado com a i18n em 7 idiomas (EN, DE, ES, FR, IT, PT, RU — ~40 strings cobrindo aspectos, seita, dignidades, casas, modalidades), você lança um chatbot multilíngue que ancora Claude ou GPT em contexto de mapa localizado sem traduzir nada no cliente.

Aspectos em linguagem natural + prefixos trânsito/natal eliminam leituras alucinadas

1 min read

Performance e Preço vs Concorrentes

Vamos aos números.

As soluções concorrentes mais rápidas de chat astrológico levam 8-12 segundos por resposta.

Planos de nível padrão no mercado têm média de 19-24 segundos.

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

Isso é 4-10x mais rápido.

No preço, alternativas cobram US$0,25-US$0,87 por consulta de IA — além das taxas de assinatura mensais.

Nosso preço tem três componentes: (1) créditos de plataforma por turno — 25 hosted ou 2 BYOK, (2) créditos de endpoint para cada ferramenta que o agente chama (ex.: mapa natal = 1 crédito, astrocartografia = 5 créditos, relatório PDF = 35 créditos) e (3) seus próprios custos de LLM se usar BYOK.

Exemplo: um turno de interpretação natal custa 25 + 1 = 26 créditos hosted (~US$0,02), ou 2 + 1 = 3 créditos BYOK (~US$0,002) mais ~US$0,003 de custo LLM.

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

Incluímos o 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

1 min read

Use Cases

Apps Móveis de Astrologia

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

Plataformas de Namoro & Compatibilidade

Sessões multi-sujeito permitem 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. Use BYOK com um modelo econômico (GPT-5-nano) e processe em batch 2.800+ usuários para email diário ou push de notificações.

Plataformas de Bem-Estar & Saúde Mental

Integre insights astrológicos em apps de mindfulness, ferramentas de terapia e plataformas de autorreflexão. O modo de tradição psicológica oferece interpretações no estilo junguiano focadas em crescimento e autoconhecimento.

Plataformas SaaS de Astrologia

Faça white-label do agente inteiro como seu próprio produto. System prompts customizados definem a personalidade, BYOK controla custos e a persistência de sessão habilita consultas multi-turno para assinantes pagantes.

Frameworks de Agentes IA

Conecte direto no 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 adapters customizados.

Vibe Coding com Ferramentas de IA

Peça ao Lovable, Claude Code, Cursor ou Windsurf para criar um widget de astrologia — e tenha um app funcional em minutos. Como nossa API segue o protocolo OpenAI, ferramentas de codificação com IA geram integrações corretas de primeira. Widgets de chat, geradores de horóscopo, verificadores de compatibilidade — descreva e publique.

Technical Specifications

Protocolo da API	OpenAI Chat Completions (v1)
Endpoints	/chat/completions (hosted) + /chat/completions/byok
Formatador de Contexto LLM	to_prompt_text() com 3 presets
Valores de Preset	minimal \| full \| traditional
Faixa de Tokens por Preset	minimal 150-250 · full 500-800 · traditional 600-900
Formato de Aspecto	'Mars square Saturn within 2°' (linguagem natural)
Prefixos Trânsito/Natal	t.Jupiter trine n.Venus
Idiomas do Formatador de Prompt	7 (en, de, es, fr, it, pt, ru)
Strings i18n no Formatador	~40 em 7 idiomas
Ferramentas de Agente	40, opt-in por requisição via astrology.enabled_tools
Tratamento de Falhas Upstream	Classificação e retry automáticos, 502 limpo ou chunk final de stream em caso de falha
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 Hosted	astro-default (otimizado para astrologia)
Persistência de Sessão	Backed por Redis, TTL deslizante de 24h
Multi-Sujeito	Sujeitos ilimitados por sessão
Artefatos Binários	SVG, PNG, JPG, WebP, PDF via chat
Idiomas de Interpretação	9 (en, de, fr, es, it, pt, ru, zh, hi)
Tradições	Clássica, Psicológica, Orientada a Eventos, Universal
Autenticação	Bearer token (API key)
Rate Limiting	Por API key, configurável

API de Chat Astrológico vs Abordagem DIY de Dump de JSON

Feature	Astrology API	Others
Tokens de Prompt LLM (por mapa)	150-900 (depende do preset)	1.500-3.000 (JSON bruto)
Custo de Tokens por Prompt	~60% menor que dump de JSON	Gasto total de tokens a cada turno
Legibilidade de Aspectos	'Mars square Saturn within 2°'	'Mars 0d 90.0 Saturn' (críptico)
Desambiguação Trânsito/Natal	Prefixos t. / n. embutidos	Modelo adivinha (alucinações)
Contexto de Prompt Multilíngue	7 idiomas (~40 strings i18n)	Só inglês ou traduza você mesmo
Taxa de Alucinação	Baixa — linguagem natural ancorada	Alta — códigos crípticos confundem LLMs
Compatível com SDK OpenAI	Sim (drop-in)	Não (APIs customizadas)
Escolha de Modelo BYOK	50+ modelos (3 provedores)	Modelo proprietário travado
Loop de Agente Server-Side	40 ferramentas, opt-in por requisição	Você mesmo constrói
Tratamento de Falhas Upstream	Retry automático + sinal de erro limpo	Travadas silenciosas ou saída corrompida
Sessões Multi-Sujeito	Sujeitos ilimitados	Um único mapa natal
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	US$0,001-US$0,02	US$0,25-US$0,87
Tier Gratuito	50 requisições/mês	Nenhum ou sandbox pago
Ferramentas de Codificação com IA (Vibe Coding)	Funciona na hora (protocolo OpenAI)	Formatos customizados, só codificação manual

APIs de Astrologia Relacionadas

API de Mapa Natal

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

API de Trânsito

Trânsitos planetários atuais — combina com to_prompt_text() para contexto de chatbot

API de Astrologia Tradicional

Técnicas helenísticas e medievais — combina com a profundidade do preset 'traditional'

API de Timing

Timing eletivo e de eventos — encaixe em prompts de chat para perguntas de previsão

API de Horária

Endpoint de horária com IA — combina naturalmente com o agente de chat para leituras por pergunta

API de Sinastria

Análise de compatibilidade entre dois mapas

API de Relatório PDF

Gere relatórios PDF astrológicos profissionais de múltiplas 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 codificação com 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

Quais ferramentas a IA pode chamar?

Technical

O que acontece se o modelo de IA falhar no meio da resposta?

Pricing

O uso de ferramentas afeta o cache de resposta ou o custo?

Construa Sua Stack Astrológica Completa

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

Lance Chatbots Astrológicos

Agente compatível com OpenAI, 40 ferramentas, BYOK, retry automático em falhas upstream e contexto to_prompt_text() em 7 idiomas. Corte custos de tokens LLM em ~60% vs despejar JSON bruto.

Comece Grátis Ver Documentação da API

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

Compatível com SDK OpenAI

Sem taxas de setup

Mais que Chat. Crie Agentes de IA Astrológicos

Veja o Agente em Ação

Jogar JSON Bruto no Prompt do LLM Desperdiça Tokens e Gera Alucinações

Contexto LLM Otimizado em Tokens + Plataforma Completa de Agente em Uma API

Performance da Plataforma

Funcionalidades Completas da Plataforma de Agente

Formatador de Contexto LLM to_prompt_text()

Bring Your Own Key (BYOK)

Streaming SSE & Eventos

40 Ferramentas Astrológicas Nativas

Retry Automático & Confiabilidade

Multi-Sujeito & Sessões

Widget-Ready para Ferramentas de Codificação com IA

Artefatos Binários & Saída

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 Importa?

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

Perfeito para Vibe Coding — Crie Widgets Astrológicos em Minutos

O Que as 40 Ferramentas do Agente Fazem?

Quão Confiável É a API de Chat? Retry Automático e Cache de Prompt

Como Funcionam Sessões Multi-Sujeito e Artefatos?

Como to_prompt_text() Corta Custos de Tokens LLM em ~60%

Aspectos em Linguagem Natural e Prefixos t./n.

Performance e Preço vs Concorrentes

Use Cases

Apps Móveis de Astrologia

Plataformas de Namoro & Compatibilidade

Pipelines de Geração de Conteúdo

Plataformas de Bem-Estar & Saúde Mental

Plataformas SaaS de Astrologia

Frameworks de Agentes IA

Vibe Coding com Ferramentas de IA

Technical Specifications

API de Chat Astrológico vs Abordagem DIY de Dump de JSON

APIs de Astrologia Relacionadas

API de Mapa Natal

API de Trânsito

API de Astrologia Tradicional

API de Timing

API de Horária

API de Sinastria

API de Relatório PDF

Documentação da API

References & Standards

Precos Simples e Transparentes

Sempre Gratis

Pro

Pro Plus

Ultra

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 OpenAI Python ou TypeScript 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 SVG de mapas?

Quão rápida é a API de Chat Astrológico em comparação com alternativas?

Quais são os eventos de extensão do streaming SSE?

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

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

Isso é só um wrapper do GPT ou usa dados astronômicos reais?

Como controlo o estilo e o tamanho da resposta?

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

Posso fazer white-label disso como meu próprio produto?

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

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

Como a API de Chat Astrológico se compara a construir a minha com RoxyAPI ou endpoints de dados crus?

O que é to_prompt_text() e por que devs de chatbot deveriam se importar?

Qual preset devo usar — minimal, full ou traditional?

Quanto o formatador de prompt reduz os custos de tokens do LLM?

Quais idiomas o to_prompt_text() suporta?

Como os aspectos são formatados em linguagem natural?

O que significam os prefixos t. e n. na saída formatada?

A API de chat consegue puxar meu mapa natal real durante uma conversa?

Quais ferramentas a IA pode chamar?

O que acontece se o modelo de IA falhar no meio da resposta?

O uso de ferramentas afeta o cache de resposta ou o custo?