紫微斗數排盤 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 則為立春。