盲派八字推理

按出生资料生成四柱排盘与传统文化解读

userinfo 或完整结构化出生资料至少提供一组，同时提供时结构化资料优先。统一按北京时间和民用零点换日，不作真太阳时校正。支持同步、流式和任务模式；任务受理不扣次，最终成功结算一次，失败或过期释放，轮询不扣次；已受理任务不会因提交端断连自动取消。流式先返回 content/text，完整校验后返回 done/result，再发送 event:end 的 [DONE]。结果仅供娱乐与传统文化参考，不作为健康判断或现实决策依据。任务受理和任务查询沿用 HTTP 200，通过 Data.status 判断执行状态；现代完整成功结果包含全部十个顶层章节字段。

参数	类型	必填	默认值	说明
appkey	string	是	无	购买本接口后获得的 APPKEY。兼容 Query 的 appkey、请求头 X-GUGUDATA-APPKEY、X-API-Key、AppKey 和 Bearer，以及表单或 JSON Body 凭据；多处一致凭据允许，重复或冲突凭据失败。
userinfo	string	否	无	旧版自然语言兼容参数。必须同时写明性别、历法、出生日期和出生时间，例如：我是男性，我的公历出生日期是2016年11月23日，出生时间是18:00。与结构化参数同时提供时，以 gender、calendarType、birthDate、birthTime 等结构化参数为准。
gender	string	否	无	结构化调用时必填。性别，支持：男、女、male、female。
calendarType	string	否	无	结构化调用时必填。birthDate 使用的历法，支持：公历、农历、solar、gregorian、lunar。无运行默认值，不能省略历法后推断。
birthDate	string	否	无	结构化调用时必填。出生日期，严格使用 YYYY-MM-DD 格式，支持范围为 1901-01-01 至 2100-12-31；calendarType=农历时填写农历年月日。
birthTime	string	否	无	结构化调用时必填。出生时间，推荐使用 HH:mm 24 小时制，例如 18:00。支持丑时至亥时等传统时辰输入，并按该时辰的中间时刻标准化；子时跨越两个公历日期，必须改用 HH:mm 明确具体时间。
birthPlace	string	否	无	出生地点，用于文化解读背景。当前排盘统一按 Asia/Shanghai 时区和输入的北京时间计算，不根据经度进行真太阳时校正。
isLeapMonth	bool	否	false	仅 calendarType=农历时有效。出生月份是否为闰月；公历输入必须为 false。
streaming	bool	否	false	是否使用 SSE 流式响应。false 返回完整 JSON；true 先发送 type=content 的文本片段，最后发送 type=done，其中 result 为包含确定性排盘基础的完整结果。
responseMode	string	否	sync	响应模式，支持 sync、task。sync 在当前请求中返回结果；task 先返回 operationId，再调用任务状态查询接口轮询。responseMode=task 不能与 streaming=true 同时使用。

请求示例（与默认值独立）：

{
  "gender": "女",
  "calendarType": "公历",
  "birthDate": "1992-06-15",
  "birthTime": "09:20",
  "birthPlace": "苏州",
  "isLeapMonth": false,
  "streaming": false,
  "responseMode": "sync"
}

业务说明

支持结构化出生资料，也兼容 userinfo 自然语言输入，便于已有调用方式继续使用。

支持公历与农历出生日期，并提供农历闰月标记，适合按照不同历法整理个人资料。

返回标准化出生信息，便于用户核对日期、时间和历法后再阅读对应的文化解读。

提供公历与农历换算结果，可在个人报告中同时展示两种日期，减少手工整理步骤。

分别返回年柱、月柱、日柱和时柱，便于制作四柱排盘视图与完整的八字资料卡。

提供五行相关文化分析，适合将传统概念与个人排盘资料组织成分章节的阅读内容。

包含大运等传统命理维度的解读，便于文化研究者对照不同章节理解相关术语。

按学业事业、关系等生活主题组织解读，便于读者选择感兴趣的章节进行阅读。

支持同步返回与异步任务获取，长篇解读可以先提交任务，再在完成后展示全文。

支持流式呈现解读过程，适合需要逐步显示内容的传统文化问答与报告阅读页面。

返回字段

字段	类型	说明
DataStatus.RequestParameter	string	本次真实可读业务请求参数，不含鉴权凭据；Demo 与对应样例输入一致。
DataStatus.StatusCode	int	业务状态码：100 成功；501 参数错误；502 请求频率受限；503 商品权益过期；504 APPKEY 无效；505 调用额度不足；901 处理或依赖失败。本品缺少 APPKEY 采用 501/HTTP 400。
DataStatus.StatusDescription	string	业务状态说明；参数错误说明无效输入，处理失败不返回内部异常。
DataStatus.ResponseDateTime	string	接口响应生成时间。
DataStatus.DataTotalCount	int	当前返回的业务结果数量；同步成功时通常为 1。
Data.排盘基础	object	同步成功或任务成功的 result 中必有；任务受理时不返回。由历法组件计算并固定返回的排盘依据，包含标准化输入、历法换算、四柱和八字。文化解读以此字段为准。
Data.排盘基础.输入信息	object	同步成功或任务成功的 result 中必有；任务受理时不返回。标准化后的性别、历法、出生日期、出生时间、出生地点、闰月标识及时间标准化说明。
Data.排盘基础.历法换算.公历时间	string	同步成功或任务成功的 result 中必有；任务受理时不返回。排盘实际采用的公历时间，格式为 YYYY-MM-DD HH:mm:ss；农历输入会先换算为此时间。
Data.排盘基础.历法换算.农历日期	string	同步成功或任务成功的 result 中必有；任务受理时不返回。排盘实际对应的农历日期。
Data.排盘基础.历法换算.时区	string	同步成功或任务成功的 result 中必有；任务受理时不返回。排盘使用的时区，固定为 Asia/Shanghai。
Data.排盘基础.历法换算.日界规则	string	同步成功或任务成功的 result 中必有；任务受理时不返回。日期换日规则。23:00 至 23:59 仍属于输入的公历日期，次日 00:00 后进入下一日。
Data.排盘基础.四柱	object	同步成功或任务成功的 result 中必有；任务受理时不返回。确定性计算得到的年柱、月柱、日柱、时柱。
Data.八字	string	同步成功或任务成功的 result 中必有；任务受理时不返回。按年柱、月柱、日柱、时柱顺序拼接的八字结果，与 Data.排盘基础.四柱保持一致。
Data.五行	object	同步成功或任务成功的 result 中必有；包含非空字符串分布、旺衰、喜用。
Data.命宫	string	同步成功或任务成功的 result 中必有；任务受理时不返回。命宫相关文化解读。
Data.身宫	string	同步成功或任务成功的 result 中必有；任务受理时不返回。身宫相关文化解读。
Data.大运	array(object)	同步成功或任务成功的 result 中必有；固定四个阶段对象，各包含非空字符串阶段、干支、解读。
Data.运势分析	object	同步成功或任务成功的 result 中必有；包含学业事业、关系婚姻、财运、健康、性格特征、关键阶段六项非空字符串文化解读。
Data.综合评价	string	同步成功或任务成功的 result 中必有；任务受理时不返回。基于排盘基础生成的综合文化解读。
Data.免责声明	string	同步成功或任务成功的 result 中必有；结果使用边界说明，仅供传统文化研究与娱乐参考。
Data.operationId	string	仅 responseMode=task 时返回，作为后续任务状态查询的唯一标识。
Data.status	string	任务受理或任务查询时返回；PENDING、RUNNING、SUCCEEDED、FAILED、EXPIRED。任务受理仍使用 HTTP 200，不表示业务已执行成功。
Data.pollingUrl	string	仅任务模式返回，用于轮询任务状态的相对路径。
Data.expiresAt	string	仅任务模式返回，任务结果的过期时间。
Data.result	object	仅任务查询状态为 SUCCEEDED 时返回；为完整同步业务结果，任务受理阶段不返回。
Data.error	object	任务状态为 FAILED 时返回的业务侧失败信息。
SSE.done.result	object	仅 streaming=true 时，在最后一个 type=done 消息中返回的完整且已校验结果。
Data.融合分析文字	string	同步成功或任务成功的 result 中必有；任务受理时不返回。对各章节传统文化解读的连贯总结。
Data.五行.分布	string	同步成功或任务成功的 result 中必有；五行分布的文化解读。
Data.五行.旺衰	string	同步成功或任务成功的 result 中必有；五行旺衰的文化解读。
Data.五行.喜用	string	同步成功或任务成功的 result 中必有；喜用相关文化解读。

返回模式

同步返回完整 JSON；streaming=true 返回 content/text 片段、唯一 done/result 和 event:end 的 [DONE]。流已开始后的失败通过 error 事件说明，不发送成功终态。responseMode=task 受理的 HTTP 200 不代表任务完成，只有 SUCCEEDED 才有完整 result；PENDING/RUNNING 仍未完成。

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例

{
  "gender": "女",
  "calendarType": "公历",
  "birthDate": "1992-06-15",
  "birthTime": "09:20",
  "birthPlace": "江苏苏州",
  "isLeapMonth": false,
  "responseMode": "sync",
  "streaming": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功，业务码 100。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"{\"birthPlace\":\"江苏苏州\",\"birthTime\":\"09:20\",\"calendarType\":\"公历\",\"isLeapMonth\":false,\"gender\":\"女\",\"birthDate\":\"1992-06-15\",\"streaming\":false,\"responseMode\":\"sync\"}","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-10-29 10:18:23.015","DataTotalCount":1},"Data":{"综合评价":"本次资料给出四柱为壬申、丙午、壬戌、乙巳，表层五行数量为金1、木1、水2、火3、土1；命宫丙午、身宫壬子。这些符号与数字只是排盘记录，不指向个人特质或事件。一个中性文化问题：在传统五行相生相克的框架里，火3与水2这两个数字之间，若用\"水火既济\"或\"水火未济\"的意象来比喻，你会更倾向哪一种阅读角度？","融合分析文字":"四柱壬申、丙午、壬戌、乙巳，表层数量金1、木1、水2、火3、土1，命宫丙午、身宫壬子，大运依次为乙巳、甲辰、癸卯、壬寅。这些原值像一组并排摆放的符号卡片，彼此之间只存在资料上的相邻关系。若把\"火3\"比作一簇明火、\"水2\"比作两处水流，它们相遇时是相互映照还是彼此冲淡，是一个可以开放讨论的文化比喻，而非对这张命盘的整体定性。","五行":{"分布":"金1、木1、水2、火3、土1","旺衰":"本次表层数量照录为：金1、木1、水2、火3、土1。仅从数字大小看，火3最多，水2次之，金、木、土各为1。这只是一次数字多少的对照，不等于五行强弱计算，也不代表任何现实能力或需求。","喜用":"本次资料只提供四柱天干与地支的表层五行统计（金1、木1、水2、火3、土1）、命宫丙午、身宫壬子，以及四项大运的干支标记。未计算十神、长生、禄位、旺衰或喜用，因此没有确定任何个人调衡元素；若想讨论\"补什么、用什么\"，需另行说明计算口径。"},"命宫":"丙午；命宫为丙午，天干丙属火、地支午属火，两处皆火。若把\"火\"比作一盏灯或一处炉火，命宫这处位置在文化意象上偏于明亮、外显。一个中性比较问题：同样是火，你会把它读作\"持续照明的灯\"还是\"短暂升腾的焰\"，这两种意象哪一种更贴近你对\"位置\"的理解？","身宫":"壬子；身宫为壬子，天干壬属水、地支子属水，两处皆水。若把\"水\"比作流动的溪流或静止的深潭，身宫这处位置在文化意象上偏于流动、内敛。一个中性比较问题：同样是水，你更愿意把它理解为\"顺势而行\"还是\"蓄势待发\"，这两种读法会带来怎样不同的观察？","大运":[{"阶段":"虚岁4–13岁","干支":"乙巳","解读":"第一项大运为乙巳，天干乙属木、地支巳属火。木与火在相生关系中对应\"木生火\"，像添柴助燃的意象。一个开放问题：若把这一阶段比作\"为火添薪\"，你会关注\"薪柴从何而来\"，还是关注\"火焰如何延续\"？"},{"阶段":"虚岁14–23岁","干支":"甲辰","解读":"第二项大运为甲辰，天干甲属木、地支辰属土。木与土在相克关系中对应\"木克土\"，像根须深入土壤的意象。一个开放问题：若把这一阶段比作\"木扎根于土\"，你会更留意\"扎根的深浅\"，还是\"土壤的松紧\"？"},{"阶段":"虚岁24–33岁","干支":"癸卯","解读":"第三项大运为癸卯，天干癸属水、地支卯属木。水与木在相生关系中对应\"水生木\"，像雨露滋养草木的意象。一个开放问题：若把这一阶段比作\"水润木生\"，你会关注\"水量的多少\"，还是\"草木是否愿意承接\"？"},{"阶段":"虚岁34–43岁","干支":"壬寅","解读":"第四项大运为壬寅，天干壬属水、地支寅属木。水与木同样对应\"水生木\"，像水流经过林地的意象。一个开放问题：若把这一阶段比作\"水行于木间\"，你会更留意\"水流的方向\"，还是\"林木的疏密\"？"}],"运势分析":{"学业事业":"四柱中时柱为乙巳，天干乙属木、地支巳属火，对应相生关系\"木生火\"。字面事实是：木与火相邻，像燃料与火焰的关系。一个关于学习或工作方法的中性开放问题：在推进一件事时，你更习惯先\"备好燃料\"再点火，还是先\"点起小火\"再逐步添柴？","关系婚姻":"四柱中月柱为丙午，天干丙属火、地支午属火，两处皆火。字面事实是：火与火并置，像两处光源相邻。一个关于表达、倾听或界限的中性开放问题：在交流中，当双方都\"热\"起来时，你会如何分辨\"共鸣\"与\"相争\"的界限？","财运":"四柱中日柱为壬戌，天干壬属水、地支戌属土，对应相克关系\"土克水\"。字面事实是：土与水相邻，像堤岸与水流的关系。一个关于资源使用或管理观念的中性开放问题：面对手头的资源，你更倾向于\"筑堤蓄水\"式的留存，还是\"开渠引流\"式的流动？","健康":"本次资料中的五行数量（金1、木1、水2、火3、土1）与四柱、宫位、大运符号，都只是传统文化表达，不能用来判断实际健康状况。如有身体不适，请咨询合格的专业医疗人员。","性格特征":"四柱中月柱为丙午，天干丙属火、地支午属火，两处皆火。字面事实是：火在表层数量中出现了3次，是本次统计里数字最多的一项。一个中性的自我观察问题：当你感到\"热情高涨\"时，你会如何留意这股热度是来自内在动力，还是来自外部环境的带动？","关键阶段":"四项大运按给定顺序为：虚岁4–13岁乙巳、虚岁14–23岁甲辰、虚岁24–33岁癸卯、虚岁34–43岁壬寅。这些只是传统排运的标记与顺序，不是人生事件发生的年龄。一个文化阅读线索：若把这四段标记依次看作\"木生火—木克土—水生木—水生木\"的意象序列，你会如何用一条连续的故事线去串联它们，而不把它当作对个人轨迹的描述？"},"排盘基础":{"输入信息":{"性别":"女","历法":"公历","出生日期":"1992-06-15","出生时间":"09:20:00","出生地点":"江苏苏州","是否闰月":false,"时间标准化说明":"精确时间"},"历法换算":{"公历时间":"1992-06-15 09:20:00","农历日期":"一九九二年五月十五","生肖":"猴","时区":"Asia/Shanghai","日界规则":"按民用日期 00:00 换日","真太阳时校正":"未启用，按输入的北京时间计算"},"四柱":{"年柱":"壬申","月柱":"丙午","日柱":"壬戌","时柱":"乙巳"},"八字":"壬申 丙午 壬戌 乙巳"},"八字":"壬申 丙午 壬戌 乙巳","免责声明":"结果用于传统文化研究与娱乐参考，不应作为现实决策依据。"}}

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502服务暂时不可用。数据服务暂时不可用，请稍后重试。

🔴503文化解读暂不可用，业务码 901；失败不返回占位成功结果。

业务说明#