返回中文文档
八字体质与健康倾向 API

八字体质与健康倾向 API

基于传统八字与中医五行对应,分析体质倾向、寒热燥湿、压力模式和时间窗口。

POST /api/v1/chinese/bazi/health

重要说明

此接口提供传统命理与体质框架,不构成医疗建议、诊断或治疗。如有健康问题,请咨询合格的医疗专业人士。

中文响应与兼容性约定

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

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

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

请求参数

字段
year / month / day
类型
integer
必填
说明
出生日期。
字段
hour / minute
类型
integer
必填
说明
出生时间。
字段
lat / lng
类型
float
必填
说明
出生地坐标;也可提供 city。
字段
sex
类型
string
必填
说明
M 或 F。
字段
include_timing
类型
boolean
必填
说明
是否返回大运与流年时间窗口。默认 true。
字段
timing_years_ahead
类型
integer
必填
说明
向后分析年数。默认 10。
字段
lang
类型
string
必填
说明
设置 zh-CN 返回简体中文。

请求示例

示例把 timing_years_ahead 设为 1,以完整展示包含 timing 的响应;默认值为 10。

curl -X POST "https://api.freeastroapi.com/api/v1/chinese/bazi/health" \
  -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",
    "include_timing": true,
    "timing_years_ahead": 1,
    "lang": "zh-CN"
  }'

响应示例

{
  "bazi_context": {
    "day_master": "壬",
    "day_master_element": "水",
    "day_master_strength": "身弱",
    "favorable_elements": ["水", "金"],
    "unfavorable_elements": ["木", "土"],
    "rationale": [
      "身弱 水 日主 需要生扶/印星元素",
      "喜用:能够增强水的元素",
      "生于火 季节 (巳)"
    ],
    "balance_strategy": {
      "priority_elements": ["水", "金"],
      "reason": [
        "喜用元素支持弱水日主",
        "季节(巳)会改变实际强弱"
      ]
    }
  },
  "constitution": {
    "temperature": "偏热",
    "temperature_score": 0.6,
    "temperature_scale": "[-1(寒)至 +1(热)]",
    "temperature_components": {
      "Wood": 0.001,
      "Fire": 0.674,
      "Earth": 0.0,
      "Metal": -0.036,
      "Water": -0.038
    },
    "temperature_confidence": 0.9,
    "moisture": "偏燥",
    "moisture_score": -0.48,
    "moisture_scale": "[-1(燥)至 +1(湿)]",
    "moisture_components": {
      "Wood": 0.001,
      "Fire": -0.539,
      "Earth": 0.077,
      "Metal": -0.06,
      "Water": 0.038
    },
    "moisture_confidence": 0.89,
    "yin_yang_skew": "平衡",
    "yang_ratio": 0.45
  },
  "element_balance": {
    "raw_absolute": {
      "Wood": 1.0,
      "Fire": 103.0,
      "Earth": 33.0,
      "Metal": 43.0,
      "Water": 20.0
    },
    "raw_total": 200.0,
    "raw_distribution": {
      "Wood": 0.5,
      "Fire": 51.5,
      "Earth": 16.5,
      "Metal": 21.5,
      "Water": 10.0
    },
    "effective_pre_normalized": {
      "Wood": 0.9,
      "Fire": 144.2,
      "Earth": 33.0,
      "Metal": 25.8,
      "Water": 10.0
    },
    "effective_distribution": {
      "Wood": 0.4,
      "Fire": 67.4,
      "Earth": 15.4,
      "Metal": 12.1,
      "Water": 4.7
    },
    "effective_method": "原始绝对值 × 季节乘数 = 季节调整前有效值,再标准化为百分比",
    "seasonal_adjustments": {
      "month_branch": "巳",
      "multipliers": {
        "Wood": 0.9,
        "Fire": 1.4,
        "Earth": 1.0,
        "Metal": 0.6,
        "Water": 0.5
      }
    },
    "rooting_scores": {
      "Wood": 0.01,
      "Fire": 0.66,
      "Earth": 0.29,
      "Metal": 0.04,
      "Water": 0.0
    },
    "rooting_raw": {
      "Wood": 0.1,
      "Fire": 5.3,
      "Earth": 2.3,
      "Metal": 0.3,
      "Water": 0.0
    },
    "dominant_elements": ["火"],
    "weak_elements": ["水", "木"]
  },
  "susceptibility_themes": [
    {
      "theme": "偏热倾向(传统框架)",
      "category": "体质",
      "drivers": ["温度评分: 0.60", "火/木元素偏重"],
      "confidence": 0.9
    },
    {
      "theme": "偏燥倾向(传统框架)",
      "category": "体质",
      "drivers": ["火/金元素偏重或水偏弱"],
      "confidence": 0.89
    }
  ],
  "stress_patterns": {
    "patterns": {
      "depletion_risk": {
        "level": "低",
        "score": 0.05,
        "drivers": [],
        "description": "能量输出超过补充能力"
      },
      "overwork_risk": {
        "level": "高",
        "score": 0.36,
        "drivers": ["财星较强"],
        "description": "追求物质目标带来的消耗"
      },
      "pressure_load": {
        "level": "中等",
        "score": 0.18,
        "drivers": [],
        "description": "外部要求与权威压力"
      },
      "recovery_capacity": {
        "level": "强",
        "score": 0.41,
        "drivers": ["印星力量强"],
        "description": "休息、恢复与接受支持的能力"
      }
    },
    "ten_god_distribution": {
      "Friend": 0.0,
      "Rob Wealth": 0.0,
      "Eating God": 0.0,
      "Hurting Officer": 4.5,
      "Indirect Wealth": 4.5,
      "Direct Wealth": 31.8,
      "7 Killings": 4.5,
      "Direct Officer": 13.6,
      "Indirect Resource": 22.7,
      "Direct Resource": 18.2
    },
    "dm_strength_context": "身弱",
    "overall_stress_index": 0.18
  },
  "tcm_correspondences": [
    {
      "element": "火",
      "system": "火 (心/小肠)",
      "tendency": "热象、躁动与烦扰(传统框架)",
      "themes": ["热", "躁动", "睡眠敏感"],
      "drivers": ["命盘中火占主导(67.4%)", "偏热命盘放大火的主题"],
      "confidence": 0.6
    },
    {
      "element": "木",
      "system": "木 (肝/胆)",
      "tendency": "气血郁滞、动力偏低(传统框架)",
      "themes": ["郁滞", "紧张", "易怒"],
      "drivers": ["命盘中木偏弱(0.4%)"],
      "confidence": 0.45
    },
    {
      "element": "水",
      "system": "水 (肾/膀胱)",
      "tendency": "活力偏低与精气耗损主题(传统框架)",
      "themes": ["活力", "耐力", "精气"],
      "drivers": ["命盘中水偏弱(4.7%)"],
      "confidence": 0.45
    },
    {
      "element": "金",
      "system": "金 (肺/大肠)",
      "tendency": "燥象、皮肤敏感(传统框架)",
      "themes": ["燥", "呼吸", "界限"],
      "drivers": ["偏燥命盘强调金的主题"],
      "confidence": 0.35
    }
  ],
  "instability_markers": {
    "markers": {
      "clashes": [],
      "punishments": [],
      "harms": [
        {
          "type": "完整方位合局(南方)",
          "pillars": ["year", "month", "day", "hour"],
          "branches": ["午", "巳", "未"],
          "impact": "潜在摩擦"
        }
      ],
      "self_punishments": [
        {
          "type": "自刑",
          "pillars": ["year", "day"],
          "branch": null,
          "impact": "内在紧张模式"
        }
      ]
    },
    "total_clashes": 0,
    "total_punishments": 1,
    "total_harms": 1,
    "instability_index": 0.43,
    "level": "中等"
  },
  "timing": {
    "decade_peaks": [
      {
        "period": "2026-2035",
        "gan_zhi": "乙酉",
        "strain_index": 0.3,
        "strain_breakdown": {
          "unfavorable_elements": 0.3,
          "clash_activation": 0.0
        },
        "strain_type": "热",
        "drivers": ["乙(木)耗泄身弱水日主(忌神)"],
        "level": "中等"
      }
    ],
    "year_peaks": [],
    "analysis_range": "2026-2026",
    "note": "仅保留与分析范围重叠的大运阶段"
  },
  "metadata": {
    "version": "1.1.0",
    "framework": "经典八字/中医对应框架",
    "day_master": "壬",
    "month_branch": "巳",
    "birth_year": 1990
  },
  "data_quality": {
    "rooting_model": "basic_hidden_stems",
    "hidden_stems_weighting": "proportional",
    "transformations": "not_applied"
  },
  "disclaimer": "本分析基于经典八字/中医对应关系,呈现的是传统体质框架,不构成医疗建议、诊断或治疗。个人健康还受许多超出占星指标的因素影响;如有健康问题,请务必咨询合格的医疗专业人士。"
}

主要响应区域

bazi_context 返回日主、喜忌元素与判断依据;element_balance 返回原始权重、季节修正和根气;constitution 返回寒热燥湿;timing 返回大运与流年压力窗口;data_quality 保留算法透明度和稳定模式值。