사주 API › 사주 풀이 API

사주 풀이 API

생년월일시와 질문을 보내면 서버가 사주를 계산해 AI에게 넣고, AI가 질문에 맞춘 풀이를 돌려줘요. 상품 이름은 「AI 사주 리딩」이고, 대화를 기억하는 「AI 사주 리딩 · 메모리」와 질문 없이 한 번에 받는 「사주 리포트」가 같은 계열이에요. 내부 프롬프트와 이론은 응답에 담지 않고 해석 결과만 돌려줘요.

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

세 가지 부르는 법

단건 상담 POST /reading — 질문 하나에 풀이 하나를 돌려줘요. 응답은 2,000자까지예요.
이어서 상담 POST /reading/memory — 엔드유저별 대화 기억을 HRUM이 보관하고, 다시 찾아왔을 때 지난 맥락을 이어서 풀이해요.
한 번에 리포트 POST /reading/report — 질문 없이 총평·재물·연애·대운 같은 섹션별 리포트를 한 번에 받아요(최대 12섹션).

함께 넣을 수 있는 항목

자미두수·점성술·꿈해몽·타로 근거를 함께 넣어 풀이하거나, only로 그중 하나만 부를 수 있어요. 오늘 일진은 따로 부르지 않아도 모든 풀이에 반영돼요. 출생 시각(hour)을 생략하면 시주를 빼고 년·월·일 3주 기준으로 해석해요.

요청 예시

단건 상담 (/reading)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "올해 이직해도 괜찮을까요?",
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
    "maxLength": 600,
    "tone": "warm"
  }'

이어서 상담 (/reading/memory)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/memory \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "endUserId": "member-1024",
    "question": "지난번에 얘기한 이직 건, 다음 달에 움직여도 될까요?",
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" }
  }'

한 번에 리포트 (/reading/report)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/report \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
    "sections": ["총평", "재물운", "연애·인연"]
  }'

인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.

응답 예시 (/reading)

{
  "success": true,
  "data": {
    "interpretation": "당신의 사주에서 보이는 특징은...",
    "sajuSource": "computed",
    "usage": {
      "inputTokens": 450,
      "outputTokens": 280
    },
    "costPoints": 18
  }
}

costPoints가 이번 호출의 차감액이에요. 메모리형과 리포트형의 응답 필드는 레퍼런스에 있어요.

가격

AI 사주 리딩은 100만 토큰당 입력 ₩2,888(부가세 별도 · 부가세 포함 ₩3,177), 출력 ₩23,100(부가세 별도 · 부가세 포함 ₩25,410)이에요. AI 사주 리딩 · 메모리는 100만 토큰당 입력 ₩3,754(부가세 별도 · 부가세 포함 ₩4,129), 출력 ₩30,030(부가세 별도 · 부가세 포함 ₩33,033)이에요. 사주 리포트는 토큰 과금이라 1회 금액이 정해져 있지 않아요. 예상 범위는 요금표에서 확인해 주세요. 사주 계산 결과를 AI에게 넣는 분량과 시스템 프롬프트는 과금하지 않고, 질문·persona와 답의 토큰만 과금해요. 함께 넣은 항목이 있으면 그 근거 블록이 입력 토큰에 더해지고, 항목별 고정 요금도 더해져요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.

전체 요금표

전체 레퍼런스

파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: AI 사주 리딩 레퍼런스 · 메모리형 레퍼런스 · 사주 리포트 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.

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