← 블로그튜토리얼

사주 API 무료로 시작하는 법 — 5분 연동 가이드

2026. 6. 3.

갱신 (2026-11-03) — 코드 예제를 현행 API(v2) 기준으로 갱신했습니다. 예시 입력은 무료 키로 바로 실행되는 공개 샘플 사주입니다.

무료 사주 API 가 필요한 이유

운세 서비스나 사주 앱을 만들 때 만세력 계산을 직접 구현하면 음양력 변환, 절기, 진태양시 보정, 60갑자 매핑까지 수개월이 걸립니다. 사주 API 를 쓰면 이 모든 계산을 POST 한 번으로 끝낼 수 있습니다.

무료 플랜으로 시작하기

SAZU 는 신용카드 없이 쓸 수 있는 무료 플랜을 제공합니다. 무료 플랜은 연동 테스트용으로, 문서에 공개된 샘플 프로필의 입력에 유료 플랜과 같은 구조의 응답을 돌려줍니다. 연동·화면·로딩을 그대로 검증하실 수 있습니다.

  • 가입 즉시 API 키 발급
  • 샘플 프로필 입력으로 실제와 같은 형식의 응답 확인
  • 임의의 생년월일 계산은 유료 플랜에서 제공

첫 호출 — 5분이면 끝

키를 발급받았다면 다음 한 줄이면 사주팔자가 나옵니다.

curl -X POST https://api.sazu.app/v2/sazu/manse \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "birthYear": 1998, "birthMonth": 5, "birthDay": 19, "birthHour": 10, "isFemale": false }'

JavaScript/TypeScript 환경이라면 fetch 로 동일하게 호출합니다.

const res = await fetch('https://api.sazu.app/v2/sazu/manse', {
  method: 'POST',
  headers: { 'x-api-key': process.env.SAZU_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ birthYear: 1998, birthMonth: 5, birthDay: 19, birthHour: 10, isFemale: false }),
})
const { data } = await res.json()
console.log(data.modules.fourPillars) // 연·월·일·시주

무료 키로는 문서에 공개된 샘플 프로필의 입력만 계산됩니다. 샘플 목록은 GET /v2/sazu/samples 로 받으실 수 있고, 위 예시가 샘플 1 입력입니다. 샘플이 아닌 생년월일을 계산하려면 유료 플랜이 필요합니다.

무료에서 유료로 넘어가는 시점

실계산이 필요하면 유료 플랜으로 전환합니다. 플랜은 포함 건수에 따라 다섯 가지가 있습니다 — 요금 안내. 더 자세한 파라미터는 API 문서를 참고하세요.

SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.

SAZU API를 시작해보세요

신용카드 없이, 무료로 시작할 수 있습니다.

사주 API 무료로 시작하는 법 — 5분 연동 가이드 | SAZU 블로그