字段
year / month / day
类型
integer
必填
是
说明
出生日期。
基于传统八字与中医五行对应,分析体质倾向、寒热燥湿、压力模式和时间窗口。
POST /api/v1/chinese/bazi/health此接口提供传统命理与体质框架,不构成医疗建议、诊断或治疗。如有健康问题,请咨询合格的医疗专业人士。
使用 lang: "zh-CN"(POST 请求体)或?lang=zh-CN(GET 查询参数)请求简体中文响应。zh-Hans、zh 和zh_hans 也会归一化为同一书写语言。
面向用户的名称、说明、星期、五行、生肖、十神和错误消息会本地化。为避免破坏现有客户端, JSON 字段名、对象映射键、稳定 ID、错误代码、枚举值、模式值、ISO 时间戳、时区、库名、版本号和拼音保持不变。 客户端应依据字段名与稳定代码处理逻辑,不要依据翻译后的显示文本建立判断。
例如 ten_god_distribution 内的Direct Wealth 等映射键属于兼容性标识,仍使用英文;页面标题、说明、描述和独立显示值会返回中文。
示例把 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 保留算法透明度和稳定模式值。