AI 摘要

每次计算都会返回几十段解读文本。AI 摘要把其中最重要的部分，浓缩成几句话，说明这份星盘对当事人究竟意味着什么——合盘与组合盘则是对两个人共同意味着什么。

摘要不会在计算过程中生成。计算会返回一个签名链接，只有打开该链接才会调用模型。

所需模块

需要 ai:summary 模块，包含在 Premium 与 Deluxe 套餐中，不单独出售。

还需要相应星盘类型的解读文本（例如 natal:texts）——没有文本就没有可摘要的内容。

工作方式

你像平常一样调用计算端点。
响应中包含一个带签名 URL 的 summary 对象。
当你需要摘要时——而且只有需要时——才打开该 URL。

第 1、2 步不会进行任何计算、存储或计费。这是有意为之：普通的星盘调用不该为大多数调用方从不使用的功能买单。

摘要链接

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

字段	说明
`url`	返回摘要的签名 URL。它携带完整请求，因此不需要请求体。
`method`	始终为 `GET`。
`cost`	生成摘要时计费的 API 请求数。命中缓存的摘要计 1 次。
`expiresAt`	链接有效期 7 天。需要新链接请重新执行计算。

只有订阅包含该模块时，响应中才会出现 summary 对象。若缺失，请检查你的套餐。

请保存链接，而不只是星盘

链接 7 天后失效，并且只对一份星盘签名。它不可编辑：修改 URL 中的出生数据、星盘类型或组织都会使签名失效。

获取摘要

bash

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

由于带有签名，API 密钥是可选的，因此该链接也可在浏览器或无法设置请求头的嵌入组件中使用。若你确实发送了密钥，它必须属于签发该链接的同一组织。

这需要一点时间

生成摘要会重新执行计算、拉取文本并调用语言模型，通常需要数秒。此前已生成过的摘要会立即返回。

响应

json

{
    "data": {
        "horoscopeType": "natal",
        "language": "zh",
        "summary": "你的起点是被看见，而不是谨慎：第十宫的狮子座太阳，把工作与声誉放在你理解自己的核心位置……",
        "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°)" }
        ]
    }
}

字段	说明
`summary`	生成的文本，4 到 6 句。
`cached`	命中缓存时为 `true`。缓存摘要按 1 次请求计，而不是 10 次。
`highlights`	摘要所依据的星体落点，按重要性排序。
`model`	撰写文本的模型。

支持的星盘类型

类型	端点	摘要内容
`natal`	`/api/calc/natal/summary`	这个人是怎样的人
`synastry`	`/api/calc/synastry/summary`	两个人彼此产生的作用
`composite`	`/api/calc/composite/summary`	两人共同构成的关系
`transit`	`/api/calc/transit/summary`	即将到来的时期
`solar`	`/api/calc/solar-return/summary`	未来一年
`lunar`	`/api/calc/lunar-return/summary`	未来一个月
`progressions`	`/api/calc/progressions/summary`	此人当前所处的人生阶段

摘要的取材

一张完整的本命盘会产生 40 多段解读文本。把它们全部交给模型只会得到一份清单，而不是解读，而且成本高得多。因此系统会对落点评分，只保留最强的部分：

落点——日月与上升最重，其次是命主星、个人行星，以及任何落在角宫的星体。
相位——按精确度（容许度相对该相位上限有多紧）、相位是否为主要相位，以及两端有多贴近个人来评分。一个精确的日—土刑相，远远优先于一个宽松的海—冥六分相。
合盘只保留双向的交互相位，并标明是谁的行星作用于谁的星盘。
行运还会纳入行运行星正在经过的宫位。

评分是确定性的：同一张星盘始终产生同样的选择，这正是结果可缓存的前提。

模型只能使用提供给它的文本，不会杜撰落点、日期或建议——因此摘要反映的是你自己的解读文本，包括你在 Content Editor 中亲自修改过的内容。

语言

摘要使用与计算相同的语言。在计算请求中传入 language，链接会一并携带：

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

解读文本已经本地化，模型也会被要求使用同一语言撰写。

费用

情形	API 请求数
响应中带摘要链接的计算	1（不变）
打开链接并生成摘要	10
打开链接，摘要已缓存	1
请求失败（403、422、链接过期）	0

生成的摘要按星盘、语言与提示词版本缓存 30 天，因此反复打开同一链接非常便宜。

响应头 X-Quota-Limit、X-Quota-Remaining 和 X-Quota-Reset 反映加权后的费用，控制台的用量统计同样如此。

错误

状态码	含义
`400`	链接格式错误，或令牌不属于该星盘类型。
`401`	签名无效或链接已过期。
`403`	订阅缺少 `ai:summary` 或该类型的解读文本，或链接属于其他组织。
`409`	该星盘的摘要正在生成中。请几秒后重试——这可以避免为同一段文本付费两次。
`422`	该星盘没有可用的解读文本，因此无法摘要。

下一步

内容与解读 —— 摘要所依据的文本
模块 —— 你的套餐包含哪些内容
速率限制 —— 配额与加权请求

AI 摘要 ​

工作方式 ​

摘要链接 ​

获取摘要 ​

响应 ​

支持的星盘类型 ​

摘要的取材 ​

语言 ​

费用 ​

错误 ​

下一步 ​