Riepilogo AI

Ogni calcolo restituisce decine di testi interpretativi. Un riepilogo AI trasforma i più significativi in poche frasi su ciò che l'oroscopo significa davvero per quella persona — o, per sinastria e composita, per le due persone insieme.

I riepiloghi non vengono generati durante il calcolo. Il calcolo ti consegna un link firmato, e solo l'apertura di quel link mette in moto il modello.

Modulo richiesto

Richiede il modulo ai:summary, incluso nei piani Premium e Deluxe. Non è venduto separatamente.

Servono anche i testi interpretativi del tipo di oroscopo che stai riepilogando (ad esempio natal:texts) — senza testi non c'è nulla da riepilogare.

Come funziona

Chiami un endpoint di calcolo come al solito.
La risposta contiene un oggetto summary con una URL firmata.
Apri quella URL quando — e se — vuoi il riepilogo.

Nei passaggi 1 e 2 non viene calcolato, memorizzato né addebitato nulla. È voluto: una chiamata di oroscopo non deve pagare per una funzione che la maggior parte dei chiamanti non usa mai.

Il link del riepilogo

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

Campo	Descrizione
`url`	URL firmata che restituisce il riepilogo. Contiene l'intera richiesta, quindi non serve un body.
`method`	Sempre `GET`.
`cost`	Richieste API addebitate quando il riepilogo viene generato. Un riepilogo in cache ne costa 1.
`expiresAt`	Il link funziona per 7 giorni. Riesegui il calcolo per ottenerne uno nuovo.

L'oggetto summary è presente solo se il tuo abbonamento include il modulo. Se manca, controlla il tuo piano.

Conserva il link, non solo il tema

Il link scade dopo 7 giorni ed è firmato per un solo tema. Non è modificabile: cambiare i dati di nascita, il tipo di oroscopo o l'organizzazione nella URL invalida la firma.

Ottenere il riepilogo

bash

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

Grazie alla firma la chiave API è facoltativa, quindi il link funziona anche da un browser o da un embed che non può impostare header. Se invii una chiave, deve appartenere alla stessa organizzazione per cui il link è stato emesso.

Richiede un po' di tempo

Generare un riepilogo riesegue il calcolo, recupera i testi e chiama un modello linguistico. Metti in conto qualche secondo. Un riepilogo già generato torna immediatamente.

Risposta

json

{
    "data": {
        "horoscopeType": "natal",
        "language": "it",
        "summary": "Tu parti dalla visibilità, non dalla prudenza: il Sole in Leone in decima casa mette il lavoro e la reputazione al centro del modo in cui ti comprendi…",
        "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°)" }
        ]
    }
}

Campo	Descrizione
`summary`	Il testo generato, da 4 a 6 frasi.
`cached`	`true` quando arriva dalla cache. I riepiloghi in cache contano come 1 richiesta invece di 10.
`highlights`	Le posizioni da cui è stato scritto il riepilogo, dalle più forti.
`model`	Il modello che ha scritto il testo.

Tipi di oroscopo supportati

Tipo	Endpoint	Di cosa parla il riepilogo
`natal`	`/api/calc/natal/summary`	Chi è questa persona
`synastry`	`/api/calc/synastry/summary`	Cosa si fanno a vicenda queste due persone
`composite`	`/api/calc/composite/summary`	La relazione che formano insieme
`transit`	`/api/calc/transit/summary`	Il periodo che sta arrivando
`solar`	`/api/calc/solar-return/summary`	L'anno che viene
`lunar`	`/api/calc/lunar-return/summary`	Il mese che viene
`progressions`	`/api/calc/progressions/summary`	La fase di vita in cui si trova questa persona

Cosa entra nel riepilogo

Un tema natale completo produce oltre 40 testi interpretativi. Darli tutti a un modello produce un elenco, non una lettura — e costa molto di più. Le posizioni vengono invece valutate con un punteggio e sopravvivono solo le più forti:

Posizioni — i luminari e l'Ascendente pesano di più, poi il governatore del tema, i pianeti personali e tutto ciò che si trova in una casa angolare.
Aspetti — valutati sull'esattezza (quanto è stretta l'orbita rispetto al massimo di quell'aspetto), su quanto l'aspetto sia maggiore e su quanto siano personali le due estremità. Un quadrato Sole–Saturno esatto batte nettamente un sestile largo Nettuno–Plutone.
La sinastria conserva solo gli aspetti incrociati, in entrambe le direzioni, indicando il pianeta di chi agisce sul tema di chi.
I transiti includono inoltre le case attraversate dai pianeti in transito.

Il punteggio è deterministico: lo stesso tema produce sempre la stessa selezione, ed è proprio questo a rendere il risultato memorizzabile in cache.

Il modello può usare solo i testi che riceve. Non inventa posizioni, date o consigli — un riepilogo riflette quindi i tuoi testi interpretativi, compresi quelli che hai modificato con il Content Editor.

Lingua

Il riepilogo viene scritto nella lingua del calcolo. Passa language nella richiesta di calcolo; il link la porta con sé:

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

I testi interpretativi sono già localizzati e il modello riceve l'istruzione di scrivere nella stessa lingua.

Quanto costa

Situazione	Richieste API
Calcolo con un link di riepilogo nella risposta	1 (invariato)
Link aperto, riepilogo generato	10
Link aperto, riepilogo già in cache	1
Richiesta fallita (403, 422, link scaduto)	0

I riepiloghi generati restano in cache 30 giorni per tema, lingua e versione del prompt, quindi riaprire lo stesso link costa poco.

Gli header di risposta X-Quota-Limit, X-Quota-Remaining e X-Quota-Reset riflettono il costo ponderato, così come il consumo riportato nella dashboard.

Errori

Stato	Significato
`400`	Il link è malformato o il token non appartiene a questo tipo di oroscopo.
`401`	La firma non è valida o il link è scaduto.
`403`	Il tuo abbonamento non ha `ai:summary` o i testi interpretativi di questo tipo, oppure il link appartiene a un'altra organizzazione.
`409`	Un riepilogo per questo tema è già in generazione. Riprova tra qualche secondo — così non paghi due volte lo stesso testo.
`422`	Non ci sono testi interpretativi disponibili per questo tema, quindi non c'è nulla da riepilogare.

Prossimi passi

Contenuti e interpretazioni — i testi da cui nasce un riepilogo
Moduli — cosa include il tuo piano
Limiti di frequenza — quote e richieste ponderate

Riepilogo AI ​

Come funziona ​

Il link del riepilogo ​

Ottenere il riepilogo ​

Risposta ​

Tipi di oroscopo supportati ​

Cosa entra nel riepilogo ​

Lingua ​

Quanto costa ​

Errori ​

Prossimi passi ​