API de horóscopo com AI

Dado um signo do zodíaco e uma data opcional, o endpoint compõe um prompt e encaminha-o através do nosso gateway de LLM para um modelo de linguagem, que escreve um curto horóscopo diário. A resposta carrega o texto do horóscopo gerado, um aviso legal para apresentar junto dele, o identificador do modelo que produziu o texto e o idioma da saída — localizado através do parâmetro de idioma, com um valor predefinido sensato quando omitido. Como há um modelo de linguagem no caminho, este endpoint comporta-se de forma diferente das rotas aritméticas e de efeméride: é mais lento, tipicamente de um a três segundos, e o texto é orientação gerada de novo em vez de um cálculo reproduzível, pelo que duas chamadas com entradas idênticas podem devolver leituras com redação diferente. Horóscopos semanais, mensais e anuais são endpoints irmãos que partilham o mesmo gateway e a mesma forma.

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sign": "taurus",
  "date": "2026-06-15",
  "language": "en"
}'

{
  "ok": true,
  "data": {
    "horoscope": "Today favours steady progress…",
    "disclaimer": "For entertainment purposes…",
    "model": "gemini-2.5-flash",
    "language": "en"
  }
}

Recorra a isto quando quiser texto de horóscopo pronto a exibir sem escrever ou manter o seu próprio pipeline de conteúdos. Adequa-se a superfícies de conteúdo diário — notificações push, resumos por e-mail, ecrãs iniciais de aplicações, widgets — onde uma leitura redigida de novo por signo e por dia é o produto. Renderize sempre o aviso legal devolvido com o texto, e solicite o idioma de que precisa através do parâmetro de idioma em vez de traduzir do lado do cliente. Como a saída é não determinística e a chamada acarreta a latência do modelo, mantenha em cache cada leitura por signo e data assim que gerada em vez de chamar a cada visualização de página, e preveja a resposta de um a três segundos ao gerar a pedido. Para horizontes mais longos, mude para os endpoints irmãos semanal, mensal ou anual.

Isto é orientação gerada, não um cálculo determinístico — entradas idênticas podem produzir texto com redação diferente, e o aviso legal na resposta está lá para ser mostrado aos utilizadores finais. O campo do modelo nomeia o modelo que o gateway selecionou, que pode variar ao longo do tempo. É esperada uma latência de cerca de um a três segundos porque há um modelo de linguagem no caminho do pedido; os endpoints de cálculo respondem muito mais depressa.