周易八字算命

接口标识: bazi 价格: 0.001 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

周易八字算命接口（POST /api/bazi）。传入 birthday（阳历出生日期时间，YYYY-MM-DD HH，只给日期时按当日午时 12:00 排盘）与 sex（male 男 / female 女）。段一由 lunar_python 确定性排盘（四柱干支/十神/五行/纳音/命宫身宫胎元/大运流年，现算不落库），段二由大模型结合传统命理文化生成解读，返回 bazi（排盘结果）、ming_ge（命格）、yin_yuan（姻缘）、cai_yun（财运）、year_fortune（本年运势）、output_score（1~100）与 output_content（综合解读），并固定附带 notice 免责声明。默认使用 qwen-plus，可在后台切换。

详细介绍

传入阳历出生时间与时辰、性别，先拿到一份确定性排盘结果（四柱干支、五行分布、大运流年），再拿到一段结合传统命理文化的白话解读——命格、姻缘、财运、本年运势分项返回。

## 接口概述

周易八字算命接口面向运势测算与娱乐化命理场景：传入 birthday（阳历出生日期时间）与 sex（性别），接口分两段工作。第一段由排盘程序（lunar_python 八字模块）确定性算出四柱干支、十神、五行分布、纳音、地势、命宫身宫胎元胎息、大运与流年，现算现返回不落库；第二段把这份结构化命盘交给大模型，结合传统命理文化生成命格总论、姻缘感情、财运事业、本年运势四项解读与一段综合建议，并给出 output_score（1~100 综合运势分数）。每条结果固定附带免责声明：本结果仅供娱乐与传统文化参考，不构成任何专业建议。默认使用 qwen-plus，可在后台切换。

## 核心能力

1. **排盘与解读分离**：四柱、五行、大运流年全部由确定性算法算出，大模型不参与排盘计算，从结构上杜绝「AI 算错八字」。
2. **分项解读**：命格、姻缘、财运、本年运势四个字段独立返回，前端可分块渲染。
3. **本年运势跟流年**：自动定位当前所行大运与当年流年干支，解读与年份对齐，无需调用方传年份。
4. **量化分数**：output_score 落 1~100 整数区间，便于列表排序与吉凶分级展示。
5. **合规内置**：恐吓性词汇、改命诱导、绝对化预测在输出前统一过滤，涉及健康/投资/法律等内容自动追加「请咨询专业人士」提示。

## 产品优势

- **排盘数据可直接展示**：bazi 字段是结构化排盘结果，可原样渲染成传统八字命盘表格。
- **时辰敏感**：时柱由 hour 划分，入参建议给到 `YYYY-MM-DD HH`；对客展示的生日简化到小时（同口径），排盘精度不损失。
- **结果可程序化消费**：分项文案与分数均为固定字段，可写入用户档案、生成分享卡片。

## 效果展示

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| birthday | 1995-08-15 08 | 阳历出生日期时间，只给日期时按午时 12:00 排盘 |
| sex | male | 性别：male 男 / female 女，决定大运顺逆排 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 四柱干支 | 乙亥 / 甲申 / 戊寅 / 丙辰 | `bazi.year` / `month` / `day` / `time` |
| 四柱纳音 | 山头火 / 泉中水 / 城头土 / 沙中土 | `bazi.nayin` |
| 生肖 | 猪 | `zodiac` |
| 日主与五行分布 | 戊（土）；金1 木3 水1 火1 土2 | `bazi.day_master` / `bazi.wuxing_count` |
| 命宫 / 身宫 | 辛巳 / 己丑 | `bazi.ming_gong` / `bazi.shen_gong` |
| 胎元 / 胎息 | 乙亥 / 癸亥 | `bazi.tai_yuan` / `bazi.tai_xi` |
| 当前大运与流年 | 辛巳运（2017~2026，23~32 岁）；2026 丙午年 | `bazi.current_dayun` / `bazi.current_liunian` |
| 命格总论 | 日主戊土生于申月，食神当令…… | `ming_ge` |
| 姻缘 / 财运 / 本年运势 | 分项文案各 80~150 字 | `yin_yuan` / `cai_yun` / `year_fortune` |
| 综合运势分数 | 76 | `output_score`，1~100 整数 |
| 综合解读与建议 | 一段 150~250 字的总结与可执行建议 | `output_content` |

## 应用场景

- **命理娱乐站点**：八字测算页的核心接口，排盘表格与分项解读一次调用拿全
- **内容社区**：运势板块的用户自助测算入口，分数可做成吉凶标签与分享卡片
- **小程序/App**：把命格、姻缘、财运、本年运势做成四个 Tab 分页展示

## 应用案例

- **某命理小程序**：八字测算页接入本接口，上半屏渲染 bazi 排盘表格，下半屏分四栏展示命格、姻缘、财运与本年运势，单次调用完成整页内容。
- **某内容平台**：把 output_score 映射为运势星级，配合本年运势文案做成年度运势专题，提升用户分享率。

## 注意事项

- 结果为传统文化娱乐化解读，不构成医疗、法律、投资等任何专业建议。
- 时辰缺失时按当日午时 12:00 排盘，时柱会与真实命盘不同，建议在页面上提示用户补全出生时间。
- birthday 早于 1900 年或晚于当前时间返回参数错误。

八字算命四柱八字生辰八字运势测算周易命理

接口地址： https://www.phpwc.cn/api/bazi

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`birthday`	string	必填	-	阳历出生日期时间，格式 YYYY-MM-DD HH（如 1995-08-15 12）；只传 YYYY-MM-DD 时按当日午时 12:00 排盘。时辰决定时柱，尽量给准确的出生小时
`sex`	string	必填	-	性别：male 男 / female 女（也接受 1=男 0=女）。性别决定大运顺逆排

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`sex`	string	性别（男/女）
`birthday`	string	归一化后的阳历出生日期时间，展示到小时
`zodiac`	string	生肖
`bazi`−	object	排盘结果（确定性计算，非模型生成）
`year`	string	年柱干支
`month`	string	月柱干支
`day`	string	日柱干支
`time`	string	时柱干支
`day_master`	string	日主（日干）
`day_master_wuxing`	string	日主五行
`wuxing_count`	object	五行分布计数（金/木/水/火/土）
`nayin`	object	四柱纳音
`ming_gong`	string	命宫干支
`shen_gong`	string	身宫干支
`tai_yuan`	string	胎元干支
`tai_xi`	string	胎息干支
`current_dayun`	object	当前所行大运（干支与起止年份/年龄）
`current_liunian`	object	当年流年（年份/干支/虚岁）
`target_year`	int	本年运势对应的公历年份
`ming_ge`	string	命格总论：日主旺衰、格局倾向、性格与天赋
`yin_yuan`	string	姻缘感情解读
`cai_yun`	string	财运事业解读
`year_fortune`	string	本年运势解读（结合当前大运与流年干支）
`output_score`	int	综合运势分数 1~100：≥50 为吉（分数越高越吉），1~49 为偏弱
`output_content`	string	综合解读与建议（含娱乐化免责声明）
`notice`	string	免责声明：本结果仅供娱乐与传统文化参考，不构成任何专业建议。
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试