Resumen con IA

Cada cálculo devuelve decenas de textos de interpretación. Un resumen con IA convierte los más significativos en unas pocas frases sobre lo que el horóscopo significa realmente para esa persona — o, en sinastría y carta compuesta, para las dos personas juntas.

Los resúmenes no se generan durante el cálculo. El cálculo te entrega un enlace firmado, y solo al abrir ese enlace se pone en marcha el modelo.

Módulo requerido

Requiere el módulo ai:summary, incluido en los planes Premium y Deluxe. No se vende por separado.

También necesitas los textos de interpretación del tipo de horóscopo que vas a resumir (por ejemplo natal:texts) — sin textos no hay nada que resumir.

Cómo funciona

Llamas a un endpoint de cálculo como siempre.
La respuesta contiene un objeto summary con una URL firmada.
Abres esa URL cuando — y si — quieres el resumen.

En los pasos 1 y 2 no se calcula, almacena ni cobra nada. Es deliberado: una llamada de horóscopo no debe pagar por una función que la mayoría de los clientes nunca usa.

El enlace del resumen

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	Descripción
`url`	URL firmada que devuelve el resumen. Lleva la petición completa, así que no hace falta cuerpo.
`method`	Siempre `GET`.
`cost`	Peticiones API que se cobran cuando se genera el resumen. Un resumen en caché cuesta 1.
`expiresAt`	El enlace funciona 7 días. Vuelve a ejecutar el cálculo para obtener uno nuevo.

El objeto summary solo aparece si tu suscripción incluye el módulo. Si falta, revisa tu plan.

Guarda el enlace, no solo la carta

El enlace caduca a los 7 días y está firmado para exactamente una carta. No se puede editar: cambiar los datos de nacimiento, el tipo de horóscopo o la organización en la URL invalida la firma.

Obtener el resumen

bash

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

La firma hace que la clave API sea opcional, de modo que el enlace también funciona desde un navegador o un embed que no puede enviar cabeceras. Si envías una clave, debe pertenecer a la misma organización para la que se emitió el enlace.

Esto tarda un poco

Generar un resumen vuelve a ejecutar el cálculo, recupera los textos y llama a un modelo de lenguaje. Cuenta con varios segundos. Un resumen ya generado se devuelve al instante.

Respuesta

json

{
    "data": {
        "horoscopeType": "natal",
        "language": "es",
        "summary": "Tú empiezas por la visibilidad, no por la cautela: el Sol en Leo en la casa diez sitúa tu trabajo y tu reputación en el centro de cómo te entiendes a ti mismo…",
        "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	Descripción
`summary`	El texto generado, de 4 a 6 frases.
`cached`	`true` cuando se sirve desde la caché. Los resúmenes en caché cuentan como 1 petición en lugar de 10.
`highlights`	Las posiciones sobre las que se ha escrito el resumen, las más fuertes primero.
`model`	El modelo que escribió el texto.

Tipos de horóscopo admitidos

Tipo	Endpoint	De qué trata el resumen
`natal`	`/api/calc/natal/summary`	Quién es esta persona
`synastry`	`/api/calc/synastry/summary`	Qué se hacen mutuamente estas dos personas
`composite`	`/api/calc/composite/summary`	La relación que forman juntas
`transit`	`/api/calc/transit/summary`	El periodo que viene
`solar`	`/api/calc/solar-return/summary`	El año que viene
`lunar`	`/api/calc/lunar-return/summary`	El mes que viene
`progressions`	`/api/calc/progressions/summary`	La fase vital en la que está esta persona

Qué entra en el resumen

Una carta natal completa produce más de 40 textos de interpretación. Dárselos todos a un modelo produce un listado, no una lectura — y cuesta mucho más. En su lugar, las posiciones se puntúan y solo sobreviven las más fuertes:

Posiciones — las luminarias y el Ascendente pesan más, después el regente de la carta, los planetas personales y todo lo que esté en casa angular.
Aspectos — puntuados por exactitud (cómo de cerrado es el orbe respecto al máximo de ese aspecto), por lo mayor que sea el aspecto y por lo personales que sean sus dos extremos. Una cuadratura exacta Sol–Saturno supera con creces a un sextil amplio Neptuno–Plutón.
La sinastría conserva solo los aspectos cruzados, en ambos sentidos, indicando el planeta de quién actúa sobre la carta de quién.
Los tránsitos incluyen además las casas por las que están pasando los planetas en tránsito.

La puntuación es determinista: la misma carta produce siempre la misma selección, y eso es justo lo que hace que el resultado se pueda cachear.

El modelo solo puede usar los textos que se le entregan. No inventa posiciones, fechas ni consejos — así que un resumen refleja tus propios textos de interpretación, incluidos los que hayas editado tú mismo con el Content Editor.

Idioma

El resumen se escribe en el idioma del cálculo. Pasa language en la petición de cálculo y el enlace lo conserva:

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

Los textos de interpretación ya están localizados, y el modelo recibe la instrucción de escribir en ese mismo idioma.

Lo que cuesta

Situación	Peticiones API
Cálculo con un enlace de resumen en la respuesta	1 (sin cambios)
Enlace abierto, resumen generado	10
Enlace abierto, resumen ya en caché	1
La petición falló (403, 422, enlace caducado)	0

Los resúmenes generados se cachean 30 días por carta, idioma y versión del prompt, así que abrir el mismo enlace repetidamente es barato.

Las cabeceras de respuesta X-Quota-Limit, X-Quota-Remaining y X-Quota-Reset reflejan el coste ponderado, igual que el informe de consumo del panel.

Errores

Estado	Significado
`400`	El enlace está mal formado o el token no pertenece a este tipo de horóscopo.
`401`	La firma no es válida o el enlace ha caducado.
`403`	Tu suscripción no tiene `ai:summary` o los textos de interpretación de este tipo, o el enlace pertenece a otra organización.
`409`	Ya se está generando un resumen para esta carta. Reinténtalo en unos segundos — así no pagas dos veces por el mismo texto.
`422`	No hay textos de interpretación disponibles para esta carta, así que no hay nada que resumir.

Siguientes pasos

Contenido e interpretaciones — los textos sobre los que se escribe un resumen
Módulos — qué incluye tu plan
Límites de uso — cuotas y peticiones ponderadas

Resumen con IA ​

Cómo funciona ​

El enlace del resumen ​

Obtener el resumen ​

Respuesta ​

Tipos de horóscopo admitidos ​

Qué entra en el resumen ​

Idioma ​

Lo que cuesta ​

Errores ​

Siguientes pasos ​