Resumo com IA

Cada cálculo devolve dezenas de textos de interpretação. Um resumo com IA transforma os mais significativos em algumas frases sobre o que o horóscopo realmente significa para a pessoa — ou, na sinastria e no mapa composto, para as duas pessoas em conjunto.

Os resumos não são gerados durante o cálculo. O cálculo entrega-te uma ligação assinada, e só ao abrir essa ligação é que o modelo entra em ação.

Módulo necessário

Requer o módulo ai:summary, incluído nos planos Premium e Deluxe. Não é vendido em separado.

Também precisas dos textos de interpretação do tipo de horóscopo que estás a resumir (por exemplo natal:texts) — sem textos não há nada para resumir.

Como funciona

Chamas um endpoint de cálculo como habitualmente.
A resposta contém um objeto summary com um URL assinado.
Abres esse URL quando — e se — quiseres o resumo.

Nos passos 1 e 2 nada é calculado, guardado ou cobrado. É intencional: uma chamada de horóscopo não deve pagar por uma funcionalidade que a maioria dos clientes nunca usa.

A ligação do resumo

json

{
    "data": {
        "points": { "...": "..." },
        "aspects": [],
        "chart": { "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..." },
        "summary": {
            "url": "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3...",
            "method": "GET",
            "cost": 10,
            "expiresAt": "2026-08-30T10:00:00Z"
        }
    }
}

Campo	Descrição
`url`	URL assinado que devolve o resumo. Transporta o pedido inteiro, por isso não é preciso corpo.
`method`	Sempre `GET`.
`cost`	Pedidos à API cobrados quando o resumo é gerado. Um resumo em cache custa 1.
`expiresAt`	A ligação funciona durante 7 dias. Executa o cálculo de novo para obter outra.

O objeto summary só está presente se a tua subscrição incluir o módulo. Se faltar, verifica o teu plano.

Guarda a ligação, não apenas o mapa

A ligação expira ao fim de 7 dias e está assinada para exatamente um mapa. Não é editável: alterar os dados de nascimento, o tipo de horóscopo ou a organização no URL invalida a assinatura.

Obter o resumo

bash

curl "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3..." \
  -H "X-Api-Key: your-api-key"

A assinatura torna a chave de API opcional, pelo que a ligação também funciona a partir de um browser ou de um embed que não consegue enviar cabeçalhos. Se enviares uma chave, tem de pertencer à mesma organização para a qual a ligação foi emitida.

Isto demora algum tempo

Gerar um resumo executa o cálculo de novo, procura os textos e chama um modelo de linguagem. Conta com vários segundos. Um resumo já gerado é devolvido de imediato.

Resposta

json

{
    "data": {
        "horoscopeType": "natal",
        "language": "pt",
        "summary": "Começas pela visibilidade e não pela cautela: o Sol em Leão na casa dez coloca o teu trabalho e a tua reputação no centro da forma como te compreendes…",
        "cached": false,
        "generatedAt": "2026-08-23T10:15:22Z",
        "model": "@cf/qwen/qwen3-30b-a3b-fp8",
        "highlights": [
            { "kind": "point", "label": "Sun in Leo in house 10" },
            { "kind": "point", "label": "Moon in Taurus in house 7" },
            { "kind": "aspect", "label": "Sun square Saturn (orb 0.4°)" }
        ]
    }
}

Campo	Descrição
`summary`	O texto gerado, 4 a 6 frases.
`cached`	`true` quando vem da cache. Resumos em cache contam como 1 pedido em vez de 10.
`highlights`	As posições a partir das quais o resumo foi escrito, das mais fortes para as mais fracas.
`model`	O modelo que escreveu o texto.

Tipos de horóscopo suportados

Tipo	Endpoint	Sobre o que é o resumo
`natal`	`/api/calc/natal/summary`	Quem é esta pessoa
`synastry`	`/api/calc/synastry/summary`	O que estas duas pessoas fazem uma à outra
`composite`	`/api/calc/composite/summary`	A relação que ambas formam em conjunto
`transit`	`/api/calc/transit/summary`	O período que se aproxima
`solar`	`/api/calc/solar-return/summary`	O ano que vem
`lunar`	`/api/calc/lunar-return/summary`	O mês que vem
`progressions`	`/api/calc/progressions/summary`	A fase de vida em que esta pessoa se encontra

O que entra no resumo

Um mapa natal completo produz mais de 40 textos de interpretação. Dá-los todos a um modelo produz uma listagem e não uma leitura — e custa muito mais. Em vez disso, as posições são pontuadas e só as mais fortes sobrevivem:

Posições — os luminares e o Ascendente pesam mais, depois o regente do mapa, os planetas pessoais e tudo o que esteja numa casa angular.
Aspetos — pontuados pela exatidão (quão apertado é o orbe face ao máximo desse aspeto), por quão maior é o aspeto e por quão pessoais são as duas pontas. Uma quadratura exata Sol–Saturno supera largamente um sextil largo Neptuno–Plutão.
A sinastria mantém apenas os aspetos cruzados, nos dois sentidos, indicando o planeta de quem atua sobre o mapa de quem.
Os trânsitos incluem ainda as casas por onde os planetas em trânsito estão a passar.

A pontuação é determinística: o mesmo mapa produz sempre a mesma seleção, e é isso que torna o resultado armazenável em cache.

O modelo só pode usar os textos que lhe são dados. Não inventa posições, datas nem conselhos — por isso um resumo reflete os teus próprios textos de interpretação, incluindo os que editaste com o Content Editor.

Idioma

O resumo é escrito no idioma do cálculo. Passa language no pedido de cálculo; a ligação leva-o consigo:

bash

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": { "longitude": 4.89, "latitude": 52.37, "timezone": "Europe/Amsterdam" },
    "language": "pt",
    "includeText": true
  }'

Os textos de interpretação já estão localizados e o modelo recebe a instrução de escrever no mesmo idioma.

Quanto custa

Situação	Pedidos à API
Cálculo com uma ligação de resumo na resposta	1 (inalterado)
Ligação aberta, resumo gerado	10
Ligação aberta, resumo já em cache	1
O pedido falhou (403, 422, ligação expirada)	0

Os resumos gerados ficam em cache 30 dias por mapa, idioma e versão do prompt, por isso abrir a mesma ligação repetidamente é barato.

Os cabeçalhos de resposta X-Quota-Limit, X-Quota-Remaining e X-Quota-Reset refletem o custo ponderado, tal como o relatório de utilização no painel.

Erros

Estado	Significado
`400`	A ligação está malformada ou o token não pertence a este tipo de horóscopo.
`401`	A assinatura é inválida ou a ligação expirou.
`403`	A tua subscrição não tem `ai:summary` nem os textos de interpretação deste tipo, ou a ligação pertence a outra organização.
`409`	Já está a ser gerado um resumo para este mapa. Tenta de novo daqui a alguns segundos — assim não pagas duas vezes pelo mesmo texto.
`422`	Não há textos de interpretação disponíveis para este mapa, portanto não há nada para resumir.

Passos seguintes

Conteúdo e interpretações — os textos a partir dos quais um resumo é escrito
Módulos — o que o teu plano inclui
Limites de utilização — quotas e pedidos ponderados

Resumo com IA ​

Como funciona ​

A ligação do resumo ​

Obter o resumo ​

Resposta ​

Tipos de horóscopo suportados ​

O que entra no resumo ​

Idioma ​

Quanto custa ​

Erros ​

Passos seguintes ​