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회 제한이 적용되며, 실제 생년월일 계산이 필요하시면 유료 플랜을 이용해 주십시오. 격국·용신·합형충파해 등 깊은 명리 분석이 필요하시면 유료 구독 후 대시보드에서 유료 키를 추가 발급하실 수 있습니다.

    유료 플랜 보기 →

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

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

한눈에 비교

Free vs 유료 플랜

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

💰 누구나 운세 1건만 판매해도 구독 비용 즉시 회수 가능

항목Free유료
데이터고정 샘플
문서화된 프로필 5종
실제 생년월일 계산
절기·진태양시·음양력 보정 적용
월 호출 한도500회500 ~ 4,000회
플랜별
분당 호출10회30 ~ 120회
플랜별
모듈17개 전체 구조
샘플 데이터 · 유료와 동일한 응답 형태
17개 전체
+ 격국·용신·신살·허자·합형충파해·원국상호작용·세운·월률분야·종합평가
AI 에이전트 (MCP)미지원@sazuapp/mcp-server
Claude Code · Cursor · Windsurf · Codex · Antigravity
TypeScript SDK@sazuapp/client@sazuapp/client
키 만료90일만료 없음 (구독 기간)
기술지원커뮤니티 큐우선 응대 (대기열 건너뛰기)
가격무료월 ₩47,500부터
연간 결제 시 최대 30% 할인

유료 플랜 모듈은 명리학 정통 해석의 핵심입니다. 격국·용신 없이는 사주의 골격·운의 흐름·개운 방향을 판별할 수 없습니다.