# 释玄斋易通宝 · 玄学排盘 API > 释玄斋第七代传人罗李华团队的玄学算法 API 服务。28 项中国传统命理排盘能力，按调用量计费（预付费积分），支持 REST、OpenAI function-calling、MCP 三种接入方式。 本 API 面向 AI 助手与 Agent 开发者：大模型可通过 function-calling 或 MCP 协议直接调用八字排盘、紫微斗数、奇门遁甲、大六壬等能力，用于命理问答类 Agent。 ## API 文档（请优先阅读） - [完整 API 文档与接入指南](https://www.zjhl.fjzyi.com/api-docs.html)：接口列表、参数、计费、套餐申请、代码示例 - [OpenAPI 3.1 规范（机器可读）](https://www.zjhl.fjzyi.com/api/calc/v1/openapi.json)：用于 API 市场导入、SDK 生成 - [功能目录（机器可读）](https://www.zjhl.fjzyi.com/api/calc/v1/catalog)：全部功能与参数规格 - [OpenAI function-calling 工具清单](https://www.zjhl.fjzyi.com/api/calc/v1/openai-tools)：可直接传入模型的 tools 数组 - [MCP Server 描述](https://www.zjhl.fjzyi.com/api/calc/v1/mcp-server.json)：MCP 客户端配置与目录收录 - [llms-full.txt](https://www.zjhl.fjzyi.com/llms-full.txt)：本文档的完整展开版（含全部功能说明） ## 可用功能 ### 命理 - **八字排盘**（`https://www.zjhl.fjzyi.com/api/calc/v1/bazi`，10 积分/次）：根据公历出生时间排定八字四柱（年柱、月柱、日柱、时柱），并给出日主、十神、纳音、藏干、五行计数、神煞。用于命理分析、性格/运势推断。 - **紫微斗数**（`https://www.zjhl.fjzyi.com/api/calc/v1/ziwei`，3 积分/次）：紫微斗数命盘：十二宫、十四主星、四化（禄权科忌）、乙级星/神煞、命宫/身宫、五行局。复用前端纯算法内核（ziweicore.js + ziweistar 常量，已剥离 jQuery/UI 依赖）。 - **鬼谷定数**（`https://www.zjhl.fjzyi.com/api/calc/v1/guigu`，6 积分/次）：鬼谷定数（前定数）推演：按生辰排四柱、命宫与空亡，以年干加时干共一百组查《鬼谷定数》命数，判出第几数、所属卦象、格局名（如「莺宿野林格」）与诗诀，并给出天将/天飞/天孤等星曜断语、判词原文与基业兄弟行藏婚姻子息六分节诗。适用于命理格局参研。 - **邵子神数（批命）**（`https://www.zjhl.fjzyi.com/api/calc/v1/shaozi`，6 积分/次）：邵子神数批命：按生辰排四柱，逐柱给出干支五行、十神、纳音、十二长生旺衰与地支藏干十神；推出命宫（配天秘等二十八星命）、空亡、刻与时辰、节气与五行分布；起八步大运（顺逆、起运岁数与各步流年）；并给出本卦、元堂卦、互卦、变卦的卦名卦辞彖辞断语，以及元辰/纳音/日诗/时柱/天资/品性等邵子原典诗诀。 ### 命名 - **姓名分析（测名/公司名）**（`https://www.zjhl.fjzyi.com/api/calc/v1/ceming`，10 积分/次）：分析姓名或公司名的五行搭配、三才五格、音形义吉凶，给出评分与改进建议。type 可选 person（人名）或 company（公司/品牌名）。 - **小孩起名（喜用神取名）**（`https://www.zjhl.fjzyi.com/api/calc/v1/qiming`，3 积分/次）：按出生生辰排四柱、推喜用神与忌神，以五行用字池筛选字库并组合姓名，按五格数理、人格、三才、音律、字形综合评分排序推荐。提供每个候选名的笔画、五行、音调、五格数理与三才配置详解。适合家长为婴幼儿取名。 - **公司起名（字号）**（`https://www.zjhl.fjzyi.com/api/calc/v1/gsqm`，3 积分/次）：按行业所属五行（科技/餐饮/金融/地产/文化/医疗/服装/物流/农业/法律/制造/传媒）取用字池，生成公司字号并按五格数理与三才配置评分排序，输出字号、全名笔画数理、吉凶等级与卦象含义。适合企业注册取名、品牌命名。 ### 择吉 - **择日通胜（黄历宜忌）**（`https://www.zjhl.fjzyi.com/api/calc/v1/huangli`，1 积分/次）：给定公历日期，返回当日干支、生肖、冲煞、建除十二神，以及宜/忌事项清单，用于择吉、开业、婚嫁、动土等选日。 - **事项择日（选吉日）**（`https://www.zjhl.fjzyi.com/api/calc/v1/zeri`，10 积分/次）：依据事项（结婚/开业/动土/搬家/出行/安葬/签约等）与日期范围，逐日查黄历宜忌，筛选该事项的吉日清单并标注每日建除十二神与宜忌。事项支持口语别名（如「结婚」自动匹配「嫁娶」）。 ### 占卜 - **观音灵签**（`https://www.zjhl.fjzyi.com/api/calc/v1/guanyin`，1 积分/次）：抽取观音灵签（1-100 签），返回签号、签等（上上/上/中/下）、签诗、解曰、寓意与建议。lot 不填则随机抽一签。 - **六爻占卜**（`https://www.zjhl.fjzyi.com/api/calc/v1/liuyao`，10 积分/次）：依据传统六爻（文王六十四卦）起卦解卦：支持按时间起卦、手动摇卦(6枚硬币)、数字起卦、文字测字、随机起卦。返回本卦/变卦/互卦/错卦/综卦、六亲、六神与综合解读。 - **塔罗占卜**（`https://www.zjhl.fjzyi.com/api/calc/v1/taluo`，1 积分/次）：塔罗牌阵占卜：支持单张牌、三张牌（过去/现在/未来）、凯尔特十字（10张）、关系/职业/决策/灵性/健康等 8 种牌阵。随机抽牌并给出正/逆位牌义与逐位释义。spread 可选 single/three/celtic/relationship/career/decision/spiritual/health。 - **周公解梦**（`https://www.zjhl.fjzyi.com/api/calc/v1/zhougong`，1 积分/次）：输入梦境关键词（如「蛇」「结婚」「掉牙」），从传统梦境库匹配最相关条目，返回梦境寓意、吉凶、建议与心理学/传统/现代多维度解读。 ### 运势 - **生肖运程**（`https://www.zjhl.fjzyi.com/api/calc/v1/shengxiao`，1 积分/次）：给定生肖（或出生年份），返回该生肖的性格特征、年度运势、三合六合贵人、相冲相害，以及开运建议。 ### 术数 - **奇门遁甲排盘**（`https://www.zjhl.fjzyi.com/api/calc/v1/qimen`，3 积分/次）：奇门遁甲转盘排盘：真太阳时换算、定局（拆补/置闰）、值符值使、天地人神四盘（九宫地盘、天盘九星、天盘干、八门、八神）、旬空与驿马。jia 可选时/日/月/年家奇门。 - **金口诀（四课三传）**（`https://www.zjhl.fjzyi.com/api/calc/v1/jinkoujue`，10 积分/次）：大六壬金口诀排盘：输入公历生辰、地分（difen，如「子」）与时辰，排出人元/贵神/将神/地分四课，给出月将、空亡、格局、五行分布、神煞、合冲与文字断语。可选真太阳时与中气过宫月将法。 - **大六壬（天地盘·四课三传）**（`https://www.zjhl.fjzyi.com/api/calc/v1/dlr`，3 积分/次）：大六壬起课排盘：按公历时间（可选真太阳时）排出四柱干支、月将、天地盘、十二天将、四课、三传（初/中/末传及九宗门起法）、遁干、六亲、神煞，并给出课体释义（如「重审」「元首」，附《六壬大全·九宗门》原文详解与吉凶）。适用于占事、择时、人事吉凶判断。 ### 合婚 - **八字合婚**（`https://www.zjhl.fjzyi.com/api/calc/v1/hehun`，3 积分/次）：男女双方八字合婚：年/月/日/时柱生肖与十神关系、五行互补、喜用神互补、神煞、三元命卦、星座配对综合分析与建议。输入 male/female 各自公历生辰即可。 ### 风水 - **风水罗盘（坐向分金）**（`https://www.zjhl.fjzyi.com/api/calc/v1/luopan`，10 积分/次）：输入方位角（deg，北=0顺时针）或坐山名（mountain，如「子」「午」）或地支（branch），返回二十四山坐向、后天/先天卦、九星、二十八宿、纳音等罗盘信息。 - **八宅排盘**（`https://www.zjhl.fjzyi.com/api/calc/v1/bazhai`，10 积分/次）：八宅堪舆排盘：按房屋坐向（震巽离坤兑乾坎艮八宅）排出九宫八卦方位，标注每宫的八星（生气/天医/延年/伏位/绝命/五鬼/六煞/祸害）、九星（辅弼/文曲/巨门/廉贞/破军/禄存/贪狼/武曲）、五行与吉凶倾向，并给出卦位释义与布局建议。适用于家居风水与办公室调理。 - **玄空排盘（九运）**（`https://www.zjhl.fjzyi.com/api/calc/v1/xkfs`，6 积分/次）：玄空飞星排盘：按立向年份（1864-2043）定三元九运，取下卦或替卦起星，排出九宫运星/山星/向星分布，判定旺山旺向、上山下水、双星会坐、双星会向、伏吟反吟、五黄到山到向等格局，并给出九星旺生衰死状态与星曜详解。适用于家居与商业地产风水布局。 - **阴宅速查（阴宅堪舆）**（`https://www.zjhl.fjzyi.com/api/calc/v1/yinzhai`，6 积分/次）：阴宅堪舆速查：按坐山（24 山）与兼向（正针/左兼/右兼）排定坐向、度数与四局，给出杨公十二水法原文解析与吉凶水口、大空亡与龟甲空亡判定、仙命合山生克判断（可传出生年或干支）、流年太岁岁破三煞紫白飞星，以及赖公拨砂消砂生克与二十八宿参考。适用于阴宅选址与安葬择吉。 ### 器物 - **鲁班尺（门公尺·丁兰尺）**（`https://www.zjhl.fjzyi.com/api/calc/v1/luban`，1 积分/次）：按尺寸（厘米）换算台寸，并依《鲁班尺》门公尺与《丁兰尺》阴尺两套量法各查八寸/十寸吉凶断语（如「财至」「死别」「迎福」），给出双尺吉凶与综合判语。适用于家具、门��、床铺、桌案尺寸吉凶择取。 ### 号码 - **号码分析（手机号）**（`https://www.zjhl.fjzyi.com/api/calc/v1/shouji`，1 积分/次）：手机号码分析：查七星磁场（天医/生气/延年/绝命/六煞/五鬼/伏位）滑动分布与磁场强度，按数字五行统计旺衰与缺失，按后四位起易经卦象，综合五项基础分与磁场、连号、号段、地域加分给出百分制评分与等级，并输出财运、事业、健康、婚姻四维分析与幸运色、幸运数。 ### 星座 - **星座解析（运程·合盘）**（`https://www.zjhl.fjzyi.com/api/calc/v1/xingzuo`，1 积分/次）：十二星座解析：输出基础性格画像、优缺点、星座配对与事业倾向，并按今日/本周/本月/本年四种周期给出九维运程评分与逐项解读，附幸运色/数字/宝石/花/方位/动物与开运建议；支持指定关系类型（爱情/友情/同事/家庭）查看与十二宫兼容度矩阵，并可指定对方星座做合盘详情。 ### 医易 - **黄帝内经·道医辩证**（`https://www.zjhl.fjzyi.com/api/calc/v1/daoyi`，6 积分/次）：黄帝内经道医辩证：据症状清单与舌象、苔色苔质、脉象、寒热、汗出、二便、病程等四诊信息，匹配《黄帝内经》195 个证型，输出主证型、得分与症状匹配率、候选证型排序、精确匹配与别名关联症状、八纲辨证（表里寒热虚实阴阳）、症状自相矛盾与证型互斥提示、合病并病兼夹证分析，并给出经典医籍引用、经方针灸处方、情志调摄与起居饮食调护建议。 ### 星命 - **七政星盘（七政四余）**（`https://www.zjhl.fjzyi.com/api/calc/v1/qizheng`，6 积分/次）：七政四余星盘：以 JPL Standish 轨道根数与 Meeus 月球公式计算真太阳时下的日月五星与罗睺、计都、月孛、紫炁（三王星可选）黄经黄纬赤经，排出十二宫（命宫至相貌）、宫主星与星曜分布，给出命宫身宫地支、二十八宿宿度与禽星、庙旺落陷、大限十二步、童限、四柱干支与神煞、朔望月相与日出日落。适用于七政四余命盘推演。 - **天文占星（西洋星盘）**（`https://www.zjhl.fjzyi.com/api/calc/v1/tianwen`，10 积分/次）：西洋占星星盘：按出生地经纬度与时区（含真太阳时校正、均时差）计算十大小天体黄经与日行速度（负值为逆行），排出上升点、天顶与十二宫宫头（普拉西德/等宫/波菲利三制），计算行星间合、六合、刑、拱、冲等相位与角距偏差，给出月相与月龄，并输出太阳/月亮/上升/天顶星座、性格内核、情感、事业、人际、健康、财务等结构化文字解读。 ## 计费 - 预付费积分制，按调用次数扣减，单次 1~3 积分（1 积分 ≈ 0.2 元） - 套餐：体验包 100 积分 ¥19 / 标准包 500 积分 ¥89 / 专业包 2000 积分 ¥299 / 旗舰包 10000 积分 ¥1299 - 余额不足时返回 HTTP 402 ## 可选 - [易学百科（术语释义）](https://www.zjhl.fjzyi.com/baike-home.html)：八字、紫微、奇门等术语的通俗解释 - [关于释玄斋](https://www.zjhl.fjzyi.com/about.html)：团队与传承介绍 ## 备注 - 所有接口返回 `disclaimer` 字段：传统文化视角，仅供娱乐参考，不作绝对定论。 - 试用端点：`POST https://www.zjhl.fjzyi.com/api/calc/v1/demo/{feature}`，无需 API Key，每 IP 每小时 20 次。