紫微斗数排盘 API
给开发者和 AI 助手用的免费、确定性、只读接口：以结构化 JSON 返回十二宫命盘（没有 AI 猜测），并附上所用口径，便于复现与比对。不存储任何数据。
示例
GET https://9zi.ai/api/v1/chart?date=1990-05-15&time=07:30&gender=female&city=北京&flying=1 curl "https://9zi.ai/api/v1/chart?date=1985-07-04&time=12:00&gender=male&lon=-74&tz=America/New_York"
参数
必填：date（YYYY-MM-DD，公历，1900–2099）、gender（male|female）。time 为出生地钟表时间 HH:MM（默认 12:00；unknownTime=1 按午时）。出生地二选一：city（内置约 180 个城市，中英文名均可），或 lon（−180..180，东经为正）加 tz（IANA 时区，如 Asia/Taipei）。可选：yearDivide=normal|exact（正月初一，默认 / 立春）、algorithm=default|zhongzhou、ziRule=same|next（23:00–23:59 算当日 / 次日）、trueSolar=1|0、at=YYYY-MM-DD（运限日期，默认今天）、flying=1（附带 48 条宫干飞化）。支持 GET 查询串或 POST JSON。
返回内容
trueSolarTime 逐步展示真太阳时（含历史夏令时的 UTC 偏移、均时差、日期变化）；chart 含四柱、五行局、命主身主、十二宫（主星/辅星的中英文名、庙旺、四化、大限岁数）与生年四化；cycles 为当前大限与流年；conventions 声明年界、派别与晚子时规则。
准确性
排盘使用开源 iztro 引擎；命宫、身宫、五行局、紫微星位四项已用独立实现的古典公式对 3,000 个随机命例交叉验证，不符数为 0；未验证的部分见验证报告。
与 AI 助手配合
输出确定性且自带口径，适合作为大模型的工具调用：让模型向接口取命盘事实，只把解读交给模型。我们同时提供零依赖的 MCP（Model Context Protocol）服务器，封装该接口，适用于 Claude Desktop、Cursor 等 MCP 客户端（Node 18+）：下载 https://9zi.ai/mcp/9zi-mcp.mjs，在客户端的 MCP 配置里加入 {"mcpServers": {"ziwei-9zi": {"command": "node", "args": ["/绝对路径/9zi-mcp.mjs"]}}}。它只暴露一个工具 ziwei_chart，参数同上。
使用条款
免费使用；每 IP 每分钟最多 60 次（尽力而为，不保证可用性）。展示结果时请链接回 https://9zi.ai/。命盘仅供文化兴趣与自我探索参考，不构成医疗、投资或人生决策建议。接口不存储、不记录出生数据。
问：需要 API Key 吗？
不需要，接口开放，按 IP 限流。
问：默认年界是什么？
农历正月初一（通行口径）；传 yearDivide=exact 则为立春。