안내 (2026-09-16) — 이 글의 코드 예제는 발행 당시 현행이던 v1 기준입니다. v1 은 2026년 9월 16일부터 레거시 버전이며 2027년 9월 30일까지 지원합니다. 새로 가입하시는 계정에서는 v1 을 이용하실 수 없습니다. 새 연동은 목적별 토픽 엔드포인트 POST /v2/sazu/<topic> 로 작성하세요 — 입력 필드와 응답 모듈 키는 v1 과 같고, modules 파라미터만 없습니다. 옮기는 법은 API 문서의 「v1 (레거시) — v2 로 옮기기」에 있습니다.
궁합의 출발점은 두 사주
궁합 API 를 별도로 호출하는 대신, 두 사람의 사주를 각각 사주 API 로 계산한 뒤 비교하는 방식이 유연합니다. 각 사주의 합형충파해·오행 분포를 받아 궁합 로직을 구성합니다.
두 사람 계산
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) // 연·월·일·시주같은 방식으로 상대방 생년월일도 호출합니다. 두 응답의 data.modules 를 비교합니다.
궁합 판단에 쓰는 신호
- 합형충파해 — 지지 간 관계. 합이 많으면 친화, 충이 많으면 갈등 신호
- 오행 보완 — 한쪽의 부족한 오행을 상대가 채우는지
- 일간 관계 — 두 일간의 생극 관계
풀이까지 자동으로 받고 싶다면
합형충파해 데이터를 직접 해석하는 대신 완성된 궁합 풀이 문장이 필요하다면 노코드 운세 빌더에서 프롬프트로 정의할 수 있습니다. 모듈별 응답 형태는 API 문서를 확인하세요.
SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.