Résumé IA

Chaque calcul renvoie des dizaines de textes d'interprétation. Un résumé IA transforme les plus significatifs d'entre eux en quelques phrases sur ce que l'horoscope signifie réellement pour la personne — ou, pour la synastrie et le composite, pour les deux personnes ensemble.

Les résumés ne sont pas générés pendant le calcul. Le calcul vous remet un lien signé, et c'est uniquement l'ouverture de ce lien qui déclenche le modèle.

Module requis

Nécessite le module ai:summary, inclus dans les forfaits Premium et Deluxe. Il n'est pas vendu séparément.

Vous avez également besoin des textes d'interprétation du type d'horoscope que vous résumez (par exemple natal:texts) — sans textes, il n'y a rien à résumer.

Comment ça marche

Vous appelez un endpoint de calcul comme d'habitude.
La réponse contient un objet summary avec une URL signée.
Vous ouvrez cette URL quand — et si — vous voulez le résumé.

Aux étapes 1 et 2, rien n'est calculé, stocké ni facturé. C'est délibéré : un appel d'horoscope ne doit pas payer pour une fonctionnalité que la plupart des appelants n'utilisent jamais.

Le lien de résumé

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

Champ	Description
`url`	URL signée qui renvoie le résumé. Elle contient toute la requête, aucun corps n'est nécessaire.
`method`	Toujours `GET`.
`cost`	Nombre de requêtes API facturées lorsque le résumé est généré. Un résumé mis en cache en coûte 1.
`expiresAt`	Le lien fonctionne pendant 7 jours. Relancez le calcul pour en obtenir un nouveau.

L'objet summary n'est présent que si votre abonnement inclut le module. S'il est absent, vérifiez votre forfait.

Conservez le lien, pas seulement le thème

Le lien expire au bout de 7 jours et il est signé pour un seul thème. Il n'est pas modifiable : changer les données de naissance, le type d'horoscope ou l'organisation dans l'URL invalide la signature.

Obtenir le résumé

bash

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

La signature rend la clé API facultative, si bien que le lien fonctionne aussi depuis un navigateur ou un embed incapable d'envoyer des en-têtes. Si vous envoyez une clé, elle doit appartenir à l'organisation pour laquelle le lien a été émis.

Cela prend un moment

Générer un résumé relance le calcul, récupère les textes et appelle un modèle de langage. Comptez plusieurs secondes. Un résumé déjà généré revient immédiatement.

Réponse

json

{
    "data": {
        "horoscopeType": "natal",
        "language": "fr",
        "summary": "Tu commences par la visibilité plutôt que par la prudence : le Soleil en Lion en maison dix place ton travail et ta réputation au cœur de la façon dont tu te comprends…",
        "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°)" }
        ]
    }
}

Champ	Description
`summary`	Le texte généré, 4 à 6 phrases.
`cached`	`true` lorsque le texte provient du cache. Les résumés en cache comptent pour 1 requête au lieu de 10.
`highlights`	Les placements sur lesquels le résumé s'appuie, les plus forts en premier.
`model`	Le modèle qui a rédigé le texte.

Types d'horoscope pris en charge

Type	Endpoint	Sujet du résumé
`natal`	`/api/calc/natal/summary`	Qui est cette personne
`synastry`	`/api/calc/synastry/summary`	Ce que ces deux personnes se font mutuellement
`composite`	`/api/calc/composite/summary`	La relation qu'elles forment ensemble
`transit`	`/api/calc/transit/summary`	La période à venir
`solar`	`/api/calc/solar-return/summary`	L'année à venir
`lunar`	`/api/calc/lunar-return/summary`	Le mois à venir
`progressions`	`/api/calc/progressions/summary`	La phase de vie dans laquelle se trouve cette personne

Ce qui entre dans le résumé

Un thème natal complet produit plus de 40 textes d'interprétation. Les donner tous à un modèle produit une énumération, pas une lecture — et coûte bien davantage. À la place, les placements sont notés et seuls les plus forts survivent :

Placements — les luminaires et l'Ascendant pèsent le plus lourd, puis le maître du thème, les planètes personnelles et tout ce qui se trouve en maison angulaire.
Aspects — notés sur l'exactitude (l'étroitesse de l'orbe par rapport au maximum de cet aspect), sur le caractère majeur de l'aspect, et sur le caractère personnel des deux extrémités. Un carré Soleil–Saturne exact devance largement un sextile Neptune–Pluton large.
La synastrie ne garde que les aspects croisés, dans les deux sens, en indiquant quelle planète de qui agit sur le thème de qui.
Les transits ajoutent les maisons que traversent les planètes en transit.

La notation est déterministe : le même thème produit toujours la même sélection, et c'est précisément ce qui rend le résultat cacheable.

Le modèle ne peut utiliser que les textes qui lui sont fournis. Il n'invente ni placements, ni dates, ni conseils — un résumé reflète donc vos propres textes d'interprétation, y compris ceux que vous avez modifiés vous-même avec le Content Editor.

Langue

Le résumé est rédigé dans la langue du calcul. Transmettez language dans la requête de calcul ; le lien la conserve :

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": "fr",
    "includeText": true
  }'

Les textes d'interprétation sont déjà localisés, et le modèle reçoit l'instruction d'écrire dans la même langue.

Ce que cela coûte

Situation	Requêtes API
Calcul avec un lien de résumé dans la réponse	1 (inchangé)
Lien ouvert, résumé généré	10
Lien ouvert, résumé déjà en cache	1
Requête échouée (403, 422, lien expiré)	0

Les résumés générés sont mis en cache pendant 30 jours par thème, langue et version de prompt : rouvrir le même lien est donc peu coûteux.

Les en-têtes de réponse X-Quota-Limit, X-Quota-Remaining et X-Quota-Reset reflètent le coût pondéré, tout comme le suivi de consommation dans le tableau de bord.

Erreurs

Statut	Signification
`400`	Le lien est mal formé ou le jeton n'appartient pas à ce type d'horoscope.
`401`	La signature est invalide ou le lien a expiré.
`403`	Votre abonnement n'a pas `ai:summary` ou les textes d'interprétation de ce type, ou le lien appartient à une autre organisation.
`409`	Un résumé pour ce thème est déjà en cours de génération. Réessayez dans quelques secondes — cela vous évite de payer deux fois le même texte.
`422`	Aucun texte d'interprétation n'est disponible pour ce thème, il n'y a donc rien à résumer.

Étapes suivantes

Contenu & interprétations — les textes sur lesquels un résumé s'appuie
Modules — ce que votre forfait inclut
Limites de débit — quotas et requêtes pondérées

Résumé IA ​

Comment ça marche ​

Le lien de résumé ​

Obtenir le résumé ​

Réponse ​

Types d'horoscope pris en charge ​

Ce qui entre dans le résumé ​

Langue ​

Ce que cela coûte ​

Erreurs ​

Étapes suivantes ​