갱신 (2026-11-03) — 코드 예제를 현행 API(v2) 기준으로 갱신했습니다. 예시 입력은 무료 키로 바로 실행되는 공개 샘플 사주입니다.
궁합의 출발점은 두 사주
사주 API 의 궁합 토픽(compatibility)에 두 사람의 생년월일을 함께 보내면, 각자의 사주와 함께 두 사주 사이의 합형충파해·오행 보완을 한 번에 받습니다. 이 재료로 궁합 로직을 구성합니다.
두 사람 계산
const res = await fetch('https://api.sazu.app/v2/sazu/compatibility', {
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,
partners: [{ birthYear: 1993, birthMonth: 11, birthDay: 19, birthHour: 10, isFemale: true, label: '상대' }],
}),
})
const { data } = await res.json()
console.log(data.modules.fourPillars) // 본인 연·월·일·시주
console.log(data.partners[0].modules.fourPillars) // 상대 연·월·일·시주
console.log(data.partners[0].crossRelations) // 본인 일주 × 상대 4주 합형충파해
console.log(data.partners[0].elementComplement) // 오행 보완상대방 생년월일은 partners 배열에 담아 한 번에 보냅니다(최대 3명, 인원수와 무관하게 호출 1건). 본인 사주는 data.modules, 상대 사주는 data.partners[].modules 에 담깁니다. 무료 키로는 두 사람 모두 공개 샘플 프로필(GET /v2/sazu/samples)이어야 하며, 위 예시가 샘플 입력입니다.
궁합 판단에 쓰는 신호
- 합형충파해 — 지지 간 관계. 합이 많으면 친화, 충이 많으면 갈등 신호 (
partners[].crossRelations) - 오행 보완 — 한쪽의 부족한 오행을 상대가 채우는지 (
partners[].elementComplement) - 일간 관계 — 두 일간의 생극 관계 (양쪽
fourPillars.day)
풀이까지 자동으로 받고 싶다면
합형충파해 데이터를 직접 해석하는 대신 완성된 궁합 풀이 문장이 필요하다면 노코드 운세 빌더에서 프롬프트로 정의할 수 있습니다. 모듈별 응답 형태는 API 문서를 확인하세요.
SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.