周易八字合婚

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

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

接口简介

周易八字合婚接口（POST /api/hehun）。传入 male_birthday 与 female_birthday（阳历出生日期时间，YYYY-MM-DD HH，只给日期时按当日午时 12:00 排盘），male_surname / female_surname 选传且仅作称呼展示。段一由 lunar_python 分别排男女八字，段二由合婚规则引擎算出五维分项评分与加权综合分（纯确定性，模型不参与打分），段三由大模型把规则结论写成白话解读。返回 male / female（双方排盘）、items（五项分项：分数 + 规则结论 + 模型解读）、grade（等级）、highlights / warnings（加分点与注意点）、advice（相处建议）、output_score（1~100，等于规则引擎综合分）与 output_content（综合解读），并固定附带 notice 免责声明。默认使用 qwen-plus，可在后台切换。

详细介绍

传入男女双方的阳历出生时间与时辰，先拿到两份确定性排盘结果，再拿到一个由传统合婚规则算出的综合评分与五个维度的分项得分，最后拿到每个维度的白话解读与相处建议。

## 接口概述

周易八字合婚接口面向婚恋配对与娱乐化命理场景：传入 male_birthday 与 female_birthday，接口分三段工作。第一段由排盘程序（lunar_python 八字模块）分别确定性算出男女双方的四柱干支、十神、五行分布、纳音与神煞；第二段由合婚规则引擎从生肖配对（25%）、日柱夫妻宫（25%）、五行互补（20%）、纳音生克（20%）、神煞参考（10%）五个维度逐项打分并加权出 output_score；第三段把双方命盘与规则结论交给大模型，生成每个维度的白话解读、相处建议与综合解读。每条结果固定附带免责声明：本结果仅供娱乐与传统文化参考，不构成任何专业建议。默认使用 qwen-plus，可在后台切换。

## 核心能力

1. **评分可复现**：output_score 与五个分项分全部由本地规则引擎确定性算出，大模型不参与打分，同样入参永远得到同样分数。
2. **排盘与解读分离**：四柱、五行、纳音由确定性算法算出，模型只负责把结论写成通顺文案，从结构上杜绝「AI 算错八字」。
3. **结论可溯源**：items 里 rule_desc 是规则结论、reading 是模型解读，两者并列返回，调用方可只展示其中一层。
4. **五维分项**：生肖配对、日柱夫妻宫、五行互补、纳音生克、神煞参考，覆盖传统合婚的主要判据。
5. **合规内置**：恐吓性词汇、改命诱导、绝对化预测在输出前统一过滤，涉及婚姻决策等内容自动追加「请咨询专业人士」提示。

## 产品优势

- **分数与等级开箱即用**：output_score（1~100）+ grade（大吉/吉/中平/偏弱/需谨慎）可直接渲染成星级或标签。
- **双方排盘一并返回**：male / female 里已含四柱、五行、纳音与神煞命中情况，前端无需再调一次八字接口。
- **时辰敏感**：时柱由 hour 划分，入参建议给到 `YYYY-MM-DD HH`；对客展示的生日简化到小时（同口径），排盘精度不损失。

## 效果展示

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| male_birthday | 1995-08-15 08 | 男方阳历出生时间，只给日期时按午时 12:00 排盘 |
| female_birthday | 1999-11-20 19 | 女方阳历出生时间，同上 |
| male_surname | 张 | 选传，仅作称呼展示，不影响评分 |
| female_surname | 李 | 选传，仅作称呼展示，不影响评分 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 男方四柱 | 乙亥 / 甲申 / 戊寅 / 丙辰（属猪，日主戊土） | `male.bazi` |
| 女方四柱 | 己卯 / 乙亥 / 丙子 / 戊戌（属兔，日主丙火） | `female.bazi` |
| 生肖配对 | 亥卯三合（得分 95，权重 25%） | `items[0]` |
| 日柱夫妻宫 | 日干戊与丙无合无冲、日支寅与子无合无冲（得分 60，权重 25%） | `items[1]` |
| 五行互补 | 女方缺金而男方具备；女方日主丙火生男方日主戊土（得分 86，权重 20%） | `items[2]` |
| 纳音生克 | 男山头火生女城头土；日柱纳音城头土与涧下水相克（得分 76，权重 20%） | `items[3]` |
| 神煞参考 | 男方命局见孤辰（寅），女方未见（得分 68，权重 10%） | `items[4]` |
| 合婚综合评分与等级 | 78（吉） | `output_score` / `grade` |
| 分项解读与相处建议 | 五项解读各 60~120 字 + 建议 100~180 字 | `items[].reading` / `advice` |
| 综合解读 | 一段 150~250 字的总结 | `output_content` |

> 表中双方四柱、生肖、五行、纳音、神煞命中与五项得分均为本地程序实算输出（同一组入参可复现）；分项解读文案由模型生成，每次调用措辞会不同。

## 应用场景

- **婚恋交友平台**：配对页的娱乐化契合度模块，分数做成契合度百分比与五维雷达图
- **命理娱乐站点**：合婚测算页一次调用拿全双方排盘、评分、分项与解读
- **小程序/App**：把五个维度做成卡片轮播，advice 放到结果页底部做分享文案

## 应用案例

- **某婚恋小程序**：合婚测算页接入本接口，上半屏并列展示男女双方四柱，中间用五维雷达图呈现 items 得分，底部展示 advice 与综合解读，单次调用完成整页内容。
- **某内容平台**：把 output_score 与 grade 做成情侣契合度标签，配合 highlights 生成分享卡片，提升传播率。

## 注意事项

- 结果为传统文化娱乐化解读，不构成婚恋决策、法律、医疗等任何专业建议。
- 姓氏仅作称呼展示，不参与测算也不影响评分，可以不传。
- 时辰缺失时按当日午时 12:00 排盘，时柱会与真实命盘不同，建议在页面上提示用户补全出生时间。
- 两个 birthday 早于 1900 年或晚于当前时间返回参数错误；错误文案会带上 male_birthday / female_birthday 字段名，方便定位是哪一方填错。

八字合婚合婚测算婚恋配对生肖配对周易命理

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`male_birthday`	string	必填	-	男方阳历出生日期时间，格式 YYYY-MM-DD HH（如 1995-08-15 12）；只传 YYYY-MM-DD 时按当日午时 12:00 排盘
`female_birthday`	string	必填	-	女方阳历出生日期时间，格式同 male_birthday
`male_surname`	string	选填	-	男方姓氏。仅作称呼展示，【不参与测算也不影响评分】
`female_surname`	string	选填	-	女方姓氏。仅作称呼展示，【不参与测算也不影响评分】

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`male`−	object	男方信息（排盘确定性数据 + 入参回显）
`surname`	string	姓氏（仅称呼展示，不参与测算）
`birthday`	string	归一化后的男方阳历出生时间，展示到小时
`zodiac`	string	生肖
`bazi`	object	排盘结果（确定性计算，非模型生成）
`hit_guchen`	bool	命局是否命中孤辰（神煞参考）
`hit_guasu`	bool	命局是否命中寡宿（神煞参考）
`female`−	object	女方信息（排盘确定性数据 + 入参回显）
`surname`	string	姓氏（仅称呼展示，不参与测算）
`birthday`	string	归一化后的女方阳历出生时间，展示到小时
`zodiac`	string	生肖
`bazi`	object	排盘结果（确定性计算，非模型生成）
`hit_guchen`	bool	命局是否命中孤辰（神煞参考）
`hit_guasu`	bool	命局是否命中寡宿（神煞参考）
`output_score`	int	合婚综合评分 1~100（由本地规则引擎加权算出，非模型给分）：≥85 大吉、70~84 吉、55~69 中平、40~54 偏弱、<40 需谨慎
`grade`	string	合婚等级：大吉 / 吉 / 中平 / 偏弱 / 需谨慎
`items`−	array	五个评分维度的分项明细
`key`	string	维度标识：zodiac 生肖配对 / day_pillar 日柱夫妻宫 / wuxing 五行互补 / nayin 纳音生克 / shensha 神煞参考
`name`	string	维度中文名
`score`	int	该维度得分 0~100
`weight`	double	该维度在综合分中的权重（五项合计 1.0）
`relation`	string	命中的传统关系（如六合 / 六冲 / 五合 / 生 / 克）
`rule_desc`	string	规则引擎给出的确定性结论（含具体干支与五行）
`reading`	string	模型生成的该维度白话解读
`highlights`	array	加分点（得分≥80 的维度结论）
`warnings`	array	注意点（得分≤50 的维度结论）
`advice`	string	相处建议（可执行的具体做法）
`output_content`	string	综合解读（含娱乐化免责声明）
`notice`	string	免责声明：本结果仅供娱乐与传统文化参考，不构成任何专业建议。
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试