八字 API

只要傳送出生年月日時（以及性別、時區），八字計算與解讀就會立即以 JSON 回傳。使用與運勢應用程式「INTA – Life is Timing」相同的八字引擎，依古典命理規則計算以節氣為基礎的命盤（原局），以及用神、格局、身強弱、大運、流年與神煞。一把金鑰即可呼叫所有商品，用多少就從韓元點數扣多少。

入門指南 免金鑰試用 價目表

計算型與解讀型

• 計算型 — 萬年曆、紫微斗數、合盤、占星全覽、運勢走勢、今日運勢、解夢、塔羅。不使用 LLM，依規則計算，因此相同輸入就會得到相同結果。建議取得一次後存入資料庫重複使用。
• 解讀型 — 終身八字（預先寫好的各主題解讀段落）與 AI 八字解讀（計算八字後，由 AI 依問題諮詢、解讀）。AI 八字解讀內還包含紫微斗數、占星、塔羅、解夢 AI，可以整合呼叫，也可以只單獨呼叫其中一個。

端點

基本網址為 https://api.hrum.ai/api/v1/partners/v1，驗證使用 X-Partner-Api-Key 標頭。

路徑（參考文件）	商品（介紹）	回傳內容
POST /manseryeok	萬年曆	命盤四柱，十神、藏干、十二長生、神煞，用神、格局、身強弱，大運、流年，八字特質（Saju Identity）
POST /ziwei-chart	紫微斗數命盤	十二宮、主星、輔佐星、生年四化、大限、流年（需要出生時刻）
POST /compat	合盤	兩人的八字合盤與星座合盤、綜合分數、解讀段落
POST /astrology	占星全覽	10 個天體、宮位、相位、品位，以及預先寫好的解讀段落
POST /saju-flow	運勢走勢	大運、流年、流月的圖表用數值，以及刑沖會合清單
POST /today	今日運勢	今日日辰與自己日干的關係、吉時與宜避開的時段
POST /dream	解夢	從夢境描述中找到的象徵詞（找不到象徵就不計費）
POST /tarot	塔羅	從 78 張牌組抽出的牌、正位與逆位、牌義、牌卡圖片網址
POST /lifetime	終身八字	個性、財運、職業、戀愛、健康、人際關係、建議 7 個主題的解讀段落
POST /reading	AI 八字解讀	依問題量身打造的 AI 諮詢與解讀（/reading/memory 會記住過去的諮詢）
POST /reading/report	八字報告	不需問題，一次取得各區段的完整解讀

請求範例

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: $HRUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":15,"hour":12,"minute":0,"timezone":"Asia/Seoul","gender":"male"}'

回應格式為 {"success": true, "data": { … }}。Python、JavaScript 範例與錯誤處理請見入門指南。

價格

從預付點數中依呼叫量扣款。計算型每次呼叫為固定金額，AI 八字解讀只對問題與回答的 token 計費，把八字計算結果放進 AI 的部分免費。標示金額為未稅（VAT 另計）。

商品	價格
在價目表查看各商品價格

完整價目表 · 即使沒有金鑰，也能在 Playground 每個 IP 每月最多試用 5 次。註冊點數的條件請見入門指南。

常見問題

不知道出生時刻怎麼辦？

萬年曆只會空出時柱與真太陽時，用神、格局、身強弱等則以年、月、日三柱計算後回傳。紫微斗數命盤則需要出生時刻。

可以儲存結果嗎？

可以。計算型與終身八字只要輸入相同，結果就相同，建議儲存後重複使用。不再次呼叫就不會計費。

做好的應用程式要放在哪裡？

在同一個主控台的 RIDM Apps 應用程式託管連結 GitHub 儲存庫，就會自動建置與部署，每個應用程式都附有專屬的 PostgreSQL 資料庫。

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