API 문서
SAZU 사주분석 API를 5분 안에 연동하세요.
키 발급
SAZU API 를 사용하시려면 먼저 API 키가 필요합니다. 발급은 무료이며, 5분 안에 끝납니다.
- 1
- 2
대시보드에서 키 발급
로그인 후 대시보드의 키 발급 버튼을 누르시면 Free 키가 즉시 생성됩니다. 키 이름·만료일·허용 도메인을 설정하실 수 있습니다.
대시보드로 이동 →Free 키 형식 예:
sazu_free_a1b2c3d4... - 3
키를 안전하게 보관
발급 직후 한 번만 전체 키 값이 표시됩니다. 즉시 안전한 곳에 복사·보관해 주세요. 분실 시 새 키를 발급하셔야 합니다.
서버 환경변수 (예:
SAZU_API_KEY) 또는 비밀 저장소 (Vault·1Password·Vercel Env 등) 에 보관하세요. - 4
Pro 키가 필요하다면
Free 플랜은 월 500회·분당 10회 호출 제한이며 5개 모듈만 사용 가능합니다. 격국·용신·합형충파해 등 깊은 명리 분석이 필요하시면 Pro 구독 후
Pro 플랜 보기 →sazu_pro_*키를 추가 발급하실 수 있습니다.
⚠ 키는 절대 브라우저·공개 git 저장소에 노출하지 마세요
HTML·JavaScript 클라이언트 코드·GitHub public 저장소·이메일·메신저 첨부 등에 키를 직접 포함하시면 누구나 고객님의 월 호출 한도를 즉시 소진할 수 있습니다. 항상 서버 사이드 (Next.js API route · Vercel Function · Supabase Edge Function 등) 환경변수에만 보관하세요.
한눈에 비교
Free vs Pro
Free 플랜으로 시작 가능합니다. 정확한 사주 해석 (격국·용신·합형충파해 등) 이 필요하면 Pro 로 전환하세요.
💰 누구나 운세 1건만 판매해도 Pro 비용 즉시 회수 가능
| 항목 | Free | Pro |
|---|---|---|
| 월 호출 한도 | 500회 | 10,000회 (20배) |
| 분당 호출 | 10회 | 300회 (30배) |
| 모듈 | 5개 사주원국·대운·오행·요약·신강 | 14개 전체 + 격국·용신·신살·허자·합형충파해·원국상호작용·세운·월률분야·종합평가 |
| AI 에이전트 (MCP) | 미지원 | @sazuapp/mcp-server Claude Code · Cursor · Windsurf · Codex · Antigravity |
| TypeScript SDK | @sazuapp/client | @sazuapp/client |
| 키 만료 | 90일 | 만료 없음 (구독 기간) |
| 기술지원 | 커뮤니티 큐 | 우선 응대 (대기열 건너뛰기) |
| 가격 | 무료 | 월 ₩29,900 · 연 ₩23,900/월 환산 |
Pro 모듈은 명리학 정통 해석의 핵심입니다. 격국·용신 없이는 사주의 골격·운의 흐름·개운 방향을 판별할 수 없습니다.