만세력 API 를 화면에 붙이는 가장 빠른 방법은, AI 코딩 도구에 프롬프트를 한 번 붙여넣는 것입니다. 이 글의 프롬프트를 복사해 Claude Code · ChatGPT · Cursor 같은 도구에 그대로 넣으시면 index.html 한 파일이 생성됩니다. 빌드 도구도 백엔드도 필요 없습니다.
API v2 예제입니다
v2 는 하나의 운세 서비스는 하나의 API 엔드포인트로 구성됩니다. 예를 들어 /v2/sazu/manse 를 호출하시면 사주 명식 조회 서비스 만들기에 필요한 명리 계산이 모두 들어 있습니다. 즉 API 호출을 보내실 때 같이 사주 정보(생년월일시, 성별, 양음력 등)를 함께 보내시면 그 사주에 맞는 사주 명식을 받으실 수 있습니다.
호출을 보낸 뒤 받은 응답에는 data.guide 와 data.glossary 가 함께 포함되어 있습니다. 앞의 것은 이 응답을 LLM 에 넘길 때 쓸 지침이고, 뒤의 것은 응답에 나온 명리 용어의 정의입니다. 문장을 만드실 때 프롬프트를 직접 쓰지 않으셔도 기본 운세가 출력되며, 만약 나만의 운세 결과를 원하시는 경우에는 별도의 프롬프트를 작성해서 LLM 에게 보내면 원하는 결과를 얻을 수 있습니다. 하지만 이 경우에는 원하는 운세 결과를 얻기 위한 세밀한 가이드 수정이 요구됩니다.
무엇이 나오는가
/v2/sazu/manse 응답을 화면에 옮긴 한 페이지입니다.
- 사주 명식 4기둥 — 간지 · 십성 · 12운성
- 오행 분포
- 신강 · 신약 판정과 근거
- 풀이 문장
준비 — 무료 키 발급
대시보드에서 키를 발급받으시면 됩니다. 신용카드 등록 없이 바로 만들 수 있습니다.
무료 키의 동작
무료 키는 지정된 샘플 사주 5개에 대해 응답합니다. 입력 7개 필드가 모두 일치해야 하며, 하나라도 다르면 안내 메시지가 반환됩니다. 아래 프롬프트는 샘플 5개를 버튼으로 두어, 클릭하면 바로 조회되도록 구성돼 있습니다.
응답 구조는 유료 키와 동일합니다. 화면을 완성하신 뒤 키만 교체하면 임의의 생년월일이 동작하며, 렌더링 코드는 그대로 쓰실 수 있습니다.
프롬프트
아래 「구현 메모」 다음에 프롬프트 전문과 복사 버튼이 있습니다. 그대로 복사해 AI 코딩 도구에 붙여넣으세요.
프롬프트를 실행하시려면 본인 API 키가 필요합니다. 무료 키는 신용카드 등록 없이 대시보드에서 바로 발급하실 수 있습니다.
구현 메모
응답에는 한국어 해석 문장이 포함되어 있습니다 — sinStrength.analysis, twelveFortuneInterpretation.energy, decadeFortune 의 sipseong.interpretation 등. 예제는 이 값들을 그대로 표시하며, LLM 은 호출하지 않습니다.
data.guide 에는 이 응답을 LLM 에 넘길 때 쓸 지침이, data.glossary 에는 응답에 등장한 용어 정의가 함께 실립니다. 문장 품질을 올리실 때 이 두 필드를 그대로 넘기시면 됩니다. 예제 하단에도 실제 값이 표시됩니다.