返回中文文档
精气神生命曲线 API

《内经》精气神生命曲线 API

结合《黄帝内经》年龄周期、八字大运与流年修正，生成 0 至 max_age 的精、气、神年度轨迹。

POST /api/v1/chinese/bazi/lifespan

中文响应与兼容性约定

使用 lang: "zh-CN"（POST 请求体）或?lang=zh-CN（GET 查询参数）请求简体中文响应。zh-Hans、zh 和zh_hans 也会归一化为同一书写语言。

面向用户的名称、说明、星期、五行、生肖、十神和错误消息会本地化。为避免破坏现有客户端， JSON 字段名、对象映射键、稳定 ID、错误代码、枚举值、模式值、ISO 时间戳、时区、库名、版本号和拼音保持不变。 客户端应依据字段名与稳定代码处理逻辑，不要依据翻译后的显示文本建立判断。

例如 ten_god_distribution 内的Direct Wealth 等映射键属于兼容性标识，仍使用英文；页面标题、说明、描述和独立显示值会返回中文。

请求参数

字段
year / month / day
类型
integer
必填
是
说明
出生日期。
字段
hour / minute
类型
integer
必填
否
说明
出生时间。
字段
lat / lng
类型
float
必填
否
说明
出生地坐标；也可提供 city。
字段
sex
类型
string
必填
否
说明
M 或 F。
字段
max_age
类型
integer
必填
否
说明
曲线终止年龄，默认 120。
字段
cultivation_factor
类型
float
必填
否
说明
修习与调养系数，范围 0.0–1.0，默认 0.5。
字段
lang
类型
string
必填
否
说明
设置 zh-CN 返回简体中文。

请求示例

为便于完整展示响应，示例把 max_age 设为 2；生产请求可按需要设置为 0–200，默认 120。

curl -X POST "https://api.freeastroapi.com/api/v1/chinese/bazi/lifespan" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "year": 1990,
    "month": 5,
    "day": 17,
    "hour": 14,
    "minute": 30,
    "lat": 31.2304,
    "lng": 121.4737,
    "sex": "M",
    "max_age": 2,
    "cultivation_factor": 0.5,
    "lang": "zh-CN"
  }'

响应示例

{
  "metadata": {
    "max_age": 2,
    "sex": "男性",
    "cultivation_level": 0.5,
    "algorithm": "内经—八字混合模型 v1.1（内功调节）"
  },
  "curve": [
    {
      "age": 0,
      "year": 1990,
      "j0": 58.9,
      "j_final": 63.0,
      "jing_prenatal": 58.9,
      "jing_postnatal": 4.1,
      "qi": 28.0,
      "qi_pre_heaven": 29.5,
      "qi_post_heaven": -1.5,
      "prenatal_integrity": 1.0,
      "shen": 70.2,
      "S": 0.0,
      "D": 0.18,
      "V": 0.0,
      "H": 0.22,
      "explain": ""
    },
    {
      "age": 1,
      "year": 1991,
      "j0": 59.8,
      "j_final": 63.2,
      "jing_prenatal": 59.8,
      "jing_postnatal": 3.4,
      "qi": 29.4,
      "qi_pre_heaven": 30.0,
      "qi_post_heaven": -0.6,
      "prenatal_integrity": 1.0,
      "shen": 72.1,
      "S": 0.03,
      "D": 0.16,
      "V": 0.0,
      "H": 0.25,
      "explain": ""
    },
    {
      "age": 2,
      "year": 1992,
      "j0": 60.6,
      "j_final": 63.5,
      "jing_prenatal": 60.6,
      "jing_postnatal": 2.9,
      "qi": 30.4,
      "qi_pre_heaven": 30.4,
      "qi_post_heaven": 0.0,
      "prenatal_integrity": 1.0,
      "shen": 72.1,
      "S": 0.04,
      "D": 0.14,
      "V": 0.0,
      "H": 0.23,
      "explain": ""
    }
  ]
}

响应说明

curve 数组的每一项对应一个年龄，包含精、气、神状态及当年解释。模型名、版本号、内部状态代码和数值字段保持稳定；面向用户的解释文本会按 lang 本地化。