八字 API › 八字解讀 API

八字解讀 API

只要傳送出生年月日時與問題，伺服器就會計算八字並放進 AI，由 AI 回傳依問題量身打造的解讀。商品名稱為「AI 八字解讀」，會記住對話的「AI 八字解讀 · 記憶」與不需問題、一次取得的「八字報告」屬於同一系列。回應中不含內部提示詞與理論，只回傳解讀結果。

入門指南 Playground 價目表

三種呼叫方式

單次諮詢 POST /reading — 一個問題回傳一份解讀。回應最多 2,000 字。
延續諮詢 POST /reading/memory — HRUM 為每位終端使用者保存對話記憶，使用者再次造訪時會接續過去的脈絡進行解讀。
一次取得報告 POST /reading/report — 不需問題，一次取得總評、財運、戀愛、大運等各區段的報告（最多 12 個區段）。

可一併加入的項目

可以一併加入紫微斗數、占星、解夢、塔羅的依據來解讀，也可以用 only 只呼叫其中一項。今日日辰不必另外呼叫，就會反映在所有解讀中。省略出生時刻（hour）時，會不排時柱，以年、月、日三柱解讀。

請求範例

單次諮詢 (/reading)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "올해 이직해도 괜찮을까요?",
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
    "maxLength": 600,
    "tone": "warm"
  }'

延續諮詢 (/reading/memory)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/memory \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "endUserId": "member-1024",
    "question": "지난번에 얘기한 이직 건, 다음 달에 움직여도 될까요?",
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" }
  }'

一次取得報告 (/reading/report)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/report \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
    "sections": ["총평", "재물운", "연애·인연"]
  }'

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

回應範例 (/reading)

{
  "success": true,
  "data": {
    "interpretation": "당신의 사주에서 보이는 특징은...",
    "sajuSource": "computed",
    "usage": {
      "inputTokens": 450,
      "outputTokens": 280
    },
    "costPoints": 18
  }
}

costPoints 是這次呼叫扣除的金額。記憶型與報告型的回應欄位請見參考文件。

價格

AI 八字解讀每 100 萬 token 輸入 ₩2,888（VAT 另計 · 含 VAT ₩3,177）、輸出 ₩23,100（VAT 另計 · 含 VAT ₩25,410）。AI 八字解讀 · 記憶每 100 萬 token 輸入 ₩3,754（VAT 另計 · 含 VAT ₩4,129）、輸出 ₩30,030（VAT 另計 · 含 VAT ₩33,033）。八字報告採 token 計費，因此每次金額並不固定，預估範圍請至價目表確認。把八字計算結果放進 AI 的部分與系統提示詞不計費，只對問題、persona 與回答的 token 計費。若一併加入其他項目，該依據區塊會計入輸入 token，並另外加上各項目的固定費用。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

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

完整價目表

完整參考文件

完整參數表、回應欄位說明與錯誤代碼都在參考文件中：AI 八字解讀參考文件 · 記憶型參考文件 · 八字報告參考文件。其他八字商品請見所有八字 API。

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