안내 (2026-09-16) — 이 글의 코드 예제는 발행 당시 현행이던 v1 기준입니다. v1 은 2026년 9월 16일부터 레거시 버전이며 2027년 9월 30일까지 지원합니다. 새로 가입하시는 계정에서는 v1 을 이용하실 수 없습니다. 새 연동은 목적별 토픽 엔드포인트 POST /v2/sazu/<topic> 로 작성하세요 — 입력 필드와 응답 모듈 키는 v1 과 같고, modules 파라미터만 없습니다. 옮기는 법은 API 문서의 「v1 (레거시) — v2 로 옮기기」에 있습니다.
만세력 계산, 직접 만들면 얼마나 걸릴까
만세력 API 없이 직접 구현하려면 다음을 모두 처리해야 합니다.
- 1900~2100년 음양력 변환 (윤달 포함)
- 24절기 천문 계산 — 월주 경계가 절기로 갈림
- 진태양시 보정 — 출생 도시 경도 차이
- 60갑자·십성·12운성·12신살 매핑
경험상 정확한 만세력 엔진 하나에 숙련 개발자도 3~6개월이 걸립니다.
4가지 기준 비교
개발 기간
직접 구현 3~6개월 vs 만세력 API 연동 5분.
정확도
직접 구현은 절기·진태양시 경계에서 버그가 잦습니다. SAZU 는 다른 만세력 프로그램과 교차 검증을 거쳤습니다.
유지보수
직접 구현은 윤달·절기 데이터를 계속 관리해야 합니다. API 는 호스팅 측이 갱신합니다.
비용
개발자 인건비 vs 호출당 요금(요금 안내). 명리 엔진을 직접 만들고 계속 검증·유지하는 비용과 비교하면 API 가 낫습니다.
직접 구현이 나은 경우
학습 목적이거나, 외부 의존성을 절대 둘 수 없는 폐쇄망이라면 직접 구현이 맞습니다. 그 외 상용 서비스라면 만세력 API 가 합리적입니다.
curl -X POST https://api.sazu.app/v1/sazu/calculate \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "birthYear": 1990, "birthMonth": 3, "birthDay": 15, "birthHour": 14, "isFemale": false }'SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.