안내 (2026-09-16) — 이 글의 코드 예제는 발행 당시 현행이던 v1 기준입니다. v1 은 2026년 9월 16일부터 레거시 버전이며 2027년 9월 30일까지 지원합니다. 새로 가입하시는 계정에서는 v1 을 이용하실 수 없습니다. 새 연동은 목적별 토픽 엔드포인트 POST /v2/sazu/<topic> 로 작성하세요 — 입력 필드와 응답 모듈 키는 v1 과 같고, modules 파라미터만 없습니다. 옮기는 법은 API 문서의 「v1 (레거시) — v2 로 옮기기」에 있습니다.
무료 사주 API 가 필요한 이유
운세 서비스나 사주 앱을 만들 때 만세력 계산을 직접 구현하면 음양력 변환, 절기, 진태양시 보정, 60갑자 매핑까지 수개월이 걸립니다. 사주 API 를 쓰면 이 모든 계산을 POST 한 번으로 끝낼 수 있습니다.
무료 플랜으로 시작하기
SAZU 는 신용카드 없이 쓸 수 있는 무료 플랜을 제공합니다. 무료 플랜은 연동 테스트용으로, 문서에 공개된 샘플 프로필의 입력에 유료 플랜과 같은 구조의 응답을 돌려줍니다. 연동·화면·로딩을 그대로 검증하실 수 있습니다.
- 가입 즉시 API 키 발급
- 샘플 프로필 입력으로 실제와 같은 형식의 응답 확인
- 임의의 생년월일 계산은 유료 플랜에서 제공
첫 호출 — 5분이면 끝
키를 발급받았다면 다음 한 줄이면 사주팔자가 나옵니다.
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 }'JavaScript/TypeScript 환경이라면 fetch 로 동일하게 호출합니다.
const res = await fetch('https://api.sazu.app/v1/sazu/calculate', {
method: 'POST',
headers: { 'x-api-key': process.env.SAZU_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ birthYear: 1990, birthMonth: 3, birthDay: 15, birthHour: 14, isFemale: false }),
})
const { data } = await res.json()
console.log(data.modules.fourPillars) // 연·월·일·시주무료 키로는 문서에 공개된 샘플 프로필의 입력만 계산됩니다. 샘플 목록은 GET /v2/sazu/samples 로 받으실 수 있고, 위 예시처럼 임의의 생년월일을 계산하려면 유료 플랜이 필요합니다.
무료에서 유료로 넘어가는 시점
실계산이 필요하면 유료 플랜으로 전환합니다. 플랜은 포함 건수에 따라 다섯 가지가 있습니다 — 요금 안내. 더 자세한 파라미터는 API 문서를 참고하세요.
SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.