八字 API › 解夢 API

解夢 API

只要傳送夢境描述，就會依顯著程度，以 JSON 回傳從 HRUM 自行建立的夢境象徵詞庫中找到的象徵詞。商品名稱為「解夢」。詞庫只收錄詞語，不含解夢含義或吉凶判斷。相同輸入就會得到相同結果。

入門指南 Playground 價目表

回傳內容

• 象徵詞 — 只回傳該詞或其同義詞、變化形實際出現在夢境內容中的詞，最多 40 個 (items[].keywords)
• 顯著分數 — 0~1，依清單順序相同或遞減 (items[].score)
• 比對方式 — 是否在詞庫中找到，或沒有找到任何象徵 (mode)

找不到象徵時

找不到象徵時，items 會以空陣列回傳，不計費。

需要解讀文字時

回應中不含解讀文字。請把夢境內容與找到的詞，作為輸入交給八字解讀 API（only: "dream"）或 LLM API 使用。

請求範例

{
  "dream": "바다에서 커다란 물고기를 두 손으로 잡는 꿈을 꿨어요"
}

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

回應範例

{
  "success": true,
  "data": {
    "lang": "ko",
    "mode": "glossary",
    "items": [
      { "keywords": ["바다"], "score": 1 },
      { "keywords": ["물고기"], "score": 0.979 },
      { "keywords": ["손"], "score": 0.749 }
    ]
  }
}

價格

解夢每次呼叫 ₩30（VAT 另計 · 含 VAT ₩33）。只有找到一個以上的項目時才計費，結果為空則不扣款。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

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

完整價目表

完整參考文件

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

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