사주 API › 타로 API

타로 API

뽑을 카드 수(1~10장)나 스프레드를 정하면 78장 덱(메이저 22 · 마이너 56)에서 겹치지 않게 카드를 뽑아, 카드마다 정·역방향, 키워드, 뜻, 카드 이미지 주소를 JSON으로 돌려줘요. 상품 이름은 「타로」예요. AI 해석은 없고, 뜻은 카드에 정해진 문장 그대로예요.

시작 가이드 플레이그라운드 요금표

카드 수·스프레드·seed

count와 spread 중 하나만 보내요. 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
  }
}

가격

타로는 호출 1회에 ₩20(부가세 별도 · 부가세 포함 ₩22)이에요. 1장을 뽑든 10장을 뽑든 호출당 한 번이에요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.

전체 요금표

전체 레퍼런스

파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 타로 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.

문의: contact@float.do · 운영: 플로트 주식회사