AI-samenvatting

Elke berekening levert tientallen interpretatieteksten op. Een AI-samenvatting maakt van de belangrijkste daarvan een paar zinnen over wat de horoscoop werkelijk betekent voor die persoon — of, bij synastrie en composiet, voor die twee mensen samen.

Samenvattingen worden niet tijdens de berekening gegenereerd. De berekening geeft u een ondertekende link, en pas het openen van die link zet het model aan het werk.

Vereiste module

Vereist de ai:summary module, inbegrepen in de Premium- en Deluxe-plannen. De module is niet los te koop.

U hebt ook de interpretatieteksten nodig van het horoscooptype dat u samenvat (bijvoorbeeld natal:texts) — zonder teksten valt er niets samen te vatten.

Hoe het werkt

1. U roept een berekeningsendpoint aan zoals gebruikelijk.
2. De response bevat een summary-object met een ondertekende URL.
3. U opent die URL wanneer — en áls — u de samenvatting wilt.

In stap 1 en 2 wordt er niets berekend, opgeslagen of aangerekend. Dat is bewust: een horoscoopaanroep hoort niet te betalen voor een functie die de meeste aanroepers nooit gebruiken.

De samenvattingslink

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

Veld	Beschrijving
url	Ondertekende URL die de samenvatting retourneert. Draagt het hele verzoek, dus een body is niet nodig.
method	Altijd GET.
cost	Aantal API-requests dat wordt aangerekend wanneer de samenvatting wordt gegenereerd. Een gecachte samenvatting kost er 1.
expiresAt	De link werkt 7 dagen. Voer de berekening opnieuw uit voor een nieuwe.

Het summary-object is alleen aanwezig als uw abonnement de module bevat. Ontbreekt het, controleer dan uw plan.

Bewaar de link, niet alleen de horoscoop

De link verloopt na 7 dagen en is ondertekend voor precies één horoscoop. Hij is niet aan te passen: geboortegegevens, horoscooptype of organisatie wijzigen in de URL maakt de handtekening ongeldig.

De samenvatting ophalen

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

Door de handtekening is de API-sleutel optioneel, waardoor de link ook werkt vanuit een browser of een embed die geen headers kan meesturen. Stuurt u wél een sleutel mee, dan moet die bij dezelfde organisatie horen als waaraan de link is uitgegeven.

Dit duurt even

Het genereren van een samenvatting voert de berekening opnieuw uit, haalt de teksten op en roept een taalmodel aan. Reken op enkele seconden. Een eerder gegenereerde samenvatting komt onmiddellijk terug.

Response

{
    "data": {
        "horoscopeType": "natal",
        "language": "nl",
        "summary": "Je begint bij zichtbaarheid, niet bij voorzichtigheid: de Zon in Leeuw in het tiende huis zet je werk en je reputatie centraal in hoe je jezelf begrijpt…",
        "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°)" }
        ]
    }
}

Veld	Beschrijving
summary	De gegenereerde tekst, 4 tot 6 zinnen.
cached	true wanneer de tekst uit de cache komt. Gecachte samenvattingen tellen voor 1 request in plaats van 10.
highlights	De plaatsingen waarop de samenvatting is gebaseerd, sterkste eerst.
model	Het model dat de tekst geschreven heeft.

Ondersteunde horoscooptypes

Type	Endpoint	Waar de samenvatting over gaat
natal	/api/calc/natal/summary	Wie deze persoon is
synastry	/api/calc/synastry/summary	Wat deze twee mensen met elkaar doen
composite	/api/calc/composite/summary	De relatie die zij samen vormen
transit	/api/calc/transit/summary	De periode die eraan komt
solar	/api/calc/solar-return/summary	Het komende jaar
lunar	/api/calc/lunar-return/summary	De komende maand
progressions	/api/calc/progressions/summary	De levensfase waarin deze persoon zit

Wat er in de samenvatting terechtkomt

Een volledige geboortehoroscoop levert 40+ interpretatieteksten op. Die allemaal aan een model voeren geeft een opsomming, geen duiding — en kost veel meer. In plaats daarvan worden de plaatsingen gescoord en overleven alleen de zwaarste:

• Plaatsingen — de lichten en de Ascendant wegen het zwaarst, daarna de heerser van de horoscoop, de persoonlijke planeten en alles in een hoekhuis.
• Aspecten — gescoord op exactheid (hoe strak de orb is ten opzichte van het maximum voor dat aspect), op hoe majeur het aspect is, en op hoe persoonlijk de twee uiteinden zijn. Een exact vierkant Zon–Saturnus verslaat een ruime sextiel Neptunus–Pluto met straatlengtes.
• Synastrie houdt alleen de kruisaspecten over, in beide richtingen, met vermelding van wiens planeet op wiens horoscoop inwerkt.
• Transits nemen daarnaast de huizen mee waar de transiterende planeten doorheen lopen.

De scoring is deterministisch: dezelfde horoscoop levert altijd dezelfde selectie op, en dat is precies wat het resultaat cachebaar maakt.

Het model mag uitsluitend de aangeleverde teksten gebruiken. Het verzint geen plaatsingen, data of adviezen — een samenvatting weerspiegelt dus uw eigen interpretatieteksten, inclusief de teksten die u zelf hebt aangepast met de Content Editor.

Taal

De samenvatting wordt geschreven in de taal van de berekening. Geef language mee bij het berekeningsverzoek; de link draagt die taal mee:

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

De interpretatieteksten zijn al gelokaliseerd, en het model krijgt de instructie in diezelfde taal te schrijven.

Wat het kost

Situatie	API-requests
Berekening met een samenvattingslink in de response	1 (ongewijzigd)
Link geopend, samenvatting gegenereerd	10
Link geopend, samenvatting al gecacht	1
Verzoek mislukt (403, 422, verlopen link)	0

Gegenereerde samenvattingen worden 30 dagen gecacht per horoscoop, taal en promptversie, dus dezelfde link herhaaldelijk openen is goedkoop.

De responseheaders X-Quota-Limit, X-Quota-Remaining en X-Quota-Reset weerspiegelen de gewogen prijs, net als de verbruiksrapportage in het dashboard.

Fouten

Status	Betekenis
400	De link is misvormd of de token hoort niet bij dit horoscooptype.
401	De handtekening is ongeldig of de link is verlopen.
403	Uw abonnement mist ai:summary of de interpretatieteksten van dit type, of de link hoort bij een andere organisatie.
409	Er wordt al een samenvatting voor deze horoscoop gegenereerd. Probeer het over enkele seconden opnieuw — zo betaalt u niet twee keer voor dezelfde tekst.
422	Er zijn geen interpretatieteksten beschikbaar voor deze horoscoop, dus valt er niets samen te vatten.

Volgende stappen

• Content & interpretaties — de teksten waarop een samenvatting gebaseerd is
• Modules — wat uw plan bevat
• Rate limits — quota en gewogen requests