甲乙丙丁戊己庚辛壬癸子丑寅卯辰巳午未申酉戌亥甲乙丙丁戊己庚辛

같은 물량, 더 낮은 가격 — 운세 개발에 필요한 모든 데이터를 단일 플랜에서

사주 · 만세력 · 운세 API

코드 한 줄에 담아

부담 없는 호출 단가에, 성능과 지원은 타협하지 않았습니다
명리 계산 평균 50ms 이하 · 분석 모듈 17종 · 한국어 문서와 1:1 문의.

바이브 코딩으로, 프롬프트 하나면 오늘 바로 만듭니다.
Free 로 붙여보고 유료 플랜으로 바로 출시하세요.

호출당 최저 55원명리 계산 평균 50ms 이하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 서버로 (Free 키는 샘플 입력으로 시험):
// "npx -y @sazuapp/mcp-server 를 Claude Code 에 MCP 로 등록해줘"

↓ 더 정확한 맞춤 프롬프트는 아래에서

한 발 더

위 예시가 막연하신가요? 맞춤 프롬프트를 만들어 드립니다

신규 프로젝트인지, 기존 앱에 추가인지, 노코드 자동화인지에 따라 AI 가 만들 코드가 완전히 달라집니다. 몇 가지 질문에 답하시면 그대로 붙여넣을 수 있는 프롬프트를 만들어 드립니다.

맞춤 프롬프트 빌더

몇 가지 질문에 답하시면 AI 에게 그대로 붙여넣을 프롬프트를 만들어 드립니다

코딩을 잘 모르셔도 괜찮아요. 사용 중인 환경에 맞춰 알려드립니다.

현재 어떤 상황이세요?

가장 가까운 것 하나를 선택해 주세요.

직접 개발이 부담된다면

운영 중인 사이트에 운세 앱을 이식하세요, 재방문 동기를 만드는 콘텐츠가 생깁니다 — SAZU 위젯

개발 자체가 필요 없는 완제품입니다. 설치 코드 한 줄을 내 사이트에 붙여넣으면 방문자가 생년월일을 입력하고 완성된 운세 풀이를 받습니다. 색·테마는 브랜드에 맞춰 클릭으로 조정. 워드프레스·홈페이지에 그대로 씁니다.

AI 추가 구독 없이 운세 서비스를 만드세요, 풀이까지 SAZU 가 맡습니다 — SAZU Studio

raw 데이터를 직접 가공하는 API 대신, 프롬프트만 정의하면 완성된 운세 풀이를 한 번의 호출로 받는 화이트라벨 운세 빌더입니다. 사주 계산·AI 풀이·환각 방지를 SAZU 가 호스팅합니다 — 운세 앱·챗봇을 내 화면에 맞춰 출시하세요.

< 50ms
명리 계산 평균
17개
분석 모듈
200년
만세력 범위
500회
월 무료 호출

* 명리 계산 시간은 서버 내부 처리 기준입니다. 실제 응답 시간은 사용자의 네트워크 환경과 요청하는 데이터의 종류에 따라 달라집니다.

한 번의 호출로 완전한 분석

구식 사주 API는 이제 그만, 단 한 번의 POST 요청으로 빠르고 싸게!

Free 샌드박스 — 전체 모듈 구조를 샘플로 확인

四

사주 원국

천간·지지·십성·12운성·12신살·납음·지장간 — 기둥별 완전 분석

運

대운

10년 단위 대운 흐름, 순행/역행, 시작 나이 자동 계산

行

오행 분포

목화토금수 분포, 천간/지지 별도 집계

要

분석 요약

오행 균형·조화와 갈등·대운 흐름을 한눈에 읽는 요약

强

신강/신약

일간의 강약을 판별해 등급과 함께 제공

유료 플랜 추가

合

합형충파해

천간합, 육합, 삼합, 반합, 방합, 충, 형, 파, 해 — 원국/허자 이중 분석

格

격국 분석

정격·외격을 아우르는 격국 판별과 성립 여부

用

용신 분석

용신과 희신·기신 등 5신을 풀이 순서대로 제공

神

신살

귀인 21종, 살 17종, 12신살 — 기둥별 상세 + 해석

虛

허자 분석

원국에 드러나지 않은 허자를 찾아 그 작용까지 분석

사기둥 각 주(柱)에 포함되는 상세 데이터

星

십성

비견·겁재·식신·상관·편재·정재·편관·정관·편인·정인

祿

12운성

장생·목욕·관대·건록·제왕·쇠·병·사·묘·절·태·양

殺

12신살

겁살·재살·천살·지살·년살·월살·망신살·장성·반안·역마·육해·화개

音

납음

60갑자 납음오행 — 해중금·노중화·대림목 등 30종

藏

지장간

지지 속 숨은 천간 — 본기·중기·여기 3단계

다른 API에는 없는 것

半

반합 자동 판별

반합을 자동으로 구분해, 실제로 작용하는 합만 결과에 담습니다.

雙

원국/허자 이중 분석

허자 적용 전후의 합형충파해를 각각 제공. 허자가 만드는 새로운 충·형·파·해까지 분석.

曆

만세력 데이터 지원

음양력 변환, 월주 판별, 진태양시 보정 — 만세력 앱 개발에 필요한 모든 데이터.

SAZU API 가 다른 점

가입부터 출시까지 기다림이 없습니다. 직접 확인할 수 있는 사실만 적었습니다.

鍵

승인을 기다리지 않습니다

가입하면 바로 무료 키가 발급됩니다. 문서의 샘플 프로필로 첫 호출까지 몇 분이면 됩니다.

全

모든 데이터를 단일 플랜에서

운세 개발에 필요한 분석 모듈 17개와 질문 토픽 13종을 한 플랜에서 모두 제공합니다. 모듈을 따로 사지 않습니다.

始

결제하면 바로 운영합니다

유료로 전환하는 즉시 실제 생년월일 계산이 열립니다. 별도 계약이나 대기 없이 오늘 출시할 수 있습니다.

定

같은 입력이면 항상 같은 결과

결정론적 계산이라 캐시하고 검증하기 쉽습니다. 음력 윤달·출생 시간 미상 같은 경계 사례도 정확히 처리합니다.

速

명리 계산 평균 50ms 이하

대기열 없는 동기 응답으로 받은 결과를 바로 화면에 그립니다.

連

AI 에이전트에 바로 연결

한국어 문서와 MCP 서버·공식 TypeScript SDK 로 Claude Code·Cursor 같은 AI 코딩 도구에서 바로 호출합니다.

  1. 1. 가입 즉시 무료 키
  2. 2. 샘플 프로필로 첫 호출
  3. 3. 결제 즉시 실제 계산·출시
SAZU API 한눈에 보기
시작가입 즉시 무료 키 발급(승인 대기 없음)
제공 범위분석 모듈 17개 · 질문 토픽 13종을 단일 플랜에서 모두
가격 기준모든 데이터 포함 동일 물량 기준 시장가 이하
유료 전환결제 즉시 실제 생년월일 계산
계산 속도명리 계산 평균 50ms 이하
결과 일관성같은 입력이면 항상 같은 결과(결정론적 계산)
연동 도구한국어 문서 · MCP 서버 · 공식 TypeScript SDK

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 호출(명리 계산 평균 50ms 이하)로 모두 받습니다.

회원님의 서비스 사용자에게도 이 깊이의 진단 을 제공할 수 있습니다

Free 샌드박스의 고정 샘플로는 확인할 수 없는, 실제 사주의 결과입니다. 유료 플랜의 명리계산 모듈은 격국·신살·용신·12운성·대운을 교차 종합해 표준 명리학 진단으로 변환합니다.

한눈에 비교

질문 하나, 토픽 하나. 모든 유료 플랜에 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% 할인

합리적인 가격

탄탄한 성능, 동일 물량 기준 더 저렴한 가격. 신용카드 없이 무료로 시작.

구독료는 운세 한 두 건 판매면 회수되고 나머지는 전부 수익이 됩니다.

Free

샌드박스 — 통합·렌더 검증용

무료
500회/월
  • ✓전체 모듈 응답 구조 (유료 플랜과 동일)
  • ✓문서화된 샘플 프로필 5종
  • ✓실제 응답시간 모사
  • ✓📦 공식 TypeScript SDK
  • ✓커뮤니티 지원

Mini

가볍게 실서비스 시작

₩22,000/월
100건 포함 · 분당 15회
호출당 ₩220
  • ✓개발용 샘플호출 500건 무료
  • ✓전체 17개 모듈
  • ✓합형충파해 상세 분석
  • ✓격국 · 용신 · 허자
  • ✓🤖 AI 에이전트 직접 연결 (MCP)
  • ✓📦 공식 TypeScript SDK
  • ✓전용 API 키
  • ✓우선 지원
  • ✓사용량 대시보드
  • ✓초과 시 250원/건

Starter

안정적인 소규모 운영

₩47,500/월
500건 포함 · 분당 30회
호출당 ₩95
  • ✓모든 Mini 제공 포함
  • ✓월 500건 · 분당 30회
  • ✓초과 시 150원/건

Medium

운영 규모 확장

₩69,000/월
1,000건 포함 · 분당 45회
호출당 ₩69
  • ✓모든 Mini 제공 포함
  • ✓월 1,000건 · 분당 45회
  • ✓초과 시 120원/건
추천

Standard

매일 찾는 서비스 운영

₩130,000/월
2,000건 포함 · 분당 60회
호출당 ₩65
  • ✓모든 Mini 제공 포함
  • ✓월 2,000건 · 분당 60회
  • ✓초과 시 90원/건

Premium

성장하는 서비스

₩180,000/월
3,000건 포함 · 분당 90회
호출당 ₩60
  • ✓모든 Mini 제공 포함
  • ✓월 3,000건 · 분당 90회
  • ✓초과 시 80원/건

Business

대량 트래픽

₩220,000/월
4,000건 포함 · 분당 120회
호출당 ₩55
  • ✓모든 Mini 제공 포함
  • ✓월 4,000건 · 분당 120회
  • ✓초과 시 70원/건

Custom

맞춤 솔루션 · 개발 대행

별도 협의
무제한
  • ✓Business 전체 포함
  • ✓맞춤 개발 대행 (프로젝트 의뢰)
  • ✓SLA 99.9%
  • ✓전담 기술 지원
  • ✓화이트라벨

제품 비교

어느 방식이 맞을까요

같은 명리계산 결과에서 직접 모두 구현할지, AI 풀이까지 맡길지, 코딩 필요없이 웹페이지에 바로 적용할지에 따라 결정하시면 됩니다.

SAZU API

계산 결과를 직접 받는다

목적

명리 계산 결과를 원본 그대로 받아 내 서비스에 적용합니다. 모든 시스템을 직접 구현할 수 있는 경우에 알맞습니다.

시작 가격

무료

신용카드 없이 시작 · 유료는 월 ₩22,000부터

AI 별도 구독

필요

풀이를 쓰려면 AI 를 직접 구독하고 운영합니다

개발 난이도

높음 · 직접 연동

편리함

낮음 · 직접 구현

기능

  • 원국·대운·격국·용신·신살·합형충파해 등 전체 계산 모듈
  • 응답 구조 전체 공개 · 원하는 모듈만 선택 호출
  • SAZU MCP 및 SDK 활용
  • 전용 키 · 사용량 대시보드

추천

명리 해석 로직과 화면을 이미 갖췄거나 직접 설계하려는 개발팀. 결과를 내 방식대로 가공해야 할 경우. 운세 프롬프트와 풀스택 시스템 개발이 가능한 경우.

한계

명리 계산 결과만 받고 나머지는 전부 직접 개발이 필요합니다.

지금 보고 계신 제품

SAZU Studio

내 브랜드 운세를 프롬프트로

목적

명리 계산과 LLM 구독은 SAZU 가 맡고, 회원님은 운세 작성용 프롬프트만 관리하시면 됩니다.

시작 가격

월 ₩27,500부터

플랜별 포함 크레딧 제공 · 초과분은 미리 충전한 선결제 크레딧에서 차감

AI 별도 구독

불필요

풀이 생성까지 요금에 포함됩니다

개발 난이도

보통 · 프롬프트 개발과 서비스 화면 개발 필요

편리함

높음 · LLM 프롬프트만 직접 관리

기능

  • 메뉴로 만드는 운세 프롬프트 빌더
  • 완성된 풀이를 한 번의 호출로 수신
  • 별도 AI 구독·키 관리 불필요
  • 저장 전 프롬프트 안전 검토 · 출력 언어 고정
  • 운세 출력 결과 오염(외국어 혼입 등) 문제 해결

추천

화면은 직접 만들고 명리 계산과 AI 구독·운영만 맡기되, 프롬프트는 직접 관리하고 싶을 때.

한계

사용자에게 보이는 화면은 직접 제작해야 합니다. 플랜별로 구매자가 몰리는 순간 호출 한도 제한이 있으나 대기 큐 관리로 쉽게 해결할 수 있습니다.

SAZU 위젯

코드 한 줄로 설치

목적

설치 코드 한 줄이면 방문자가 생년월일을 넣고 결과를 받습니다. 입력 폼부터 결과 화면까지 완성본입니다.

시작 가격

무료

설치해 보고 결정 · 유료는 월 ₩23,900부터

AI 별도 구독

불필요

풀이 생성까지 요금에 포함됩니다

개발 난이도

낮음 · 붙여넣기

편리함

매우 높음 · 코드 한 줄로 바로 사용 가능

기능

  • 홈페이지·워드프레스에 코드 한 줄로 간편 설치
  • 입력 폼 · 결과 화면 · 반응형까지 포함
  • 브랜드 색·글꼴 맞춤 · 노출 항목 선택
  • 운세별 프롬프트 개인화 · 저장 전 자동 안전 검토
  • 설치 현황 · 사용량 대시보드

추천

개발 인력 없이 운영 중인 홈페이지에 운세 기능만 더하려는 곳. 운세로 기존 고객의 체류·재방문율을 늘리고 싶을 때.

한계

정해진 화면 구성 안에서 조정합니다. 지정한 프롬프트는 구독 중인 위젯에만 반영되며, 오늘의 운세는 지정 대상이 아닙니다.

Enterprise

세 제품 공통 · 맞춤 제작

목적

위 세 가지로 닿지 않는 요건을 맞춰 만듭니다. 기획부터 개발까지 의뢰하실 수 있습니다.

시작 가격

협의

규모·기간에 맞춰 산정합니다

AI 별도 구독

협의

구축·운영 범위에 맞춰 계약에서 정합니다

개발 난이도

해당 없음 · 위탁

편리함

매우 높음 · 전 과정 대행

기능

  • 전용 기능 개발 · 프로젝트 의뢰
  • 화이트라벨 · 전용 인프라
  • 대량 트래픽을 고려해 설계된 한도·응답 보장
  • 전담 기술 지원 및 운영 위탁 가능

추천

대량 트래픽·보안 요건·독점 조건이 있거나, 내부 개발·운용 인력과 비용을 아끼고 싶은 경우. 안정적인 운세 운영만 위탁하고 싶은 경우.

한계

요건 협의와 제작 기간이 필요합니다. 완성된 맞춤 운세 시스템을 갖게 되지만 초기 개발 비용이 발생합니다.

조직의 역량에 따라 선택하실 수 있습니다. 개발 지식이 없거나 운영이 어려우시면 SAZU 위젯으로 시작하시고, 명리 해석과 AI 운영(구독·관리)이 부담이시면 SAZU Studio를, 개발 인력이 있으시면 SAZU API를 권해 드립니다.

운세 API 한 줄 연동, 운세 서비스 즉시 출시

운세 API 는 생년월일과 시간을 보내면 사주팔자·합형충파해·대운·세운 같은 명리학 데이터를 REST 응답으로 돌려줍니다. SAZU 운세 API 를 사용하면 직접 만세력 계산기와 명리학 규칙을 구현하지 않고도 운세 서비스, 챗봇, 모바일 앱을 5분 안에 연동할 수 있습니다.

사주팔자 API 와 만세력 API 를 하나의 엔드포인트로

만세력 API 는 양력·음력 일자에 해당하는 연주·월주·일주·시주를 계산하는 기초 데이터 계층이고, 사주팔자 API 는 그 위에 격국·용신·12운성·12신살·귀인·공망·허자 등 17개 해석 모듈을 더한 분석 계층입니다. SAZU 는 두 계층을 단일 호출로 함께 반환합니다.

왜 SAZU 운세 API 인가

50년 경력의 사주 전문가 감수, 명리 계산 평균 50ms 이하, 호출당 최저 55원의 단가, 신용카드 등록 없이 시작하는 월 500건 무료 플랜. 자체 운세 서비스(sazu.app) 의 프로덕션 트래픽으로 검증된 동일 엔진을 그대로 제공합니다.

검색어별 안내: 운세 API · 명리 API

FAQ

자주 묻는 질문

사주 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월 공개한 명리 식단 토픽은 식품유통 관련 사업자들이 상품 추천에 활용하면서 출시 이후 호출이 빠르게 늘고 있습니다.