운세 콘텐츠
콘텐츠·리텐션
홈 피드·푸시·위젯에 활용하는 만세력 Lite·오늘운세·띠별운세 등 콘텐츠를 제공합니다.
제공 결과 비교만세력·운세 API
앱과 웹에서 필요한 만세력 계산, 운세 콘텐츠와 해설 결과를 API로 제공합니다. 제품별 결과 범위와 응답 방식을 확인하고 기존 회원·결제·결과 화면에 맞춰 도입을 검토하세요.
요금과 이용 조건 확인신규 유료 이용 요금은 2026년 12월 1일부터 적용할 예정입니다. 신규 고객은 지금 v5.0 기준의 승인형 Sandbox를 신청·이용할 수 있습니다. 신규 정식 유료 가입은 2026년 12월 1일 전까지 대기(Hold) 상태입니다. 이 페이지는 한국어 표준 응답 기준의 신규 조건을 안내합니다. 기존 v2.7 요금제의 신규 가입은 종료했으며, 기존 고객은 현재 계약과 별도 전환 안내를 따릅니다.
현재 Sandbox에는 v5.0 상품 범위와 테스트 조건을 적용합니다. 승인된 키 범위에서만 테스트할 수 있으며 실제 서비스나 최종 사용자에게 결과를 제공할 수 없습니다. 정식 유료 이용에는 별도 계약·Live 키가 필요하고, Sandbox 키는 자동으로 Live로 전환되지 않습니다.
API 상품
운세 콘텐츠
홈 피드·푸시·위젯에 활용하는 만세력 Lite·오늘운세·띠별운세 등 콘텐츠를 제공합니다.
제공 결과 비교계산 데이터
v5.0 기준 신규 Core 상품은 원국·오행·십성·십이운성·대운 등 계산 데이터를 제공합니다. 기존 고객의 제공 필드는 현재 계약을 따릅니다.
계산 범위 비교전문 데이터
v5.0 기준 신규 전문 상품은 Core 전체와 강약·격국·용신·지지 관계·공망, 신살 54종의 위치·상태·영향도 데이터를 제공합니다.
전문 데이터 비교응답 방식
| 구분 | 제공 결과 | 응답 방식 |
|---|---|---|
| 콘텐츠·리텐션 | 짧은 문구·점수·키워드 | 즉시 응답 |
| 만세력 Core | 원국·오행·십성·십이운성·대운 | 즉시 응답 |
| 전문 만세력+SIS | Core + 강약·격국·용신·관계·공망·신살 54종 | 즉시 응답 |
| 표준 해설 | 검수형 고정 문구 · 내부 테스트 | 즉시 응답 / 승인 범위 |
| 맞춤 해설 | 계산 결과 기반 장문 해설 | 기존 POST + Callback |
Core와 전문 만세력+SIS는 같은 GET /api/v2/saju/fortune 경로를 사용합니다. 위 비교는 현재 승인형 Sandbox에 적용하는 v5.0 신규 상품 범위이며 API 키 권한으로 구분합니다. 신규 정식 유료 가입은 12월 1일 전까지 대기 상태입니다. 기존 고객의 현재 필드를 즉시 축소하거나 요금을 인상한다는 안내가 아닙니다. SIS 상대강도는 통계 확률이 아닌 내부 지수입니다.
승인형 PoC
아래 표는 현재 운영 상태입니다. 현재 제공하는 승인형 Sandbox와 12월 1일 적용 예정인 신규 유료 요금을 구분해 확인하세요. 별자리운세·바이오리듬·표준 해설·토정비결·택일·작명은 내부 테스트 중이며, 실제 이용 제품과 경로·제공 범위·한도는 승인 후 안내합니다.
| 구분 | 상품별 제공 상태 |
|---|---|
| 만세력 Lite | 정식 제공 |
| 오늘운세·띠별운세 | 정식 제공 |
| 만세력 Core·전문 만세력+SIS | 정식 제공 |
| 별자리운세·바이오리듬 | 내부 테스트 중 · 승인형 PoC 문의 |
| 표준 해설 | 내부 테스트 중 · 승인형 PoC 문의 |
| 토정비결·택일·작명 | 내부 테스트 중 · 승인형 PoC 문의 |
일일 별자리운세와 전문 점성술은 별도 상품입니다. 전문 점성술도 내부 테스트 중이며 정식 요금은 확정되지 않았고, 일반 호출용 공개 API로 제공하지 않습니다.
지역별 현재 도입 상태는 한국·일본 정식 제공, 중국·대만 PoC, 미국·영국·유럽 협의입니다. 신규 표준 요금은 한국어 응답 기준이며, 제품·언어와 제공 범위는 승인 및 계약 조건을 확인합니다.
서비스·현장 적용 사례
쎄하다 / B2C 운세 서비스
쎄하다에서는 무료 만세력과 주요 리포트 화면, 운세 상품과 결제 흐름을 확인할 수 있습니다. 계산 데이터를 고객에게 어떻게 보여줄지 도입 전에 살펴보세요.
쎄하다 결과 화면 보기
Monkey Shoulder / 팝업 체험
브랜드 팝업 현장의 운세 체험 화면, 사진 촬영과 결과 표시, 영수증 출력 연동을 구성한 사례입니다. 캠페인형 UI와 외부 장치 연동은 API 이용과 별도 구축 범위로 검토합니다.


API 문서에서 인증, 요청값, JSON 응답, 오류 코드와 비동기 분석 방식을 확인할 수 있습니다.
API 응답 예시 보기테스트·운영 도입
사용할 제품, 서비스 용도와 테스트 범위를 남겨주세요.
제출 후 영업일 기준 1일 이내 1차 검토 결과와 발급 범위를 이메일로 안내합니다. API 키는 승인된 제품과 사용 범위에 한해 별도 이메일로 발급합니다.
현재 v5.0 기준의 승인형 Sandbox에서 30일 동안 콘텐츠 100회, Core/전문 만세력+SIS 합산 1,000회, 표준 결과 20회, Callback 완료 결과 5건을 테스트합니다. 실제 기능·기간·한도는 승인된 키 범위를 따릅니다.
신규 정식 유료 가입은 2026년 12월 1일 전까지 대기 상태입니다. 정식 이용 시 사용 API, 요금, 적용 화면, 예상 호출량과 출시일을 검토하고, 별도 계약과 Live 키를 확인합니다. 기존 고객의 계약·결제·키 권한은 유지합니다.
Sandbox는 테스트 전용이며 자동 Live 전환은 없습니다. 실제 서비스·최종 사용자 제공 전에 별도 Live 키가 필요합니다. 신규 고객은 지금 v5.0 기준 Sandbox를 신청할 수 있습니다. 신규 정식 유료 가입은 2026년 12월 1일 전까지 대기 상태입니다. 내부 테스트 상품은 승인된 범위를 확인합니다.
API 고객 소개서 v5.0 · 한국어 PDF · 유료 요금 12월 1일 적용 예정요금·사용량
콘텐츠·리텐션
소량 이용은 PAYG · Scale 월 99,000원
승인된 콘텐츠 모듈 범위 · 12월 1일 적용 예정
만세력 Core
Starter 월 30,000원 · 500건
계산 데이터 · 12월 1일 적용 예정
전문 만세력+SIS
Starter 월 50,000원 · 500건
Launch 월 89,000원 · 2,000건
Core 전체 + 전문 데이터 · 12월 1일 적용 예정
2026년 12월 1일부터 적용할 예정인 한국어 표준 응답 기준의 KRW 공급가액입니다. 기존 고객은 현재 계약과 별도 전환 안내를 따릅니다. 해설·전문 결과의 요금은 요금 페이지에서, 기본 제공 분량은 한국어 고객 소개서 v5.0 부록 B에서 확인하세요. 해설·택일·작명 결과 요금에는 필요한 계산료가 포함되며, 전체 데이터 API를 별도로 요청하면 데이터 요금이 추가됩니다.
월정액은 상품별 포함량을 기준으로 비교합니다. 실제 적용 상품, 이용 한도, 초과 이용료와 포함량 이월 여부는 Live 발급 전 견적·계약에서 정합니다.
PAYG 단가는 월정액의 초과 이용료로 자동 적용되지 않습니다. 결제일, 플랜 변경·해지 적용일, 일할 계산과 환불 조건도 견적·계약에서 확인합니다.
최종 2xx 응답 또는 Callback으로 완료된 결과만 과금합니다. Callback 접수 응답은 완료 결과가 아닙니다. 5xx, Ablecity 처리 실패, 동일 완료 결과의 재전송은 과금에서 제외합니다.
포인트 충전은 정식 유료 이용 단계에 해당합니다. 신규 고객의 정식 유료 가입은 12월 1일 전까지 대기 상태이며, 기존 고객의 결제는 현재 계약을 따릅니다.
PAYG에는 월 기본료가 없으며 공급가액 10,000원 이상 충전할 수 있습니다. 최소 충전의 VAT 포함 결제액은 11,000원이고, 1P는 공급가액 기준 1원입니다. 충전 포인트는 12개월 유효하며 충전 후 7일이 지나면 환불할 수 없습니다. 관련 법령상 권리는 영향을 받지 않으며 구체적인 환불 조건은 견적·계약과 관련 법령을 따릅니다.
연간 약정, 다국어·PDF 출력, 전용 인프라와 운영 지원은 별도 협의합니다. 전체 요금과 견적·계약으로 정할 조건은 요금 페이지를 확인하세요.
운영·지원 조건
키 권한, 제공 필드와 즉시·Callback 응답 계약을 도입 전에 확인합니다.
키별 사용량, 상품별 포함량과 포인트·초과 이용 기준을 확인합니다.
연동 초기 지원과 가용성, 지원 시간, 장애 대응 범위는 트래픽과 운영 책임에 맞춰 계약별 SLA로 정합니다.
도입 전 확인
기존 회원, 결제와 결과 페이지 구조를 확인한 뒤 필요한 API 결과를 연결하는 범위를 정합니다. 프론트 UI·고객 인프라·외부 연동 등 별도 구축은 견적에서 구분합니다.
Sandbox는 승인된 테스트용이며 자동 Live 전환은 없습니다. 실제 서비스나 최종 사용자에게 결과를 제공하려면 사용 API, 요금, 적용 화면, 예상 호출량과 출시일을 검토한 별도 Live 키가 필요합니다. 신규 고객은 지금 v5.0 기준 Sandbox를 신청할 수 있습니다. 신규 정식 유료 가입은 2026년 12월 1일 전까지 대기 상태입니다.
현재 승인형 Sandbox에 적용하는 v5.0 신규 상품 기준으로 Core는 계산 데이터를, 전문 만세력+SIS는 Core 전체와 전문 분석·신살 54종을 제공합니다. 신규 범위는 키 권한으로 구분합니다. 기존 고객의 현재 제공 필드와 요금은 계약과 별도 전환 안내를 따릅니다.
상품 소개 문서는 v5.0이고 실제 API는 기존 /api/v2/ 경로를 유지합니다. 문서 버전과 API 버전은 별개입니다.
내부 테스트 상품은 승인형 PoC 문의 대상입니다. 문서의 예정 경로는 변경 가능하며 일반 호출은 불가합니다. 실제 이용 경로와 한도는 승인 후 안내합니다.
API 키를 받은 고객은 API Dashboard에서 회원가입 후 사용량, 구독 상태와 API 조회를 확인할 수 있습니다. 포인트 충전은 정식 유료 이용 단계이며 신규 정식 유료 가입은 12월 1일 전까지 대기 상태입니다. 기존 고객은 현재 계약과 키 권한을 따릅니다.
API 도입 문의
사용할 제품, 예상 호출량과 연동 환경을 알려주세요. API 이용 범위 또는 별도 개발 산출물과 운영 조건을 기준으로 검토합니다.
계약 전 기능 범위, 납품물과 검수 기준, 변경 요청의 비용·일정 영향, 소스·문서 이관, 유지보수와 SLA 범위를 확인합니다.