KI-Zusammenfassung

Jede Berechnung liefert Dutzende Deutungstexte. Eine KI-Zusammenfassung macht aus den wichtigsten davon ein paar Sätze darüber, was das Horoskop für diese Person tatsächlich bedeutet — oder, bei Synastrie und Composite, für die beiden Menschen zusammen.

Zusammenfassungen werden nicht während der Berechnung erzeugt. Die Berechnung liefert einen signierten Link, und erst das Öffnen dieses Links startet das Modell.

Erforderliches Modul

Erfordert das Modul ai:summary, enthalten in den Tarifen Premium und Deluxe. Es wird nicht einzeln verkauft.

Zusätzlich benötigen Sie die Deutungstexte des Horoskoptyps, den Sie zusammenfassen (zum Beispiel natal:texts) — ohne Texte gibt es nichts zusammenzufassen.

So funktioniert es

Sie rufen wie gewohnt einen Berechnungs-Endpunkt auf.
Die Antwort enthält ein summary-Objekt mit einer signierten URL.
Sie öffnen diese URL, wenn — und falls — Sie die Zusammenfassung möchten.

In Schritt 1 und 2 wird nichts berechnet, gespeichert oder in Rechnung gestellt. Das ist Absicht: Ein Horoskop-Aufruf soll nicht für eine Funktion zahlen, die die meisten Aufrufer nie verwenden.

Der Zusammenfassungs-Link

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

Feld	Beschreibung
`url`	Signierte URL, die die Zusammenfassung zurückgibt. Sie trägt die gesamte Anfrage, ein Body ist nicht nötig.
`method`	Immer `GET`.
`cost`	API-Requests, die beim Erzeugen der Zusammenfassung berechnet werden. Eine gecachte Zusammenfassung kostet 1.
`expiresAt`	Der Link funktioniert 7 Tage. Führen Sie die Berechnung erneut aus, um einen neuen zu erhalten.

Das summary-Objekt ist nur vorhanden, wenn Ihr Abonnement das Modul enthält. Fehlt es, prüfen Sie Ihren Tarif.

Speichern Sie den Link, nicht nur das Horoskop

Der Link läuft nach 7 Tagen ab und ist für genau ein Horoskop signiert. Er lässt sich nicht bearbeiten: Werden Geburtsdaten, Horoskoptyp oder Organisation in der URL geändert, ist die Signatur ungültig.

Die Zusammenfassung abrufen

bash

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

Dank der Signatur ist der API-Schlüssel optional, sodass der Link auch aus einem Browser oder einem Embed funktioniert, das keine Header setzen kann. Wenn Sie einen Schlüssel mitsenden, muss er zu derselben Organisation gehören, für die der Link ausgestellt wurde.

Das dauert einen Moment

Das Erzeugen einer Zusammenfassung führt die Berechnung erneut aus, holt die Texte und ruft ein Sprachmodell auf. Rechnen Sie mit einigen Sekunden. Eine bereits erzeugte Zusammenfassung kommt sofort zurück.

Antwort

json

{
    "data": {
        "horoscopeType": "natal",
        "language": "de",
        "summary": "Du beginnst bei der Sichtbarkeit, nicht bei der Vorsicht: Die Sonne im Löwen im zehnten Haus stellt deine Arbeit und deinen Ruf in den Mittelpunkt deines Selbstverständnisses…",
        "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°)" }
        ]
    }
}

Feld	Beschreibung
`summary`	Der erzeugte Text, 4 bis 6 Sätze.
`cached`	`true`, wenn der Text aus dem Cache stammt. Gecachte Zusammenfassungen zählen als 1 Request statt 10.
`highlights`	Die Stellungen, auf denen die Zusammenfassung beruht, die stärksten zuerst.
`model`	Das Modell, das den Text geschrieben hat.

Unterstützte Horoskoptypen

Typ	Endpunkt	Worum es in der Zusammenfassung geht
`natal`	`/api/calc/natal/summary`	Wer dieser Mensch ist
`synastry`	`/api/calc/synastry/summary`	Was diese beiden Menschen miteinander machen
`composite`	`/api/calc/composite/summary`	Die Beziehung, die beide zusammen bilden
`transit`	`/api/calc/transit/summary`	Der bevorstehende Zeitraum
`solar`	`/api/calc/solar-return/summary`	Das kommende Jahr
`lunar`	`/api/calc/lunar-return/summary`	Der kommende Monat
`progressions`	`/api/calc/progressions/summary`	Die Lebensphase, in der dieser Mensch steht

Was in die Zusammenfassung einfließt

Ein vollständiges Geburtshoroskop ergibt über 40 Deutungstexte. Alle davon einem Modell zu geben, ergibt eine Aufzählung statt einer Deutung — und kostet weit mehr. Stattdessen werden die Stellungen bewertet, und nur die stärksten überleben:

Stellungen — die Lichter und der Aszendent wiegen am schwersten, danach der Herrscher des Horoskops, die persönlichen Planeten und alles in einem Eckhaus.
Aspekte — bewertet nach Exaktheit (wie eng der Orbis im Verhältnis zum Maximum dieses Aspekts ist), danach wie major der Aspekt ist, und danach wie persönlich die beiden Enden sind. Ein exaktes Sonne–Saturn-Quadrat schlägt ein weites Neptun–Pluto-Sextil deutlich.
Synastrie behält nur die Kreuzaspekte, in beide Richtungen, markiert mit wessen Planet auf wessen Horoskop wirkt.
Transite nehmen zusätzlich die Häuser auf, durch die die transitierenden Planeten laufen.

Die Bewertung ist deterministisch: Dasselbe Horoskop ergibt immer dieselbe Auswahl, und genau das macht das Ergebnis cachefähig.

Das Modell darf ausschließlich die übergebenen Texte verwenden. Es erfindet keine Stellungen, Daten oder Ratschläge — eine Zusammenfassung spiegelt also Ihre eigenen Deutungstexte wider, einschließlich derer, die Sie mit dem Content Editor selbst angepasst haben.

Sprache

Die Zusammenfassung wird in der Sprache der Berechnung geschrieben. Übergeben Sie language in der Berechnungsanfrage; der Link trägt sie mit:

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

Die Deutungstexte sind bereits lokalisiert, und das Modell wird angewiesen, in derselben Sprache zu schreiben.

Was es kostet

Situation	API-Requests
Berechnung mit Zusammenfassungs-Link in der Antwort	1 (unverändert)
Link geöffnet, Zusammenfassung erzeugt	10
Link geöffnet, Zusammenfassung bereits gecacht	1
Anfrage fehlgeschlagen (403, 422, abgelaufener Link)	0

Erzeugte Zusammenfassungen werden 30 Tage lang pro Horoskop, Sprache und Prompt-Version gecacht, sodass wiederholtes Öffnen desselben Links günstig ist.

Die Antwort-Header X-Quota-Limit, X-Quota-Remaining und X-Quota-Reset spiegeln den gewichteten Preis wider, ebenso die Verbrauchsauswertung im Dashboard.

Fehler

Status	Bedeutung
`400`	Der Link ist fehlerhaft oder das Token gehört nicht zu diesem Horoskoptyp.
`401`	Die Signatur ist ungültig oder der Link ist abgelaufen.
`403`	Ihrem Abonnement fehlt `ai:summary` oder die Deutungstexte dieses Typs, oder der Link gehört zu einer anderen Organisation.
`409`	Für dieses Horoskop wird bereits eine Zusammenfassung erzeugt. Versuchen Sie es in einigen Sekunden erneut — so zahlen Sie nicht zweimal für denselben Text.
`422`	Für dieses Horoskop sind keine Deutungstexte verfügbar, es gibt also nichts zusammenzufassen.

Nächste Schritte

Inhalte & Deutungen — die Texte, auf denen eine Zusammenfassung beruht
Module — was Ihr Tarif enthält
Rate Limits — Kontingente und gewichtete Requests

KI-Zusammenfassung ​

So funktioniert es ​

Der Zusammenfassungs-Link ​

Die Zusammenfassung abrufen ​

Antwort ​

Unterstützte Horoskoptypen ​

Was in die Zusammenfassung einfließt ​

Sprache ​

Was es kostet ​

Fehler ​

Nächste Schritte ​