사주 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에게 넣는 분량은 무료입니다. 표시 금액은 부가세 별도입니다.
| 상품 | 가격 |
|---|---|
| 요금표에서 상품별 가격 보기 | |
전체 요금표 · 가입하면 무료 크레딧이 지급되고, 키 없이도 플레이그라운드에서 월 5회 시험할 수 있습니다.
자주 묻는 질문
출생 시각을 모르면요?
만세력은 시주와 진태양시만 비우고, 용신·격국·신강약 등은 년·월·일 3주 기준으로 계산해 돌려줍니다. 자미두수 명반은 출생 시각이 있어야 합니다.
결과를 저장해도 되나요?
네. 계산형과 평생 사주는 같은 입력이면 결과가 같으니 저장해 두고 다시 쓰는 것을 권장합니다. 다시 부르지 않으면 과금도 없습니다.
만든 앱은 어디에 올리나요?
같은 콘솔의 RIDM Apps 앱 호스팅에 GitHub 저장소를 연결하면 빌드·배포되고, 앱마다 전용 PostgreSQL DB가 붙습니다.
문의: [email protected] · 운영: 플로트 주식회사