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개

사주 원국·대운·오행 분포·분석 요약·신강/신약은 무료 플랜에서, 나머지는 유료 플랜에서 받습니다.

명리 전문가와 개발 전문가가 함께 만든 엔진

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부터)을 씁니다.

함께 보기