SAZU 명리 API
명리 API
명리학 이론을 직접 구현하지 않아도 됩니다 — 원국부터 격국·용신까지, 분석 모듈을 JSON 으로 받습니다.
명리 API 란?
명리 API 는 생년월일·출생시간·성별·달력 구분을 보내면 사주 원국(연주·월주·일주·시주)과 그 위의 명리학 해석 데이터 — 십성, 12운성, 신살, 합형충파해, 신강신약, 격국, 용신, 대운·세운 — 를 JSON 으로 돌려주는 REST API 입니다. 명리학 API 라고도 부릅니다. SAZU 명리 API 는 이 분석을 17개 모듈로 나눠 제공합니다.
명리 API 규격 한눈에 보기
- 방식
- REST API · HTTPS · JSON 응답
- 기준 주소
- https://api.sazu.app
- 인증
- x-api-key 헤더에 API 키
- 무료 사용
- 월 500건, 신용카드 불필요(샘플 사주)
- 분당 호출
- Free 분당 10회 · 유료 플랜 분당 최대 120회
- 호출 단가
- 호출당 최저 55원
- 계산 속도
- 명리 계산 평균 50ms 이하
- 입력
- 생년월일 · 출생시간 · 성별 · 양력/음력(윤달) · 진태양시 · 출생 시간 미상
- 연동 도구
- TypeScript SDK @sazuapp/client · MCP 서버 @sazuapp/mcp-server · OpenAPI 3.1
명리 분석 모듈 17개
사주 원국·대운·오행 분포·분석 요약·신강/신약은 무료 플랜에서, 나머지는 유료 플랜에서 받습니다.
사주 원국
무료 플랜천간·지지·십성·12운성·12신살·납음·지장간 포함
자세히 보기 →대운
무료 플랜10년 단위 대운 흐름, 순행/역행, 시작 나이
자세히 보기 →오행 분포
무료 플랜목화토금수 분포, 천간/지지 별도 집계
자세히 보기 →분석 요약
무료 플랜오행 균형·조화와 갈등·대운 흐름을 한눈에 읽는 요약
자세히 보기 →신강/신약
무료 플랜일간의 강약 판별과 등급, 상세 분석
자세히 보기 →신살
유료 플랜귀인 21종, 살 17종, 12신살 — 기둥별 상세 + 해석
자세히 보기 →합형충파해
유료 플랜원국(허자 미적용) + 허자 포함 이중 분석. 삼합/반합 자동 분류
자세히 보기 →허자 분석
유료 플랜원국에 드러나지 않은 허자를 찾아 그 작용까지 분석
자세히 보기 →격국 분석
유료 플랜정격·외격을 아우르는 격국 판별과 성립 여부
자세히 보기 →용신 분석
유료 플랜용신과 희신·기신 등 5신을 풀이 순서대로 제공
자세히 보기 →월률분야
유료 플랜태어난 달의 지장간 사령(司令) — 단순 월 운세가 아닌 명리학 정통 분석 데이터
자세히 보기 →세운
유료 플랜과거/현재/미래 년운 + 합형충파해 관계 + 12운성
자세히 보기 →원국 상호작용
유료 플랜4기둥 간 합형충파해 + 인접/격각 구분
자세히 보기 →일진 상호작용
유료 플랜특정 날짜 일진이 원국에 미치는 작용 — 일진 신살, 4기둥과의 합형충파해, 오행 변화
자세히 보기 →재물운 분석
유료 플랜재성 분포(암장 포함)·재고(財庫)귀인·재물 감당력 — 대운·세운·월운·일운 계층별 재물 기운
자세히 보기 →건강 균형 분석
유료 플랜신강신약과 오행 과다·극·충을 바탕으로 한 건강 변화 신호 + 운 작용 진단 — 의료 조언 아님
자세히 보기 →종합 사주 평가
유료 플랜스코어카드·성격·인생흐름·년운·용신가이드 — 전체 모듈 교차 종합
자세히 보기 →
명리 전문가와 개발 전문가가 함께 만든 엔진
SAZU 는 명리 전문가와 개발 전문가가 한 팀을 이루는 명리 개발 전문업체입니다. 판정 하나하나를 명리 전문가가 검토하고, 같은 입력에는 언제나 같은 결과가 나오도록 만들었습니다.
음력 윤달, 진태양시, 출생 시간을 모르는 경우까지 계산합니다. SAZU 가 직접 운영하는 운세 서비스·만세력과 같은 엔진입니다.
명리 용어 그대로, 풀이까지 이어서
응답에는 용어 풀이(data.glossary)와 AI 참조 안내(data.guide)가 함께 실립니다. 명리 지식이 깊지 않은 개발자도 응답을 AI 에 넣어 풀이 문장을 만들 수 있고, 명리 상담가는 원국 표와 관계도를 그리는 재료로 씁니다.
오행의 개수는 명리 해석의 극히 일부일 뿐입니다. SAZU 명리 API 는 글자 사이의 작용과 격국·용신까지 함께 돌려주어, 개수만으로 사주를 단정하지 않게 합니다.
명리 API 자주 묻는 질문
명리 API 란 무엇인가요?
명리 API 는 생년월일·출생시간·성별·달력 구분을 보내면 사주 원국(연주·월주·일주·시주)과 그 위의 명리학 해석 데이터 — 십성, 12운성, 신살, 합형충파해, 신강신약, 격국, 용신, 대운·세운 — 를 JSON 으로 돌려주는 REST API 입니다. 명리학 API 라고도 부릅니다. SAZU 명리 API 는 이 분석을 17개 모듈로 나눠 제공합니다.
명리학 API 와 사주 API 는 같은 것인가요?
같은 대상을 부르는 다른 이름입니다. 사주 API 가 입력(사주팔자)을 기준으로 한 이름이라면, 명리 API·명리학 API 는 그 사주를 해석하는 이론(명리학)을 기준으로 한 이름입니다. SAZU 에서는 하나의 키로 같은 엔진을 호출합니다.
어떤 명리 이론까지 다루나요?
사주 원국·대운·오행 분포·분석 요약·신강/신약은 무료 플랜에서, 신살·합형충파해·허자·격국·용신·세운 등은 유료 플랜에서 받습니다. 모듈 17개 전체 목록은 이 페이지와 API 문서에 있습니다.
같은 사주를 다시 보내면 결과가 같나요?
네. 같은 생년월일·출생시간·성별·달력 구분이면 언제나 같은 결과를 돌려줍니다. 응답에 캐시를 붙여도 결과가 어긋나지 않습니다.
명리 API 는 무료로 써 볼 수 있나요?
신용카드 없이 Free 키로 월 500건까지 무료로 호출할 수 있습니다. Free 키는 샘플 사주로 응답 구조를 확인하는 용도이고, 실제 고객의 사주로 서비스하려면 유료 플랜(월 ₩22,000부터)을 씁니다.