사주 API › 꿈해몽 API

꿈해몽 API

꿈 이야기를 보내면 HRUM이 직접 만든 꿈 상징 어휘집에서 찾은 상징 낱말을 두드러진 순서로 JSON으로 돌려줘요. 상품 이름은 「꿈해몽」이에요. 어휘집에는 낱말만 있고 해몽 뜻이나 길흉 판단은 없어요. 같은 입력이면 결과가 같아요.

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

돌려주는 것

• 상징 낱말 — 꿈 내용에 그 낱말이나 동의어·활용형이 실제로 나온 것만, 최대 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 }
    ]
  }
}

가격

꿈해몽은 호출 1회에 ₩30(부가세 별도 · 부가세 포함 ₩33)이에요. 찾은 항목이 하나 이상일 때만 과금되고, 결과가 비면 차감하지 않아요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.

전체 요금표

전체 레퍼런스

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

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