八字 API › 紫微斗數 API

紫微斗數 API

只要傳送出生年月日時，就會計算紫微斗數命盤，以 JSON 回傳十二宮、十四主星與輔佐星（含亮度、生年四化）、五行局、命宮與身宮位置，以及基準日的大限、流年。商品名稱為「紫微斗數命盤」。相同輸入就會得到相同結果。

入門指南 Playground 價目表

回傳內容

• 十二宮 — 宮名、天干、地支、大限歲數，以及該宮的星曜 (palaces)
• 星曜 — 十四主星與輔佐星、亮度、生年四化 (majorStars·minorStars)
• 生年四化 — 化祿、化權、化科、化忌，以及該星所在的宮 (mutagens)
• 大限、流年 — 基準日的大限與流年宮 (currentDecadal·yearly)
• 規則鍵 — 以紫微斗數規則鍵字串列出命盤中成立的事實清單 (features)

加上解讀段落

傳送 readings: true 時，會附上命宮主星組合、7 個主題，以及財帛宮、官祿宮、夫妻宮、疾厄宮主星的解讀段落。此時會另外收費，金額請見參考文件。

沒有出生時刻時

紫微斗數沒有出生時刻就無法排出命盤，因此省略 hour 時會回傳 400 birth_time_required。這是錯誤回應，因此不扣款。

請求範例

{
  "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30,
  "gender": "female", "referenceDate": "2026-10-08", "lang": "ko"
}

驗證使用 X-Partner-Api-Key 標頭，基本網址為 https://api.hrum.ai/api/v1/partners/v1。Python、JavaScript 範例與錯誤處理請見入門指南。

回應範例（節錄）

{
  "success": true,
  "data": {
    "engineVersion": 1,
    "lang": "ko",
    "referenceDate": "2026-10-08",
    "clock": {
      "inputSolarDate": "1990-05-15", "inputTime": "14:30",
      "correctedSolarDate": "1990-05-15", "correctedTime": "14:30",
      "correctionMinutes": 0, "dstApplied": false, "basis": null,
      "hourBranch": { "key": "wei", "label": "미" }
    },
    "chart": {
      "engine": { "name": "iztro", "version": "2.6.1", "config": { ... } },
      "solarDate": "1990-05-15",
      "lunarDate": { "year": 1990, "month": 4, "day": 21, "isLeapMonth": false },
      "yearGanzhi": "경오",
      "yearBasisNote": null,
      "fiveElementsClass": { "key": "earth5", "label": "토오국" },
      "soulPalaceBranch": { "key": "xu", "label": "술" },
      "bodyPalaceBranch": { "key": "zi", "label": "자" },
      …

這是上方請求的回應開頭。包含十二宮、四化、規則鍵的回應與欄位說明請見參考文件。

價格

紫微斗數命盤每次呼叫 ₩50（VAT 另計 · 含 VAT ₩55）。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

取得一次的結果請儲存起來重複使用。 再次傳送相同請求會再次計費。相同出生年月日時、相同選項的計算結果相同，因此請把第一次的回應存入資料庫（例如以請求內容的雜湊值作為鍵），之後使用儲存的值就不會產生費用。像今日運勢這類會隨日期改變的結果，請把日期也放進鍵中，只在當天重複使用。

完整價目表

完整參考文件

完整參數表、回應欄位說明與錯誤代碼都在參考文件中：紫微斗數命盤 API 參考文件。其他八字商品請見所有八字 API。

聯絡我們：contact@float.do · 營運：FLOAT Co., Ltd.