字段
year
类型
integer
必填
是
说明
出生年份，必须大于等于 1。
返回中文文档
四柱八字 API
四柱八字 API
POST
/api/v1/chinese/bazi该接口根据出生日期、时间和地点计算完整的 Four Pillars of Destiny（八字）结构，包含 Day Master 分析、Ten Gods、Life Stages、五行平衡，以及可选的专业功能。
中文响应与兼容性约定
使用 lang: "zh-CN"（POST 请求体）或?lang=zh-CN（GET 查询参数）请求简体中文响应。zh-Hans、zh 和zh_hans 也会归一化为同一书写语言。
面向用户的名称、说明、星期、五行、生肖、十神和错误消息会本地化。为避免破坏现有客户端， JSON 字段名、对象映射键、稳定 ID、错误代码、枚举值、模式值、ISO 时间戳、时区、库名、版本号和拼音保持不变。 客户端应依据字段名与稳定代码处理逻辑，不要依据翻译后的显示文本建立判断。
例如 ten_god_distribution 内的Direct Wealth 等映射键属于兼容性标识，仍使用英文；页面标题、说明、描述和独立显示值会返回中文。
完整 URL
https://api.freeastroapi.com/api/v1/chinese/bazi可用功能
四柱
Year、Month、Day、Hour 及 Stems & Branches。
十神
每个 stem 与 Day Master 的关系。
藏干
每个 branch 内部的能量。
十二长生
每柱的 12 Di Shi（成长阶段）。
大运
返回从出生开始推算的 10 年 Da Yun periods。
五行平衡
五行点数分布。
Pinyin
中文字符的罗马化。
神煞
天乙、桃花等。
作用关系
合、冲、害、刑等。
专业分析
日主强弱、格局、用神分析。
time_standard 选择
civil
直接使用标准钟表时间。最适合现代出生。
true_solar
基于经度将钟表时间转换为 Local Mean Time (LMT)。
true_solar_absolute
使用带均时差修正的天文学 true solar time。
请求参数
字段
month
类型
integer
必填
是
说明
出生月份，范围 1-12。
字段
day
类型
integer
必填
是
说明
出生日期，范围 1-31。
字段
hour
类型
integer
必填
否
说明
出生小时，范围 0-23；默认 12。
字段
minute
类型
integer
必填
否
说明
出生分钟，范围 0-59；默认 0。
字段
city
类型
string | null
必填
否
说明
用于坐标解析的城市名称。必须提供可解析的 city，或同时提供 lat 和 lng。
字段
lat
类型
number | null
必填
否
说明
纬度，范围 -90 至 90；省略 city 时须与 lng 一起提供。
字段
lng
类型
number | null
必填
否
说明
经度，范围 -180 至 180；省略 city 时须与 lat 一起提供。
字段
tz_str
类型
string | null
必填
否
说明
IANA 时区名称或 AUTO；默认 AUTO。
字段
sex
类型
"M" | "F"
必填
否
说明
用于大运方向等规则；接受 M 或 F，默认 M。
字段
time_standard
类型
string
必填
否
说明
接受 civil、true_solar 或 true_solar_absolute；默认 civil。
字段
calendar
类型
string
必填
否
说明
接受 gregorian 或 julian；默认 gregorian。
字段
include_ten_gods
类型
boolean
必填
否
说明
是否在每柱返回十神；默认 true。
字段
include_pinyin
类型
boolean
必填
否
说明
是否返回拼音字段；默认 true。
字段
include_stars
类型
boolean
必填
否
说明
是否返回神煞；默认 true。
字段
include_interactions
类型
boolean
必填
否
说明
是否返回合、冲、害、刑、破等作用关系；默认 true。
字段
include_professional
类型
boolean
必填
否
说明
是否返回日主强弱、格局、用神等专业分析；默认 true。
字段
include_debug
类型
boolean
必填
否
说明
是否返回计算与专业分析调试数据；默认 true。
字段
include_current_flow
类型
boolean
必填
否
说明
是否返回当前流年触发信息；默认 false。
字段
lang
类型
string
必填
否
说明
响应语言；默认 en。使用 zh-CN 返回简体中文。
调用示例
curl -X POST "https://api.freeastroapi.com/api/v1/chinese/bazi" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"year": 1990,
"month": 5,
"day": 15,
"hour": 10,
"minute": 30,
"lat": 28.6139,
"lng": 77.2090,
"city": "New Delhi",
"sex": "M",
"time_standard": "civil",
"calendar": "gregorian",
"tz_str": "Asia/Kolkata",
"include_ten_gods": true,
"include_pinyin": true,
"include_stars": true,
"include_interactions": true,
"include_professional": true,
"include_debug": false,
"include_current_flow": false,
"lang": "zh-CN"
}'响应数据
{
"day_master": {
"stem": "丙",
"pinyin": "bǐng",
"info": {
"name": "丙",
"element": "火",
"polarity": "阳"
}
},
"pillars": [
{
"label": "年柱",
"gan": "庚",
"gan_pinyin": "gēng",
"zhi": "午",
"zhi_pinyin": "wǔ",
"gan_zhi": "庚午",
"ten_gods": {
"stem": "正财",
"hidden": ["偏印", "劫财"]
},
"life_stage": {
"name": "沐浴",
"name_zh": "沐浴",
"score": 5
},
"nayin": "路旁土",
"hidden_stems": ["丁", "己"]
}
],
"stars": [
{
"name": "天乙贵人",
"name_zh": "天乙贵人",
"pillar": "日柱",
"description": "最强的保护性神煞"
}
],
"professional": {
"dm_strength": "身强",
"dm_strength_score": 0.64,
"structure": "正印格",
"yong_shen_candidates": ["火", "木"]
}
}相关接口
展示示例
查看你可以用 BaZi API 构建什么。我们的官方开源计算器展示了如何使用这个 endpoint 可视化四柱、大运周期和五行平衡。
在 GitHub 查看 BaZi 计算器