四柱推命API › タロットAPI

タロットAPI

引く枚数（1〜10枚）かスプレッドを選ぶと、78枚のデッキ（大アルカナ22枚・小アルカナ56枚）から重複なしでカードを引き、カードごとの正位置/逆位置、キーワード、意味、カード画像URLをJSONで返します。商品名は「タロット」です。AIによる解釈はなく、意味はカードごとの固定の文章です。

はじめにガイドプレイグラウンド料金

枚数・スプレッド・seed

count か spreadのどちらか一方を送ってください（両方は不可）。 seedを付けると、同じ seed・同じ枚数（またはスプレッド）・同じ逆位置の設定ならいつも同じカードが出ます。付けなければ毎回ランダムです。 lang でカード名・キーワード・意味の言語を選びます。

カード画像

imageUrl と cardBackUrl は、1909年のライダー・ウェイト版の原本（Pamela Colman Smith、パブリックドメイン）をスキャンした幅600pxの WebP 画像です。URLにバージョンが入っているので変わりません。逆位置のカードは画像を180度回転して表示してください。

解釈を得るには

引いたカードを LLM API に入力として渡して自分で解釈を書くか、 tarot を四柱推命解釈API のリクエストに加えて、四柱推命（サジュ）の解釈と一緒に読み解いてください。

リクエスト例

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

認証は X-Partner-Api-Key ヘッダーで行い、ベースURLは 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
  }
}

料金

タロットは1回 ₩20 です（VAT別、VAT込み ₩22）。1枚引いても10枚引いても1回分です。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

一度受け取った結果は保存して再利用してください。 同じリクエストをもう一度送ると、また課金されます。同じ生年月日時と同じオプションならいつも同じ結果なので、最初のレスポンスをデータベースに保存し（例：リクエストボディのハッシュをキーに）、以降は保存した値を無料で使ってください。今日の運勢のように日付で変わる結果は、日付をキーに含め、その日のあいだだけ再利用してください。

料金一覧

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: タロットAPI リファレンス。ほかの四柱推命商品は四柱推命APIすべてにあります。

お問い合わせ: contact@float.do · 運営: FLOAT Co., Ltd.