玄学系统 API v1.0

自研垂直命理智能体的 HTTP 接口服务 · 按模块 namespace 组织

Swagger UI ReDoc 健康检查

模块清单

八字命理 READY
子平正五行 · 排盘 · 大运流年 · 格局判断 · 古籍引证 · 合婚
奇门遁甲 PLANNED
时家奇门 · 起局 · 用神 · 智能解读（研发中）
扩展模块 PLANNED
紫微斗数 · 六爻 · 风水 · 姓名学 · 易经卜卦（路线图）

八字模块 · API 列表

GET /api/health 服务健康检查 
curl http://43.155.203.137:5001/api/health
GET /api/bazi/cities 支持的城市列表

返回 50 个支持真太阳时校正的中国城市。

curl http://43.155.203.137:5001/api/bazi/cities
POST /api/bazi/paipan 八字排盘 + 古籍引证

核心接口。返回完整结构化命盘：四柱 / 大运 / 流年 / 格局 / 五行统计 / 古籍引证。

curl -X POST http://43.155.203.137:5001/api/bazi/paipan \
  -H "Content-Type: application/json" \
  -d '{
    "year": 1990,
    "month": 5,
    "day": 20,
    "hour": 14,
    "minute": 30,
    "gender": "男",
    "city": "上海",
    "with_classics": true,
    "classics_top_k": 6
  }'
POST /api/bazi/hehun 双盘合婚对照

对照两个八字盘，输出合婚评分（满分 100）+ 等级 + 分项明细。

curl -X POST http://43.155.203.137:5001/api/bazi/hehun \
  -H "Content-Type: application/json" \
  -d '{
    "a_year": 1990, "a_month": 5, "a_day": 20, "a_hour": 14, "a_minute": 30,
    "a_gender": "男", "a_label": "男方",
    "b_year": 1992, "b_month": 8, "b_day": 15, "b_hour": 9, "b_minute": 0,
    "b_gender": "女", "b_label": "女方"
  }'
GET /api/bazi/paipan/image 命盘 PNG 图片

直接返回渲染后的命盘 PNG（含四柱、五行配色、大运、流年），便于嵌入或分享。

curl "http://43.155.203.137:5001/api/bazi/paipan/image?year=1990&month=5&day=20&hour=14&minute=30&gender=男&city=上海" -o bazi.png

在线测试

POST /api/bazi/paipan

输出 JSON 格式响应 

  






  
响应示例（精简）

  

    

      
{
  "ok": true,
  "排盘": {
    "基本信息": { "出生公历": "1990-05-20 14:30:00", "生肖": "马", ... },
    "日主": { "天干": "乙", "五行": "木", "阴阳": "阴" },
    "四柱": [
      { "柱": "年柱", "干支": "庚午", "天干十神": "正官", "纳音": "路旁土", ... },
      { "柱": "月柱", "干支": "辛巳", "天干十神": "七杀", ... },
      { "柱": "日柱", "干支": "乙酉", "天干十神": "日主", ... },
      { "柱": "时柱", "干支": "癸未", "天干十神": "偏印", ... }
    ],
    "五行统计": { "金": 3, "木": 1, "水": 1, "火": 2, "土": 1 },
    "大运": [ { "起始年龄": 6, "干支": "壬午", "天干十神": "正印" }, ... ],
    "流年": [ { "年龄": 37, "公历年": 2026, "干支": "丙午", "天干十神": "伤官" }, ... ],
    "格局": {
      "主格": "正官格",
      "格类": "正格-透干",
      "是否身弱": true,
      "命局特点": ["官杀混杂（正官与七杀同透）"]
    }
  },
  "古籍引证": [
    { "出处": "《滴天髓·乙木》", "原文": "乙木虽柔，刲羊解牛。怀丁抱丙...", "相关度": 0.218 },
    ...
  ]
}