八字 API › 塔羅 API

塔羅 API

只要決定要抽的張數（1~10 張）或牌陣，就會從 78 張牌組（大阿爾克那 22 · 小阿爾克那 56）不重複地抽牌，以 JSON 回傳每張牌的正位與逆位、關鍵字、牌義與牌卡圖片網址。商品名稱為「塔羅」。不提供 AI 解讀，牌義為每張牌固定的文字。

入門指南 Playground 價目表

張數、牌陣、seed

count 與 spread 只能傳送其中一個。傳送 seed 時，在相同 seed、相同張數（或牌陣）、相同逆位設定下，永遠會抽出相同的牌；沒有 seed 則每次隨機。可用 lang 選擇牌名、關鍵字與牌義的語言。

牌卡圖片

imageUrl·cardBackUrl 是寬 600px 的 WebP，掃描自 1909 Rider-Waite（Pamela Colman Smith，公有領域）原版。網址中含有版本，因此不會變動。逆位的牌請把圖片旋轉 180 度顯示。

解讀要從哪裡取得

可以把抽到的牌作為輸入交給 LLM API 自行撰寫解讀，或在八字解讀 API 的請求中加入 tarot，與八字解讀一起解讀。

請求範例

{
  "spread": "past-present-future",
  "question": "올해 하반기에 이직해도 될까요?",
  "seed": "user-1042:2026-10-10"
}

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

回應範例（節錄 1 張牌）

{
  "success": true,
  "data": {
    "lang": "ko",
    "count": 3,
    "spread": { "type": "past-present-future", "name": "과거·현재·미래", "description": "시간 흐름을 따라가는 질문", "positions": ["과거", "현재", "미래"] },
    "reversedAllowed": true,
    "seed": "hrum-example-1",
    "cards": [
      {
        "position": 1,
        "positionLabel": "과거",
        "id": "wands_10",
        "name": "완드의 10",
        "nameEn": "Ten of Wands",
        "arcana": "wands",
        "reversed": true,
        "keywords": ["내려놓기", "위임", "해방"],
        "meaning": "무거운 짐을 마침내 내려놓거나 도움을 받기 시작하는 시기.",
        "imageUrl": "https://console.hrum.ai/tarot/cards/v2/wands_10.webp"
      }
    ],
    "cardBackUrl": "https://console.hrum.ai/tarot/cards/v2/back.webp",
    "question": "올해 하반기에 이직해도 될까요?",
    "costPoints": 20
  }
}

價格

塔羅每次呼叫 ₩20（VAT 另計 · 含 VAT ₩22）。不論抽 1 張還是 10 張，每次呼叫都算一次。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

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

完整價目表

完整參考文件

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

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