AI Horoscope API

Étant donné un signe du zodiaque et une date optionnelle, le endpoint compose un prompt et le fait passer par notre passerelle LLM vers un modèle de langue, qui écrit un court horoscope quotidien. La réponse contient le texte d'horoscope généré, un avertissement à afficher avec, l'identifiant du modèle qui a produit le texte, et la langue du résultat – localisée via le paramètre language, avec une valeur par défaut sensée si omis. Comme un modèle de langue se trouve dans le chemin, ce endpoint se comporte différemment des routes arithmétiques et éphémérides : il est plus lent, généralement entre une et trois secondes, et le texte est un guidage fraîchement généré plutôt qu'un calcul reproductible, ainsi deux appels avec les mêmes entrées peuvent renvoyer des lectures formulées différemment. Les horoscopes hebdomadaires, mensuels et annuels sont des endpoints frères partageant la même passerelle et forme.

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"
  }
}

Utilise-le quand tu veux un texte d'horoscope prêt à afficher sans écrire ou gérer ton propre pipeline de contenu. Il convient aux surfaces de contenu quotidien : notifications push, résumés email, écrans d'accueil d'app, widgets - où une lecture fraîchement formulée par signe chaque jour est le produit. Affiche toujours l'avertissement renvoyé avec le texte, et demande la langue dont tu as besoin via le paramètre language plutôt que de traduire côté client. Comme le résultat est non déterministe et l'appel implique une latence du modèle, mets en cache chaque lecture signe-date une fois générée au lieu d'appeler à chaque affichage, et prévois la réponse d'une à trois secondes lors de la génération à la demande. Pour des horizons plus longs, passe aux endpoints frères hebdomadaires, mensuels ou annuels.

Ceci est un guidage généré, pas un calcul déterministe - des entrées identiques peuvent produire un texte formulé différemment, et l'avertissement dans la réponse doit être affiché aux utilisateurs finaux. Le champ model indique le modèle que la passerelle a choisi, ce qui peut varier avec le temps. Une latence d'environ une à trois secondes est attendue parce qu'un modèle de langue se trouve dans le chemin de la requête ; les endpoints de calcul répondent beaucoup plus vite.