사주 서비스를 만들 때 시간이 가장 오래 걸리는 곳은 화면이 아니라 계산입니다. 사주의 달은 달력이 아니라 절기로 바뀌고, 음력에는 윤달이 끼며, 같은 시각에 태어나도 출생지의 경도에 따라 시주가 달라집니다. 이 경계를 하나라도 놓치면 그해 초에 태어난 사람 전체의 결과가 어긋나는데, 명리를 모르면 틀렸다는 사실조차 알기 어렵습니다.
SAZU API 는 그 계산을 대신합니다. 여러 사주 API 를 견주고 계신 분께 판단의 기준이 될 세 가지를 정리했습니다 — 호출당 가격, 구현에 드는 수고, 계산의 정확도. 그리고 그것이 지금도 나아지고 있다는 증거로 이번 달의 변화를 덧붙입니다.
하나. 호출당 가격 — 동종 경쟁업체와 비교해 보세요, 저렴한 가격과 정확한 명리계산
SAZU 기술서비스들을 사용하여 운세 상품을 판매할 경우에 월 2~3건만 판매해도 명리계산 비용을 바로 회수 가능하도록 다른 경쟁 업체에 비해서 가격을 낮게 유지하고 있으며, 많은 분들이 정확한 명리계산을 통해 운세 상담을 개발하고 서비스함으로써 명리학의 대중화에 기여하기 위함입니다.
- 플랜이 오를수록 호출당 가격이 내려갑니다. 서비스가 커질수록 한 건의 원가가 가벼워집니다.
- 포함량을 넘겨도 같은 원칙입니다. 초과 호출의 단가 역시 같은 물량의 시장 종량가보다 낮게 두어, 트래픽이 몰리는 달에도 부담이 갑자기 커지지 않습니다.
- 충전과 구독 중 무엇이 나은지 화면이 알려 드립니다. 충전할 금액을 입력하면 상위 플랜과 나란히 견주어, 상위 플랜이 실제로 유리할 때만 권합니다.
- 무료 플랜은 신용카드 없이 바로 시작하실 수 있습니다.
플랜별 금액과 포함량은 요금 안내에 있습니다. 쓰시려는 물량을 정해 두고, 지금 검토 중인 다른 서비스와 같은 물량으로 나란히 놓아 보시길 권합니다.
둘. 구현의 수고 — 운세 하나에 호출 하나
가격표에 드러나지 않는 비용이 개발 시간입니다. SAZU API 는 그 시간을 줄이는 데 가장 많은 공을 들였습니다.
- 운세 하나가 엔드포인트 하나입니다. v2 에서는 오늘의 운세면
/v2/sazu/today처럼, 만드시려는 화면에 맞는 토픽 하나만 부르시면 그 운세에 필요한 명리 계산이 모두 담겨 옵니다. 여러 모듈을 따로 불러 조립할 필요가 없습니다. - 응답이 LLM 에 넘길 준비를 하고 옵니다. 응답의
data.guide에는 이 데이터를 문장으로 풀 때의 지침이,data.glossary에는 응답에 나온 명리 용어의 정의가 함께 실립니다. - 프롬프트를 대시보드에서 만듭니다. 「프롬프트 만들기」에서 토픽·분량·출력 형식을 고르시면, 그 토픽이 실제로 주는 항목만 근거로 쓰는 프롬프트가 완성됩니다. 데이터에 없는 것을 지어내지 않게 하는 규칙이 처음부터 들어 있습니다.
- AI 코딩 도구와 함께 쓰기 좋습니다. 프롬프트 하나를 붙여넣어 HTML 한 파일로 만세력 화면과 오늘의 운세 화면을 만드는 예제를 공개해 두었습니다. 공식 TypeScript SDK 를 제공하고, 유료 플랜에서는 AI 에이전트가 직접 부르는 MCP 서버도 쓰실 수 있습니다.
- 한국어 문서가 v2 를 기준으로 열립니다. 엔드포인트마다 요청·응답 예시가 있고, 출생 도시만 보내면 경도 보정이 적용되는 식으로 경계 처리가 입력 한두 개로 끝납니다.
- 응답이 빠릅니다. 서버 처리 기준 평균 약 100ms 로 응답합니다(네트워크 왕복 시간 제외).
무료 키는 샌드박스로 동작합니다. 문서에 공개된 샘플 프로필을 넣으면 유료 플랜과 같은 구조의 응답이 오므로, 연동과 화면을 먼저 끝까지 만들어 두고 출시할 때 키만 바꾸시면 그대로 동작합니다. 임의의 생년월일을 실시간으로 계산하려면 유료 플랜이 필요합니다.
셋. 계산의 정확도 — 경계에서 갈립니다
사주 계산이 틀리는 곳은 대개 평범한 날이 아니라 경계입니다. SAZU API 는 다음을 모두 계산 안에서 처리합니다.
- 절기 기준 월주 — 달이 바뀌는 시각을 절기로 판정합니다. 입춘 전에 태어난 사람은 전년도 간지를 씁니다.
- 음력 윤달 — 음력 생일이 윤달인지 아닌지를 구분해 양력으로 옮깁니다.
- 진태양시 보정 — 출생지의 경도에 맞춰 시각을 보정해, 시 경계에 태어난 사람의 시주가 흔들리지 않게 합니다.
- 출생 시간을 모르는 경우 — 시각을 지어 넣지 않고, 시주 없이 계산합니다.
그 위에 십성·12운성·12신살·납음·지장간, 합형충파해, 격국과 용신, 대운과 세운까지 이어집니다. 계산은 결정론적이라 같은 입력이면 언제나 같은 결과가 나오고, 응답 필드는 추가만 되어 한 번 만든 연동이 배포 뒤에 깨지지 않습니다.
하나 더 — SAZU 는 명리 계산을 AI 에게 맡기지 않습니다. 간지·십성·신살 같은 판정값은 모두 계산 엔진이 내고, AI 의 몫은 그 값을 문장으로 옮기는 일뿐입니다. 그럴듯한 문장 속에 지어낸 값이 섞이지 않는 이유입니다. SAZU 의 자체 운세 서비스와 Studio·위젯도 같은 엔진 위에서 매일 실제 사용자의 호출로 검증되고 있습니다.
지금도 나아지고 있습니다 — 9월의 변화
좋은 API 는 도입한 날보다 그 뒤가 중요합니다. 이번 달에 더해진 것만 적어도 이렇습니다.
- 9월 12일 — 대시보드에 「프롬프트 만들기」가 생겼습니다.
- 9월 23일 — food 토픽이 열려, 호출 한 번으로 한 달 식단과 장보기 목록까지 받으실 수 있습니다.
무료로 시작하는 순서
- 무료로 가입하고 대시보드에서 키를 발급합니다. 신용카드는 필요 없습니다.
- 문서의 샘플 프로필로 첫 호출을 보내 응답 구조를 확인합니다.
- 「프롬프트 만들기」로 문장을 다듬고, 화면을 끝까지 만들어 둡니다.
- 출시할 때 유료 플랜으로 전환해 키만 바꿉니다.
궁금한 점은 contact@sazu.app 으로 보내 주세요. 도입 검토 단계의 질문도 환영합니다.