API 문서

SAZU 사주분석 API를 5분 안에 연동하세요.

최종 업데이트:

키 발급

SAZU API 를 사용하시려면 먼저 API 키가 필요합니다. 발급은 무료이며, 5분 안에 끝납니다.

  1. 1

    회원가입·로그인

    이메일로 가입하시면 즉시 API 키 발급이 가능합니다. 신용카드 정보는 필요하지 않습니다.

    회원가입·로그인 →
  2. 2

    대시보드에서 키 발급

    로그인 후 대시보드의 키 발급 버튼을 누르시면 Free 키가 즉시 생성됩니다. 키 이름·만료일을 설정하실 수 있습니다. 허용 도메인(CORS 화이트리스트)은 Pro 키 전용이라 Free 키 목록에는 등록 버튼이 나타나지 않습니다.

    대시보드로 이동 →

    Free 키 형식 예: sazu_free_a1b2c3d4...

  3. 3

    키를 안전하게 보관

    발급 직후 한 번만 전체 키 값이 표시됩니다. 즉시 안전한 곳에 복사·보관해 주세요. 분실 시 새 키를 발급하셔야 합니다.

    서버 환경변수 (예: SAZU_API_KEY) 또는 비밀 저장소 (Vault·1Password·Vercel Env 등) 에 보관하세요.

  4. 4

    유료 키가 필요하다면

    Free 키로는 유료 토픽까지 샘플 프로필 5종의 입력으로 시험하실 수 있습니다 — 유료 플랜과 동일한 17개 모듈 구조를 고정 데이터로 반환하며, 샘플 입력은 GET /v2/sazu/samples 로 받으실 수 있습니다. 월 500회·분당 10회 제한이 적용되며, 실제 생년월일 계산이 필요하시면 유료 플랜을 이용해 주십시오. 격국·용신·합형충파해 등 깊은 명리 분석이 필요하시면 유료 구독 후 대시보드에서 유료 키를 추가 발급하실 수 있습니다.

    유료 키로 샘플 프로필을 호출하면 청구 주기마다 500회까지 호출량에서 차감되지 않습니다(모든 유료 플랜 공통). 유료 계정의 Free 키 호출도 이 횟수에 합산되며, 넘으면 Free 키 호출은 다음 주기까지 거절됩니다. 응답 헤더 X-Sample-Calls-Used · X-Sample-Calls-Limit 로 사용 횟수를 확인하실 수 있습니다.

    유료 플랜 보기 →

⚠ 키는 절대 브라우저·공개 git 저장소에 노출하지 마세요

HTML·JavaScript 클라이언트 코드·GitHub public 저장소·이메일·메신저 첨부 등에 키를 직접 포함하시면 누구나 회원님의 월 호출 한도를 즉시 소진할 수 있습니다. 항상 서버 사이드 (Next.js API route · Vercel Function · Supabase Edge Function 등) 환경변수에만 보관하세요.

한눈에 비교

질문 하나, 토픽 하나. 모든 유료 플랜에 13종 포함

Free 키는 샌드박스로 동작합니다. 전체 응답 구조를 고정 샘플로 확인하고, 실제 생년월일 계산이 필요해지면 유료 플랜으로 전환하세요.

항목Free유료
토픽13종 샘플 시험
문서화된 프로필 5종
13종 전부 포함
토픽별 추가 요금 없음 · 토픽 호출마다 포함량에서 1건 차감
계산고정 샘플실제 생년월일 계산
절기·진태양시·음양력 보정 적용
응답17개 모듈 전체 구조
유료와 같은 응답 형태
17개 모듈을 토픽별로 구성
해석 순서대로 제공 · 기존 필드는 유지하고 추가만
호출 한도월 500회
분당 10회
월 100 ~ 4,000회
분당 15 ~ 120회 · 플랜별 · 포함량을 넘는 호출은 선결제 잔액에서 차감
연동REST · TypeScript SDK · MCP
샘플 입력으로 시험
REST · @sazuapp/client · @sazuapp/mcp-server
Claude Code · Cursor · Windsurf · Codex · Antigravity
배치미지원요청당 20 ~ 300건
여러 사람의 사주·여러 토픽을 한 번의 요청으로 계산 · 플랜별 상한 · 성공한 건수만큼 차감
새 토픽새 토픽 샘플도 계속 더합니다새 토픽을 계속 더하고 있습니다.
현재 목록은 GET /v2/sazu/topics 로 확인
지원커뮤니티 큐우선 응대 (대기열 건너뛰기)
가격무료월 ₩22,000부터
연간 결제 시 최대 30% 할인