사주 API

생년월일시(와 성별·시간대)만 보내면 사주 계산과 풀이가 JSON으로 바로 돌아와요. 운세앱 「인생은 타이밍」과 같은 사주 엔진을 쓰며, 절기 기반 원국과 용신·격국·신강약, 대운·세운, 신살을 고전 명리 규칙대로 계산해요. 키 하나로 모든 상품을 부르고, 호출한 만큼만 원화 크레딧에서 차감돼요.

시작 가이드 키 없이 시험해 보기 요금표

계산형과 풀이형

엔드포인트

기본 주소는 https://api.hrum.ai/api/v1/partners/v1, 인증은 X-Partner-Api-Key 헤더예요.

경로 (레퍼런스)상품 (소개)돌려주는 것
POST /manseryeok만세력원국 4주, 십신·지장간·12운성·신살, 용신·격국·신강약, 대운·세운, 사주 정체성
POST /ziwei-chart자미두수 명반12궁·주성·보좌성·생년사화·대한·유년 (출생 시각 필요)
POST /compat궁합두 사람의 사주 궁합과 별자리 궁합, 종합 점수, 풀이 문단
POST /astrology점성술 토탈10개 천체·하우스·애스펙트·품위와 미리 써 둔 풀이 문단
POST /saju-flow운 흐름대운·세운·월운 그래프용 숫자와 형충회합 목록
POST /today오늘의 사주오늘 일진과 내 일간의 관계, 좋은 시간·피할 시간
POST /dream꿈해몽꿈 이야기에서 찾은 상징 낱말 (찾은 상징이 없으면 과금 없음)
POST /tarot타로78장 덱에서 뽑은 카드, 정·역방향, 뜻, 카드 이미지 주소
POST /lifetime평생 사주성격·재물·직업·연애·건강·인간관계·조언 7개 주제의 풀이 문단
POST /readingAI 사주 리딩질문에 맞춘 AI 상담·해석 (/reading/memory는 지난 상담을 기억)
POST /reading/report사주 리포트질문 없이 한 번에 섹션별 전체 해석

요청 예시

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: $HRUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":15,"hour":12,"minute":0,"timezone":"Asia/Seoul","gender":"male"}'

응답은 {"success": true, "data": { … }} 형태예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.

가격

선불 크레딧에서 호출한 만큼만 차감해요. 계산형은 호출당 정해진 금액, AI 사주 리딩은 질문과 답의 토큰만 과금하고 사주 계산 결과를 AI에게 넣는 분량은 무료예요. 표시 금액은 부가세 별도입니다.

상품가격
요금표에서 상품별 가격 보기

전체 요금표 · 키 없이도 플레이그라운드에서 IP당 최대 월 5회 시험할 수 있어요. 가입 크레딧 조건은 시작 가이드에 있어요.

자주 묻는 질문

출생 시각을 모르면요?

만세력은 시주와 진태양시만 비우고, 용신·격국·신강약 등은 년·월·일 3주 기준으로 계산해 돌려줘요. 자미두수 명반은 출생 시각이 있어야 해요.

결과를 저장해도 되나요?

네. 계산형과 평생 사주는 같은 입력이면 결과가 같으니 저장해 두고 다시 쓰는 것을 권장해요. 다시 부르지 않으면 과금도 없어요.

만든 앱은 어디에 올리나요?

같은 콘솔의 RIDM Apps 앱 호스팅에 깃흐름으로 코드를 올리면 빌드·배포되고(깃허브도 사용가능), 앱마다 전용 PostgreSQL DB가 붙어요.

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