사주 API 란 무엇인가요?+
사주 API 는 생년월일·출생시간·성별·달력 구분(양력/음력)을 입력하면 사주팔자와 만세력 계산 결과를 JSON 형태로 반환하는 REST API 입니다. SAZU 사주 API 는 합형충파해·격국·용신·대운 등 17개 명리학 분석 모듈을 제공하며, 목적별 토픽 엔드포인트를 한 번 호출하면 그 질문에 필요한 모듈을 함께 받습니다.
운세 API 는 무엇인가요?+
운세 API 는 생년월일·시간·성별을 입력하면 사주팔자, 합형충파해, 격국, 용신, 대운 등 17개 명리학 분석 데이터를 REST 응답으로 돌려주는 개발자용 서비스입니다. 명리 API·명리학 API 로도 부릅니다. SAZU 운세 API 는 명리 계산 평균 50ms 이하의 계산 속도와 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종의 입력에 유료 플랜과 같은 구조의 응답을 돌려주므로 연동·화면·로딩 검증을 그대로 할 수 있고, 임의의 생년월일을 계산하려면 유료 플랜으로 전환합니다.
유료 요금은 얼마부터인가요?+
가장 작은 유료 플랜은 Mini 월 ₩22,000(월 100회 · 분당 15회)입니다. 유료 플랜은 6단계로 Business 월 ₩220,000(월 4,000회)까지 있고, 호출당 단가는 큰 플랜일수록 낮아져 최저 55원까지 내려갑니다. 포함량을 넘긴 호출은 미리 충전한 잔액에서만 차감되어 후불 청구가 없습니다. Mini 플랜은 월간 결제만 가능하고, 그 위 플랜은 연간 결제 시 할인됩니다.
호출량이 적은 서비스도 부담 없이 쓸 수 있나요?+
네. Mini 플랜은 월 ₩22,000에 월 100회가 포함되어, 출시 초기처럼 호출이 적은 서비스도 작은 고정비로 실제 생년월일을 계산할 수 있습니다. 포함량을 넘긴 호출은 미리 충전한 잔액에서만 차감되고 후불 청구가 없어 예상 밖 요금이 나오지 않습니다. 호출이 늘면 대시보드에서 바로 상위 플랜으로 올릴 수 있고, 큰 플랜일수록 호출당 단가가 낮아집니다.
응답 속도는 어느 정도인가요?+
서버 안에서 명리 계산에 걸리는 시간은 평균 50ms 이하입니다. 사주팔자 API 와 만세력 API 호출은 대기열 없이 동기 REST 로 즉시 결과를 받습니다. 명리 계산 시간은 서버 내부 처리 기준입니다. 실제 응답 시간은 사용자의 네트워크 환경과 요청하는 데이터의 종류에 따라 달라집니다.
SAZU 사주 API 는 실제 서비스에서 검증됐나요?+
네. 운세 앱·사주 상담 플랫폼·커머스·데이팅·워드프레스 사이트 등 다수 고객사가 SAZU API·Studio·위젯을 상용 서비스에 연동해 운영 중이며, SAZU 의 자체 운세 서비스·노코드 빌더·설치형 위젯도 같은 명리 엔진 위에서 매일 실사용 트래픽으로 검증됩니다. 안정적인 명리계산 엔진을 통해서 정확한 계산 결과를 빠르게 처리하고, 절기 경계·음력 윤달·진태양시·출생 시간 미상 같은 경계 사례를 정확히 처리합니다. 자체 명리 전문가가 실사용 결과를 계속 검토하며 품질을 개선하고 있습니다.
토픽마다 요금이 따로 있나요?+
없습니다. 유료 플랜에 공개 토픽 13종이 포함됩니다. 토픽별 추가 요금은 없고, 토픽 호출마다 포함량에서 1건 차감됩니다. 포함량을 넘는 호출은 선결제 잔액에서 차감됩니다. 새 토픽을 계속 더하고 있습니다.
AI 에이전트나 SDK 로도 연동할 수 있나요?+
네. SAZU API 는 MCP 서버와 공식 SDK 를 함께 제공하는 개발자 친화적인 사주 API 입니다. MCP 서버(@sazuapp/mcp-server)로 Claude Code·Cursor·Windsurf 같은 AI 에이전트가 사주 API 를 직접 호출할 수 있고(Free 키는 샘플 입력으로 시험), 공식 TypeScript SDK(@sazuapp/client)로는 npm install 후 3줄이면 모든 서버 환경에서 연동됩니다.
사주 풀이 문장(AI 해석)까지 필요하면 어떻게 하나요?+
SAZU API 는 계산된 명리 데이터를 돌려주고, 모든 v2 응답에 AI 참조 안내(data.guide)와 용어 풀이(data.glossary)가 실려 있어 직접 쓰는 LLM 프롬프트에 그대로 넣을 수 있습니다. 풀이 문장 생성까지 맡기려면 같은 명리 엔진 위의 SAZU Studio(https://www.sazu.app/studio)를 쓰면 됩니다 — 프롬프트만 정하면 완성된 운세 풀이를 한 번의 호출로 받고, 유료 플랜은 Mini 월 ₩27,500(100 크레딧)부터입니다. 개발 없이 웹사이트에 붙이려면 설치 코드 한 줄짜리 SAZU 위젯(https://www.sazu.app/widget)이 있습니다.
명리 지식이 깊지 않아도 운세 상품을 만들 수 있나요?+
네. SAZU API 는 "오늘 무엇을 먹으면 좋은가"(명리 식단, POST /v2/sazu/food)처럼 실생활에 바로 접목할 수 있는 목적별 토픽을 13종 제공하고, 토픽이 그 질문에 필요한 분석 모듈을 해석 순서대로 담아 주므로 명리 지식이 깊지 않아도 실용적인 운세 상품을 개발할 수 있습니다. 새 모듈과 토픽은 지금도 계속 추가되고 있으며, 2026년 9월 공개한 명리 식단 토픽은 식품유통 관련 사업자들이 상품 추천에 활용하면서 출시 이후 호출이 빠르게 늘고 있습니다.