사주 API
생년월일시(와 성별·시간대)만 보내면 사주 계산과 풀이가 JSON으로 바로 돌아와요. 운세앱 「인생은 타이밍」과 같은 사주 엔진을 쓰며, 절기 기반 원국과 용신·격국·신강약, 대운·세운, 신살을 고전 명리 규칙대로 계산해요. 키 하나로 모든 상품을 부르고, 호출한 만큼만 원화 크레딧에서 차감돼요.
계산형과 풀이형
- 계산형 — 만세력·자미두수·궁합·점성술 토탈·운 흐름·오늘의 사주·꿈해몽·타로. LLM 없이 규칙으로 계산하므로 같은 입력이면 결과가 같아요. 한 번 받아 DB에 저장해 두고 다시 쓰는 것을 권장해요.
- 풀이형 — 평생 사주(미리 써 둔 주제별 풀이 문단)와 AI 사주 리딩(사주를 계산해 AI가 질문에 맞춰 상담·해석). AI 사주 리딩 안에는 자미두수·점성술·타로·꿈해몽 AI가 함께 들어 있어 통합으로 부르거나 하나만 따로 부를 수 있어요.
엔드포인트
기본 주소는 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 /reading | AI 사주 리딩 | 질문에 맞춘 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 · 운영: 플로트 주식회사