운세 API 한 줄 연동, 운세 서비스 즉시 출시
운세 API 는 생년월일과 시간을 보내면 사주팔자·합형충파해·대운·세운 같은 명리학 데이터를 REST 응답으로 돌려줍니다. SAZU 운세 API 를 사용하면 직접 만세력 계산기와 명리학 규칙을 구현하지 않고도 운세 서비스, 챗봇, 모바일 앱을 5분 안에 연동할 수 있습니다.
甲乙丙丁戊己庚辛壬癸子丑寅卯辰巳午未申酉戌亥甲乙丙丁戊己庚辛
같은 물량, 더 낮은 가격 — 사주 API · 만세력 API
사주 · 만세력 · 운세 API
코드 한 줄에 담아
부담 없는 호출 단가에, 성능과 지원은 타협하지 않았습니다 — 평균 100ms 응답 · 분석 모듈 17종 · 한국어 문서와 1:1 문의.
바이브 코딩으로 시작하세요. AI 에게 프롬프트만 던지면, 오늘 바로 만듭니다.
Free 로 붙여보고 유료 플랜으로 바로 출시하세요.
호출당 최저 55원평균 100ms 응답17개 분석 모듈바이브코딩 5분 연동🤖 MCP 지원 (유료)📦 공식 TypeScript SDK
신용카드 불필요 · 무료 500건/월 · 동일 물량 기준 시장가 이하
바이브코딩 가능하다면, 가장 가볍게 시작하는 길
운세 사업, 처음이라면 가장 확실한 시작
작게 시작해 검증하고, 되는 만큼 키우세요. 가격은 가볍게, 품질은 처음부터 끝까지 같습니다.
가벼운 시작 비용
신용카드 없이 무료로 붙여 보고, 매출이 생기면 필요한 만큼 한 칸씩 올리시면 됩니다. 한두 건만 팔아도 구독료를 회수하는 구조입니다.
계산 정확도 99.9%
50년 경력 명리 전문가 감수, 절기·진태양시·음력 변환까지 계산하는 엔진입니다. 저가형 AI 운세와 달리 계산은 엔진이, 문장은 그 계산을 따릅니다.
혼자 두지 않는 지원
한국어 문서, 바로 붙여 쓰는 AI 코딩 프롬프트, 프롬프트 만들기 도구, 1:1 문의 창구까지 출시 전 과정을 함께합니다.
NEW · v2 리딩 API
이제 모듈이 아니라 질문을 고르세요
“연간 운세를 만들려면 어떤 모듈을 켜야 하나” — 그 고민이 사라졌습니다.
목적에 맞는 토픽 하나를 부르면, SAZU 가 자체 운세 상품에 쓰는 구성이 그대로 담겨 옵니다.
질문 단위 토픽 13종
어떤 모듈을 조합할지 고민하지 마세요. 연간 운세는 yearly, 궁합은 compatibility — 엔드포인트 이름이 곧 질문이고, 필요한 모듈 구성은 API 가 정합니다.
핵심만 담은 경량 응답
토픽이 실제로 쓰는 만큼만 담습니다. 해마다 달라지는 계산 결과도 핵심 정보만 요청하면 충분합니다. 응답이 가벼워 전송·파싱이 빠르고, AI 에 넘길 때도 군더더기가 없습니다.
AI 참조 내장 — data.guide개발이 쉬워집니다
모든 응답에 활용 안내가 함께 실립니다. 응답을 AI 코딩 도구에 그대로 넘기면 문서를 열지 않고도 무엇을 어떻게 쓸지 스스로 압니다.
풀이 순서 그대로 담긴 응답
명리 계산 결과가 풀이하는 순서대로 놓입니다. 타고난 사주가 먼저 오고, 그 토픽이 보는 흐름이 뒤따릅니다. 위에서부터 읽으면 그대로 한 편의 풀이가 되고, Free 키로도 전 토픽을 샘플로 테스트할 수 있습니다.
5분 안에 연동 완료
바이브코딩으로 프롬프트 한 줄이면 끝. 직접 코딩도 OK.
// 프롬프트 하나면 끝. AI 에게 이렇게 말하세요:
"이미 운영 중인 내 서비스(웹/앱)에 SAZU 사주 분석을 새 기능으로 통합하고 싶어.
공식 SDK @sazuapp/client 를 사용해서 연동해줘. npm install @sazuapp/client 후 SazuClient 로 호출.
SAZU API 키는 서버 환경변수 SAZU_API_KEY 에 두고 백엔드에서 호출하도록, 기존 인증·라우팅 구조에 맞춰줘.
사용자로부터 이름·생년월일시(출생지는 옵션)를 입력받아 사주 분석 결과를 화면에 보여줘.
사주원국, 오행분포, 신강/신약, 대운을 표로 보여준 후 분석 요약을 그 다음에 순서대로 보여줘.
기존 디자인 시스템·컴포넌트 스타일에 자연스럽게 녹여줘."
// AI 가 SDK 임포트 · 타입 안전 호출 · 자동 재시도 · UI 까지 생성.
// Claude · Codex · Gemini 모두 동일.
// 💡 SDK 사용 시 raw fetch 대비 장점:
// - 자동 재시도·타임아웃 (네트워크 안정성)
// - 완벽한 TypeScript 타입 (IDE 자동완성)
// - 응답 _meta.responseId 자동 추출 (문의 시 활용)
// - 브라우저 환경 가드 (키 노출 방지)
// 더 강력하게 — 유료 플랜이라면 MCP 서버로:
// "npx -y @sazuapp/mcp-server 를 Claude Code 에 MCP 로 등록해줘"↓ 더 정확한 맞춤 프롬프트는 아래에서
한 발 더
위 예시가 막연하신가요? 맞춤 프롬프트를 만들어 드립니다
신규 프로젝트인지, 기존 앱에 추가인지, 노코드 자동화인지에 따라 AI 가 만들 코드가 완전히 달라집니다. 몇 가지 질문에 답하시면 그대로 붙여넣을 수 있는 프롬프트를 만들어 드립니다.
맞춤 프롬프트 빌더
몇 가지 질문에 답하시면 AI 에게 그대로 붙여넣을 프롬프트를 만들어 드립니다
코딩을 잘 모르셔도 괜찮아요. 사용 중인 환경에 맞춰 알려드립니다.
현재 어떤 상황이세요?
가장 가까운 것 하나를 선택해 주세요.
직접 개발이 부담된다면
운영 중인 사이트에 운세 앱을 이식하세요, 재방문 동기를 만드는 콘텐츠가 생깁니다 — SAZU 위젯
개발 자체가 필요 없는 완제품입니다. 설치 코드 한 줄을 내 사이트에 붙여넣으면 방문자가 생년월일을 입력하고 완성된 운세 풀이를 받습니다. 색·테마는 브랜드에 맞춰 클릭으로 조정. 워드프레스·홈페이지에 그대로 씁니다.
AI 추가 구독 없이 운세 서비스를 만드세요, 풀이까지 SAZU 가 맡습니다 — SAZU Studio
raw 데이터를 직접 가공하는 API 대신, 프롬프트만 정의하면 완성된 운세 풀이를 한 번의 호출로 받는 화이트라벨 운세 빌더입니다. 사주 계산·AI 풀이·환각 방지를 SAZU 가 호스팅합니다 — 운세 앱·챗봇을 내 화면에 맞춰 출시하세요.
사주팔자 API 와 만세력 API 를 하나의 엔드포인트로
만세력 API 는 양력·음력 일자에 해당하는 연주·월주·일주·시주를 계산하는 기초 데이터 계층이고, 사주팔자 API 는 그 위에 격국·용신·12운성·12신살·귀인·공망·허자 등 17개 해석 모듈을 더한 분석 계층입니다. SAZU 는 두 계층을 단일 호출로 함께 반환합니다.
왜 SAZU 운세 API 인가
50년 경력의 사주 전문가 감수, 평균 100ms 응답, 호출당 95~55원 의 단가, 신용카드 등록 없이 시작하는 월 500건 무료 플랜. 자체 운세 서비스(sazu.app) 의 프로덕션 트래픽으로 검증된 동일 엔진을 그대로 제공합니다.
< 0ms
평균 응답
0개
분석 모듈
0년
만세력 범위
0회
월 무료 호출
한 번의 호출로 완전한 분석
구식 사주 API는 이제 그만, 단 한 번의 POST 요청으로 빠르고 싸게!
Free 샌드박스 — 전체 모듈 구조를 샘플로 확인
四
사주 원국
천간·지지·십성·12운성·12신살·납음·지장간 — 기둥별 완전 분석
運
대운
10년 단위 대운 흐름, 순행/역행, 시작 나이 자동 계산
行
오행 분포
목화토금수 분포, 천간/지지 별도 집계
要
분석 요약
오행 균형, 조화/갈등, 대운을 점수·등급으로 요약 — 핵심 로직 비노출
强
신강/신약
일간의 강약 판별 — 득령·득지·득세 + 점수(0-100) 상세 분석
유료 플랜 추가
合
합형충파해
천간합, 육합, 삼합, 반합, 방합, 충, 형, 파, 해 — 원국/허자 이중 분석
格
격국 분석
정격 8격 + 외격(종격) + 건록/양인격 판별, 신강/신약 점수화
用
용신 분석
억부용신 + 조후용신(궁통보감) + 5신(용희기구한) 파생
神
신살
귀인 21종, 살 17종, 12신살 — 기둥별 상세 + 해석
虛
허자 분석
삼합공협·도충 허자의 출투, 진허/가허, 순수성, 강도 분석
사기둥 각 주(柱)에 포함되는 상세 데이터
星
십성
비견·겁재·식신·상관·편재·정재·편관·정관·편인·정인
祿
12운성
장생·목욕·관대·건록·제왕·쇠·병·사·묘·절·태·양
殺
12신살
겁살·재살·천살·지살·년살·월살·망신살·장성·반안·역마·육해·화개
音
납음
60갑자 납음오행 — 해중금·노중화·대림목 등 30종
藏
지장간
지지 속 숨은 천간 — 본기·중기·여기 3단계
다른 API에는 없는 것
半
반합 자동 판별
삼합에서 왕지 포함 여부를 분석하여 생지반합/고지반합을 자동 분류. 왕지 없는 조합은 불성립 처리.
雙
원국/허자 이중 분석
허자 적용 전후의 합형충파해를 각각 제공. 허자가 만드는 새로운 충·형·파·해까지 분석.
曆
만세력 데이터 지원
음양력 변환, 절기 기반 월주 판별, 진태양시 보정 — 만세력 앱 개발에 필요한 모든 데이터.
경쟁사 대비 압도적인 우위
| 항목 | SAZU API | 경쟁사 |
|---|---|---|
| 건당 가격 | 무료부터 시작 | 건당 ~1,000원 |
| 응답 속도 | 평균 약 100ms | 500ms 이상 |
| 분석 모듈 | 17개 | 3~5개 |
| 반합/허자 분석 | O | X |
| 격국/용신 | O | X |
| 원국/허자 이중 분석 | O | X |
| 무료 티어 | 500건/월 | 없음 |
| 한국어 API 문서 | 전용 docs + 예시 | 없음 |
| AI 에이전트 직접 연결 (MCP) | 유료 지원 | 없음 |
| 공식 TypeScript SDK | O | X |
API 미리보기
생년월일시를 입력하고 응답 형태를 확인하세요. 실제 분석 결과는 가입 후 대시보드에서 제공됩니다.
응답SAMPLEFree API 결과
// 파라미터를 입력하고
// "샘플 응답 보기"를 클릭하세요
//
// Free 샘플 응답입니다.
// 유료 플랜은 합형충파해, 격국, 용신 등 더 많은 분석을 제공합니다.유료 플랜 모듈 미리보기
종합 평가 가 만드는 풀이의 깊이
유료 플랜의 명리계산 모듈은 5축 정량 스코어 + 성격 키워드·강점·주의점 + 일생 흐름과 올해 전망 + 용신 활용 가이드 를 한 번에 반환합니다. 아래는 1990년 3월 15일 14시 출생 사주의 실제 응답을 그대로 그린 것입니다.
오행 균형
C
보통
47점
화합
B
중간
50점
충돌
B
보통
50점
신살 비율
A
높음
71점
현재 에너지
S
높음
92점
성격 키워드
균형적조화로움유연함편관격
강점
- 예술/철학/종교에 깊은 관심근거: 화개살
- 주변의 물질적 도움과 후원근거: 협록
- 학문적 성취와 지적 능력근거: 천문성
- 예술적 감성과 창작 재능근거: 문곡귀인
주의
- 열정 과잉으로 화를 부를 수 있음근거: 탕화살
- 한 곳에 정착하지 못하고 떠도는 경향근거: 유하살
일생 흐름
최고기
17세
신사 · 제왕
현재
37세 · 계미
관대
편재 — 자존심과 추진력
최저기
87세
무자 · 절
2026년(병오) — 최고 에너지 구간
용신 기운이 강하게 유입되는 해
12운성 건록 (Lv.11)용신 정렬 high
용신
화자기표현, 리더십, 남쪽 방향, 열정적 활동
희신
목교육, 출판, 식물, 동쪽 방향 활용
기신
수음주, 우울, 감정 표류 주의
구신
금지나친 비판, 냉정함 주의
위 결과는 한 번의 API 호출(평균 약 100ms)로 모두 받습니다.
회원님의 서비스 사용자에게도 이 깊이의 진단 을 제공할 수 있습니다
Free 샌드박스의 고정 샘플로는 확인할 수 없는, 실제 사주의 결과입니다. 유료 플랜의 명리계산 모듈은 격국·신살·용신·12운성·대운을 교차 종합해 표준 명리학 진단으로 변환합니다.
한눈에 비교
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% 할인 |
유료 플랜 모듈은 명리학 정통 해석의 핵심입니다. 격국·용신 없이는 사주의 골격·운의 흐름·개운 방향을 판별할 수 없습니다.
합리적인 가격
탄탄한 성능, 동일 물량 기준 더 저렴한 가격. 신용카드 없이 무료로 시작.
구독료는 운세 한 두 건 판매면 회수되고 나머지는 전부 수익이 됩니다.
Free
샌드박스 — 통합·렌더 검증용
무료
500회/월
- ✓전체 모듈 응답 구조 (유료 플랜과 동일)
- ✓문서화된 샘플 프로필 5종
- ✓실제 응답시간 모사
- ✓📦 공식 TypeScript SDK
- ✓커뮤니티 지원
Starter
실계산 시작
₩47,500₩40,000/월16% OFF
연 ₩480,000 일시불 결제 · 1년 자동 갱신
500건 포함 · 분당 30회
호출당 ₩80
- ✓전체 17개 모듈
- ✓합형충파해 상세 분석
- ✓격국 · 용신 · 허자
- ✓🤖 AI 에이전트 직접 연결 (MCP)
- ✓📦 공식 TypeScript SDK
- ✓전용 API 키
- ✓우선 지원
- ✓사용량 대시보드
- ✓초과 시 150원/건
Medium
서비스 오픈 준비
₩69,000₩56,000/월19% OFF
연 ₩672,000 일시불 결제 · 1년 자동 갱신
1,000건 포함 · 분당 45회
호출당 ₩56
- ✓Starter 전체 포함
- ✓월 1,000건 · 분당 45회
- ✓초과 시 120원/건
추천
Standard
프로덕션 서비스
₩130,000₩101,000/월22% OFF
연 ₩1,212,000 일시불 결제 · 1년 자동 갱신
2,000건 포함 · 분당 60회
호출당 ₩50.5
- ✓Medium 전체 포함
- ✓월 2,000건 · 분당 60회
- ✓초과 시 90원/건
Premium
성장하는 서비스
₩180,000₩133,000/월26% OFF
연 ₩1,596,000 일시불 결제 · 1년 자동 갱신
3,000건 포함 · 분당 90회
호출당 ₩44.3
- ✓Standard 전체 포함
- ✓월 3,000건 · 분당 90회
- ✓초과 시 80원/건
Business
대량 트래픽
₩220,000₩154,000/월30% OFF
연 ₩1,848,000 일시불 결제 · 1년 자동 갱신
4,000건 포함 · 분당 120회
호출당 ₩38.5
- ✓Premium 전체 포함
- ✓월 4,000건 · 분당 120회
- ✓초과 시 70원/건
Custom
맞춤 솔루션 · 개발 대행
별도 협의
무제한
- ✓Business 전체 포함
- ✓맞춤 개발 대행 (프로젝트 의뢰)
- ✓SLA 99.9%
- ✓전담 기술 지원
- ✓화이트라벨
제품 비교
어느 방식이 맞을까요
같은 명리계산 결과에서 직접 모두 구현할지, AI 풀이까지 맡길지, 코딩 필요없이 웹페이지에 바로 적용할지에 따라 결정하시면 됩니다.
SAZU API
계산 결과를 직접 받는다
목적
명리 계산 결과를 원본 그대로 받아 내 서비스에 적용합니다. 모든 시스템을 직접 구현할 수 있는 경우에 알맞습니다.
시작 가격
무료
신용카드 없이 시작 · 유료는 월 ₩47,500부터
AI 별도 구독
필요
풀이를 쓰려면 AI 를 직접 구독하고 운영합니다
개발 난이도
높음 · 직접 연동
편리함
낮음 · 직접 구현
기능
- 원국·대운·격국·용신·신살·합형충파해 등 전체 계산 모듈
- 응답 구조 전체 공개 · 원하는 모듈만 선택 호출
- SAZU MCP 및 SDK 활용
- 전용 키 · 사용량 대시보드
추천
명리 해석 로직과 화면을 이미 갖췄거나 직접 설계하려는 개발팀. 결과를 내 방식대로 가공해야 할 경우. 운세 프롬프트와 풀스택 시스템 개발이 가능한 경우.
한계
명리 계산 결과만 받고 나머지는 전부 직접 개발이 필요합니다.
지금 보고 계신 제품
SAZU Studio
내 브랜드 운세를 프롬프트로
목적
명리 계산과 LLM 구독은 SAZU 가 맡고, 회원님은 운세 작성용 프롬프트만 관리하시면 됩니다.
시작 가격
월 ₩49,000부터
플랜별 포함 크레딧 제공 · 초과분은 미리 충전한 선결제 크레딧에서 차감
AI 별도 구독
불필요
풀이 생성까지 요금에 포함됩니다
개발 난이도
보통 · 프롬프트 개발과 서비스 화면 개발 필요
편리함
높음 · LLM 프롬프트만 직접 관리
기능
- 메뉴로 만드는 운세 프롬프트 빌더
- 완성된 풀이를 한 번의 호출로 수신
- 별도 AI 구독·키 관리 불필요
- 저장 전 프롬프트 안전 검토 · 출력 언어 고정
- 운세 출력 결과 오염(외국어 혼입 등) 문제 해결
추천
화면은 직접 만들고 명리 계산과 AI 구독·운영만 맡기되, 프롬프트는 직접 관리하고 싶을 때.
한계
사용자에게 보이는 화면은 직접 제작해야 합니다. 플랜별로 구매자가 몰리는 순간 호출 한도 제한이 있으나 대기 큐 관리로 쉽게 해결할 수 있습니다.
SAZU 위젯
코드 한 줄로 설치
목적
설치 코드 한 줄이면 방문자가 생년월일을 넣고 결과를 받습니다. 입력 폼부터 결과 화면까지 완성본입니다.
시작 가격
무료
설치해 보고 결정 · 유료는 월 ₩23,900부터
AI 별도 구독
불필요
풀이 생성까지 요금에 포함됩니다
개발 난이도
낮음 · 붙여넣기
편리함
매우 높음 · 코드 한 줄로 바로 사용 가능
기능
- 홈페이지·워드프레스에 코드 한 줄로 간편 설치
- 입력 폼 · 결과 화면 · 반응형까지 포함
- 브랜드 색·글꼴 맞춤 · 노출 항목 선택
- 운세별 프롬프트 개인화 · 저장 전 자동 안전 검토
- 설치 현황 · 사용량 대시보드
추천
개발 인력 없이 운영 중인 홈페이지에 운세 기능만 더하려는 곳. 운세로 기존 고객의 체류·재방문율을 늘리고 싶을 때.
한계
정해진 화면 구성 안에서 조정합니다. 지정한 프롬프트는 구독 중인 위젯에만 반영되며, 오늘의 운세는 지정 대상이 아닙니다.
Enterprise
세 제품 공통 · 맞춤 제작
목적
위 세 가지로 닿지 않는 요건을 맞춰 만듭니다. 기획부터 개발까지 의뢰하실 수 있습니다.
시작 가격
협의
규모·기간에 맞춰 산정합니다
AI 별도 구독
협의
구축·운영 범위에 맞춰 계약에서 정합니다
개발 난이도
해당 없음 · 위탁
편리함
매우 높음 · 전 과정 대행
기능
- 전용 기능 개발 · 프로젝트 의뢰
- 화이트라벨 · 전용 인프라
- 대량 트래픽을 고려해 설계된 한도·응답 보장
- 전담 기술 지원 및 운영 위탁 가능
추천
대량 트래픽·보안 요건·독점 조건이 있거나, 내부 개발·운용 인력과 비용을 아끼고 싶은 경우. 안정적인 운세 운영만 위탁하고 싶은 경우.
한계
요건 협의와 제작 기간이 필요합니다. 완성된 맞춤 운세 시스템을 갖게 되지만 초기 개발 비용이 발생합니다.
조직의 역량에 따라 선택하실 수 있습니다. 개발 지식이 없거나 운영이 어려우시면 SAZU 위젯으로 시작하시고, 명리 해석과 AI 운영(구독·관리)이 부담이시면 SAZU Studio를, 개발 인력이 있으시면 SAZU API를 권해 드립니다.
FAQ
자주 묻는 질문
사주 API 란 무엇인가요?
사주 API 는 생년월일·출생시간·성별·달력 구분(양력/음력)을 입력하면 사주팔자와 만세력 계산 결과를 JSON 형태로 반환하는 REST API 입니다. SAZU 사주 API 는 합형충파해·격국·용신·대운 등 17개 명리학 분석 모듈을 제공하며, 목적별 토픽 엔드포인트를 한 번 호출하면 그 질문에 필요한 모듈을 함께 받습니다.
운세 API 는 무엇인가요?
운세 API 는 생년월일·시간·성별을 입력하면 사주팔자, 합형충파해, 격국, 용신, 대운 등 17개 명리학 분석 데이터를 REST 응답으로 돌려주는 개발자용 서비스입니다. SAZU 운세 API 는 평균 100ms 응답과 99.9% 정확도를 제공합니다.
사주팔자 API 와 만세력 API 는 무엇이 다른가요?
만세력 API 는 양력·음력 일자에 해당하는 천간지지(연·월·일·시주) 를 반환하는 기초 데이터 API 이고, 사주팔자 API 는 그 위에 격국·용신·대운·12운성 등 해석 모듈을 더한 분석 API 입니다. SAZU 는 두 기능을 같은 입력 형식의 목적별 토픽 엔드포인트에서 함께 제공합니다 — 만세력 표는 POST /v2/sazu/manse, 해석까지 필요한 질문은 yearly·monthly·compatibility 같은 토픽을 호출합니다.
v2 리딩 API 는 무엇이 다른가요?
v2 리딩 API 는 "연간 운세" "궁합" 같은 질문 단위로 13개의 토픽 엔드포인트(POST /v2/sazu/<topic> — manse·today·daily·monthly·yearly·decade·life·consult·compatibility·love·money·health·food)를 제공하는 SAZU 사주 API 의 현행 버전입니다. 토픽이 목적에 필요한 분석 모듈을 해석 순서대로 담아 주므로 모듈을 직접 고를 필요가 없고, 모든 응답에 AI 참조 안내(data.guide)와 용어 풀이(data.glossary)가 실려 LLM 프롬프트에 그대로 넣을 수 있습니다. 출생 입력 필드는 v1 과 같고, 모듈은 토픽이 정해 담으므로 modules 파라미터는 받지 않습니다.
무료로 사용할 수 있나요?
네, 신용카드 등록 없이 월 500회까지 무료입니다. Free 키는 샌드박스로 동작합니다 — 문서에 공개된 샘플 프로필 5종의 입력에 유료 플랜과 같은 구조의 응답을 돌려주므로 연동·화면·로딩 검증을 그대로 할 수 있고, 임의의 생년월일을 계산하려면 유료 플랜으로 전환합니다.
응답 속도는 어느 정도인가요?
서버 처리 기준 평균 약 100ms 로 응답합니다(네트워크 왕복 시간 제외). 사주팔자 API 와 만세력 API 호출은 동기 REST 로 즉시 결과를 받을 수 있습니다.
SAZU 사주 API 는 실제 서비스에서 검증됐나요?
네. 운세 앱·사주 상담 플랫폼·커머스·데이팅·워드프레스 사이트 등 다수 고객사가 SAZU API·Studio·위젯을 상용 서비스에 연동해 운영 중이며, SAZU 의 자체 운세 서비스·노코드 빌더·설치형 위젯도 같은 명리 엔진 위에서 매일 실사용 트래픽으로 검증됩니다. 계산은 결정론적이라 같은 입력이면 항상 같은 결과를 주고, 절기 경계·음력 윤달·진태양시·출생 시간 미상 같은 경계 사례를 정확히 처리합니다.
AI 에이전트나 SDK 로도 연동할 수 있나요?
MCP 서버(@sazuapp/mcp-server)로 Claude Code·Cursor·Windsurf 같은 AI 에이전트가 사주 API 를 직접 호출할 수 있고(유료 전용), 공식 TypeScript SDK(@sazuapp/client)로는 npm install 후 3줄이면 모든 서버 환경에서 연동됩니다.