엔드포인트

만세력 Free 가능

이 사람의 사주 명식은 어떻게 생겼나?

POST https://api.supasaju.com/v2/saju/manse

무엇을 담나

만세력 화면의 표준 구성입니다. 원국(십성·12운성·지장간)이 바닥이고, 오행 분포와 신강약이 첫 진단, 신살이 표기를 채우고, 대운이 시간축을 엽니다. 명식 자체를 보여 주는 화면이라면 이 하나로 끝납니다. 핵심 모듈이 무료 범위라 Free 키로도 임의의 생년월일을 계산합니다.

요청

curl -X POST https://api.supasaju.com/v2/saju/manse \
  -H "x-api-key: $SAJU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "birthYear": 1988,
  "birthMonth": 3,
  "birthDay": 14,
  "birthHour": 9,
  "birthMinute": 20,
  "isFemale": false,
  "isLunar": false,
  "birthCity": "서울"
}'

const res = await fetch('https://api.supasaju.com/v2/saju/manse', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.SAJU_API_KEY!,
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    "birthYear": 1988,
    "birthMonth": 3,
    "birthDay": 14,
    "birthHour": 9,
    "birthMinute": 20,
    "isFemale": false,
    "isLunar": false,
    "birthCity": "서울"
  }),
})

const { data } = await res.json()

// 판정 근거 문장만 모읍니다 — 이게 풀이의 재료입니다.
const facts: string[] = []
const walk = (v: unknown, path = ''): void => {
  if (Array.isArray(v)) return v.forEach((x, i) => walk(x, `${path}[${i}]`))
  if (v === null || typeof v !== 'object') return
  for (const [k, x] of Object.entries(v)) {
    if (typeof x === 'string' && ['reasoning', 'basis', 'meaning'].includes(k)) facts.push(x)
    else walk(x, path ? `${path}.${k}` : k)
  }
}
walk(data.modules)

// guide 와 glossary 를 함께 실어 넘깁니다.
const prompt = [
  data.guide.purpose,
  ...data.guide.howToUse,
  '',
  '용어의 뜻:',
  ...Object.entries(data.glossary).map(([t, d]) => `- ${t}: ${d}`),
  '',
  '계산된 사실:',
  ...facts.map((f) => `- ${f}`),
  '',
  '위 사실만으로 존댓말 6문장으로 풀어 주세요.',
].join('\n')

import os, json, requests

res = requests.post(
    "https://api.supasaju.com/v2/saju/manse",
    headers={"x-api-key": os.environ["SAJU_API_KEY"]},
    json={
        "birthYear": 1988,
        "birthMonth": 3,
        "birthDay": 14,
        "birthHour": 9,
        "birthMinute": 20,
        "isFemale": False,
        "isLunar": False,
        "birthCity": "서울"
    },
)
data = res.json()["data"]

# 판정 근거 문장만 모읍니다 — 이게 풀이의 재료입니다.
FACT_KEYS = {"reasoning", "basis", "meaning"}
facts = []

def walk(v):
    if isinstance(v, list):
        for x in v:
            walk(x)
    elif isinstance(v, dict):
        for k, x in v.items():
            if isinstance(x, str) and k in FACT_KEYS:
                facts.append(x)
            else:
                walk(x)

walk(data["modules"])

# guide 와 glossary 를 함께 실어 넘깁니다.
prompt = "\n".join([
    data["guide"]["purpose"],
    *data["guide"]["howToUse"],
    "",
    "용어의 뜻:",
    *[f"- {t}: {d}" for t, d in data["glossary"].items()],
    "",
    "계산된 사실:",
    *[f"- {f}" for f in facts],
    "",
    "위 사실만으로 존댓말 6문장으로 풀어 주세요.",
])

공통 요청 필드는 문서 홈에 정리되어 있습니다. 위 예시의 생년월일은 샘플 프로필이라 Free 키로 그대로 재현됩니다.

응답

아래는 위 요청의 실제 응답입니다. 봉투를 먼저 보이고, 핵심 모듈 fourPillars 을 펼쳐 실었습니다. 나머지 모듈은 접어 두었습니다 — 전체 형태는 스키마 파일과 OpenAPI에 있습니다.

봉투

{
  "topic": "manse",
  "guide": {
    "purpose": "이 사람의 사주 명식은 어떻게 생겼나? — 만세력 토픽의 계산 결과입니다.",
    "howToUse": [
      "… 6줄"
    ]
  },
  "glossary": {
    "진태양시": {
      "definition": "출생지의 경도와 균시차까지 반영한 실제 태양 기준 시각.",
      "en": "True Solar Time"
    },
    "태극귀인": {
      "definition": "일간을 기준으로 잡는 길신. 시작과 마무리가 이어지는 자리로 본다.",
      "en": "Taiji Nobleman"
    },
    "…": "외 67종"
  },
  "reference": {
    "date": "2026-09-17",
    "month": "2026-09",
    "year": 2026
  },
  "input": {
    "solar": {
      "year": 1988,
      "month": 3,
      "day": 14,
      "hour": 9,
      "minute": 20
    },
    "lunar": {
      "year": 1988,
      "month": 1,
      "day": 26,
      "isLeapMonth": false
    },
    "isFemale": false,
    "correctedHour": 8,
    "correctedMinute": 38
  },
  "timezone": {
    "cityId": "seoul",
    "cityResolved": true,
    "locationSource": "city",
    "tzId": "Asia/Seoul",
    "utcOffsetMinutes": 540,
    "longitude": 126.978,
    "mode": "trueSolar",
    "longitudeCorrectionMinutes": -32.1,
    "equationOfTimeMinutes": -9.3,
    "totalCorrectionMinutes": -41.4,
    "dstApplied": false
  },
  "modules": {
    "fourPillars": "…",
    "elements": "…",
    "sinStrength": "…",
    "sinsal": "…",
    "decadeFortune": "…"
  },
  "diagnostics": [],
  "ruleset": {
    "version": "0.2.2",
    "profile": "ko-standard",
    "data": {
      "tzdata": "2026c",
      "tzdataBuild": "backzone",
      "tzZones": 418,
      "ephemeris": "DE440s",
      "lunarVerifiedThrough": 2050,
      "solarTermsVerifiedRange": "2000-2028"
    }
  }
}

핵심 모듈 — fourPillars

{
  "pillars": {
    "year": {
      "position": "year",
      "positionKo": "연주",
      "ganji": "무진",
      "ganjiHan": "戊辰",
      "ganjiIndex": 4,
      "stem": {
        "index": 4,
        "han": "戊",
        "ko": "무",
        "element": "earth",
        "elementKo": "토",
        "elementHan": "土",
        "polarity": "yang",
        "polarityKo": "양",
        "sipseong": {
          "id": "bigyeon",
          "ko": "비견",
          "han": "比肩",
          "group": "bigeop",
          "groupKo": "비겁",
          "meaning": "비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.",
          "positionMeaning": "연주의 비견은 집안과 초년 환경에 나와 비슷한 기운이 있어 경쟁과 협력이 함께 놓인 자리로 읽는다."
        }
      },
      "branch": {
        "index": 4,
        "han": "辰",
        "ko": "진",
        "element": "earth",
        "elementKo": "토",
        "elementHan": "土",
        "polarity": "yang",
        "polarityKo": "양",
        "animalKo": "용",
        "sipseong": {
          "id": "bigyeon",
          "ko": "비견",
          "han": "比肩",
          "group": "bigeop",
          "groupKo": "비겁",
          "meaning": "비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.",
          "positionMeaning": "연주의 비견은 집안과 초년 환경에 나와 비슷한 기운이 있어 경쟁과 협력이 함께 놓인 자리로 읽는다."
        },
        "hiddenStems": [
          {
            "stem": "…",
            "role": "yeogi",
            "roleKo": "여기",
            "roleHan": "餘氣",
            "days": 9
          },
          {
            "stem": "…",
            "role": "junggi",
            "roleKo": "중기",
            "roleHan": "中氣",
            "days": 3
          },
          "… 외 1건"
        ]
      },
      "twelveStage": {
        "id": "gwandae",
        "ko": "관대",
        "han": "冠帶",
        "order": 3,
        "keyword": "성장",
        "phase": "상승",
        "meaning": "관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.",
        "positionMeaning": "연주의 관대는 초년의 바탕에서 일간이 일찍 모양을 갖추고 나서려는 자리로 읽는다."
      },
      "selfStage": {
        "id": "gwandae",
        "ko": "관대",
        "han": "冠帶",
        "order": 3
      },
      "naeum": {
        "ko": "대림목",
        "han": "大林木",
        "element": "wood",
        "elementKo": "목"
      }
    },
    "month": {
      "position": "month",
      "positionKo": "월주",
      "ganji": "을묘",
      "ganjiHan": "乙卯",
      "ganjiIndex": 51,
      "stem": {
        "index": 1,
        "han": "乙",
        "ko": "을",
        "element": "wood",
        "elementKo": "목",
        "elementHan": "木",
        "polarity": "yin",
        "polarityKo": "음",
        "sipseong": {
          "id": "jeonggwan",
          "ko": "정관",
          "han": "正官",
          "group": "gwanseong",
          "groupKo": "관성",
          "meaning": "정관은 일간을 다스리는 기운 중 음양이 다른 것으로, 질서와 명예, 규범을 따르며 얻는 안정으로 읽는다.",
          "positionMeaning": "월주의 정관은 사회에 나서는 시기에 조직과 직위를 통해 자리를 잡는 흐름으로 읽는다."
        }
      },
      "branch": {
        "index": 3,
        "han": "卯",
        "ko": "묘",
        "element": "wood",
        "elementKo": "목",
        "elementHan": "木",
        "polarity": "yin",
        "polarityKo": "음",
        "animalKo": "토끼",
        "sipseong": {
          "id": "jeonggwan",
          "ko": "정관",
          "han": "正官",
          "group": "gwanseong",
          "groupKo": "관성",
          "meaning": "정관은 일간을 다스리는 기운 중 음양이 다른 것으로, 질서와 명예, 규범을 따르며 얻는 안정으로 읽는다.",
          "positionMeaning": "월주의 정관은 사회에 나서는 시기에 조직과 직위를 통해 자리를 잡는 흐름으로 읽는다."
        },
        "hiddenStems": [
          {
            "stem": "…",
            "role": "yeogi",
            "roleKo": "여기",
            "roleHan": "餘氣",
            "days": 10
          },
          {
            "stem": "…",
            "role": "jeonggi",
            "roleKo": "정기",
            "roleHan": "正氣",
            "days": 20
          }
        ]
      },
      "twelveStage": {
        "id": "mogyok",
        "ko": "목욕",
        "han": "沐浴",
        "order": 2,
        "keyword": "정화",
        "phase": "상승",
        "meaning": "목욕은 갓 태어난 기운이 씻기고 다듬어지는 단계로, 불안정하지만 변화가 빠르고 감각이 예민한 흐름으로 본다.",
        "positionMeaning": "월주의 목욕은 사회에 나서는 시기에 시행착오와 변화가 잦은 자리로 읽는다."
      },
      "selfStage": {
        "id": "geonrok",
        "ko": "건록",
        "han": "建祿",
        "order": 4
      },
      "naeum": {
        "ko": "대계수",
        "han": "大溪水",
        "element": "water",
        "elementKo": "수"
      }
    },
    "day": {
      "position": "day",
      "positionKo": "일주",
      "ganji": "무진",
      "ganjiHan": "戊辰",
      "ganjiIndex": 4,
      "stem": {
        "index": 4,
        "han": "戊",
        "ko": "무",
        "element": "earth",
        "elementKo": "토",
        "elementHan": "土",
        "polarity": "yang",
        "polarityKo": "양",
        "sipseong": null
      },
      "branch": {
        "index": 4,
        "han": "辰",
        "ko": "진",
        "element": "earth",
        "elementKo": "토",
        "elementHan": "土",
        "polarity": "yang",
        "polarityKo": "양",
        "animalKo": "용",
        "sipseong": {
          "id": "bigyeon",
          "ko": "비견",
          "han": "比肩",
          "group": "bigeop",
          "groupKo": "비겁",
          "meaning": "비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.",
          "positionMeaning": "일지의 비견은 일간 곁에 같은 기운이 앉아 자립심이 강하고 배우자 자리를 스스로 채우려는 구조로 본다."
        },
        "hiddenStems": [
          {
            "stem": "…",
            "role": "yeogi",
            "roleKo": "여기",
            "roleHan": "餘氣",
            "days": 9
          },
          {
            "stem": "…",
            "role": "junggi",
            "roleKo": "중기",
            "roleHan": "中氣",
            "days": 3
          },
          "… 외 1건"
        ]
      },
      "twelveStage": {
        "id": "gwandae",
        "ko": "관대",
        "han": "冠帶",
        "order": 3,
        "keyword": "성장",
        "phase": "상승",
        "meaning": "관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.",
        "positionMeaning": "일주의 관대는 일간이 자기 자리에서 뜻을 세우고 드러내려는 구조로 본다."
      },
      "selfStage": {
        "id": "gwandae",
        "ko": "관대",
        "han": "冠帶",
        "order": 3
      },
      "naeum": {
        "ko": "대림목",
        "han": "大林木",
        "element": "wood",
        "elementKo": "목"
      }
    },
    "hour": {
      "position": "hour",
      "positionKo": "시주",
      "ganji": "병진",
      "ganjiHan": "丙辰",
      "ganjiIndex": 52,
      "stem": {
        "index": 2,
        "han": "丙",
        "ko": "병",
        "element": "fire",
        "elementKo": "화",
        "elementHan": "火",
        "polarity": "yang",
        "polarityKo": "양",
        "sipseong": {
          "id": "pyeonin",
          "ko": "편인",
          "han": "偏印",
          "group": "inseong",
          "groupKo": "인성",
          "meaning": "편인은 일간을 낳는 기운 중 음양이 같은 것으로, 비주류의 배움과 깊은 탐구, 식신을 누르는 작용으로 읽는다.",
          "positionMeaning": "시주의 편인은 후반에 배움과 연구로 향하는 흐름으로 읽는다."
        }
      },
      "branch": {
        "index": 4,
        "han": "辰",
        "ko": "진",
        "element": "earth",
        "elementKo": "토",
        "elementHan": "土",
        "polarity": "yang",
        "polarityKo": "양",
        "animalKo": "용",
        "sipseong": {
          "id": "bigyeon",
          "ko": "비견",
          "han": "比肩",
          "group": "bigeop",
          "groupKo": "비겁",
          "meaning": "비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.",
          "positionMeaning": "시주의 비견은 후반에 동료와 자녀 자리에서 나와 닮은 기운이 이어지는 흐름으로 읽는다."
        },
        "hiddenStems": [
          {
            "stem": "…",
            "role": "yeogi",
            "roleKo": "여기",
            "roleHan": "餘氣",
            "days": 9
          },
          {
            "stem": "…",
            "role": "junggi",
            "roleKo": "중기",
            "roleHan": "中氣",
            "days": 3
          },
          "… 외 1건"
        ]
      },
      "twelveStage": {
        "id": "gwandae",
        "ko": "관대",
        "han": "冠帶",
        "order": 3,
        "keyword": "성장",
        "phase": "상승",
        "meaning": "관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.",
        "positionMeaning": "시주의 관대는 후반에 새 목표를 세우고 모양을 갖추려는 자리로 읽는다."
      },
      "selfStage": {
        "id": "gwandae",
        "ko": "관대",
        "han": "冠帶",
        "order": 3
      },
      "naeum": {
        "ko": "사중토",
        "han": "沙中土",
        "element": "earth",
        "elementKo": "토"
      }
    }
  },
  "hourKnown": true,
  "dayMaster": {
    "stem": {
      "index": 4,
      "han": "戊",
      "ko": "무",
      "element": "earth",
      "elementKo": "토",
      "elementHan": "土",
      "polarity": "yang",
      "polarityKo": "양",
      "sipseong": null
    },
    "label": "양토 무(戊) 일간",
    "meaning": "무 일간은 넓고 두터운 산과 들의 기운으로, 묵직하게 품고 중심을 지키려는 성향을 바탕으로 읽는다."
  },
  "monthTerm": {
    "nameKo": "경칩",
    "nameHan": "驚蟄",
    "atKst": "1988-03-05 17:47",
    "elapsedDays": 8.6,
    "minutesFromJeol": 12453,
    "nextNameKo": "청명",
    "nextAtKst": "1988-04-04 22:39",
    "minutesToNextJeol": 31039
  },
  "saryeong": {
    "stem": {
      "index": 0,
      "han": "甲",
      "ko": "갑",
      "element": "wood",
      "elementKo": "목",
      "elementHan": "木",
      "polarity": "yang",
      "polarityKo": "양",
      "sipseong": {
        "id": "pyeongwan",
        "ko": "편관",
        "han": "偏官",
        "group": "gwanseong",
        "groupKo": "관성"
      }
    },
    "role": "yeogi",
    "roleKo": "여기",
    "elapsedDays": 8.6,
    "firstHalf": true,
    "basis": [
      "경칩 절입 후 8.6일 경과라 월지 묘의 여기 갑(甲)이 사령한다(통용 배분표 0~10일 구간)."
    ]
  },
  "yearBoundary": {
    "ipchunAtKst": "1988-02-04 23:43",
    "beforeIpchun": false,
    "minutesFromIpchun": 55297
  },
  "hourBoundary": {
    "minutesFromStart": 98.6,
    "minutesToNext": 21.4
  },
  "basis": [
    "연주는 입춘 절입 순간(1988-02-04 23:43 KST)을 기준으로 정했다.",
    "월주는 12절 기준으로 경칩(1988-03-05 17:47 KST) 이후 청명 전이라 묘(卯)월이며, 월간은 연간에서 오호둔으로 정했다.",
    "… 외 2건"
  ]
}

{
  "elements": {
    "counts": [
      {
        "element": "wood",
        "ko": "목",
        "han": "木",
        "visible": 2,
        "visibleStems": 1,
        "visibleBranches": 1,
        "withHidden": 6,
        "visiblePercent": 25,
        "withHiddenPercent": 40,
        "label": "보통",
        "nature": "목은 뻗어 오르고 자라는 기운으로, 시작과 성장, 곧게 나아가는 의지를 상징하는 오행으로 읽는다.",
        "meaning": "목이 알맞게 있어 성장의 기운이 다른 오행과 균형을 이루는 구조로 본다."
      },
      {
        "element": "fire",
        "ko": "화",
        "han": "火",
        "visible": 1,
        "visibleStems": 1,
        "visibleBranches": 0,
        "withHidden": 1,
        "visiblePercent": 12.5,
        "withHiddenPercent": 6.7,
        "label": "적음",
        "nature": "화는 타오르고 밝히는 기운으로, 열정과 표현, 드러냄과 확산을 상징하는 오행으로 읽는다.",
        "meaning": "화가 적어 열정과 표현의 기운이 조용히 자리한 구조로 읽는다."
      },
      "… 외 3건"
    ],
    "totalVisible": 8,
    "totalWithHidden": 15,
    "strongest": [
      "earth"
    ],
    "missing": [
      "metal",
      "water"
    ],
    "dayMasterElement": "earth",
    "basis": [
      "드러난 글자 8개(천간 4·지지 4)의 오행을 세었고, 지지는 정기 오행으로 셌다.",
      "지장간 포함 집계(withHidden)는 천간 4개와 지장간 11개를 각 1로 세었다. 세력 가중치와 합화 변환은 반영하지 않는다."
    ]
  },
  "sinStrength": {
    "score": 60,
    "label": "신강",
    "isStrong": true,
    "deukryeong": false,
    "deukji": true,
    "deukjiPartial": false,
    "deukse": true,
    "deukseCount": 4,
    "saryeongHelps": false,
    "extremeCandidate": null,
    "helpingCount": {
      "bigeop": 4,
      "inseong": 1
    },
    "contributions": [
      {
        "position": "year",
        "part": "stem",
        "glyph": "무",
        "weight": 10,
        "coefficient": 1,
        "points": 10,
        "via": "stem",
        "sipseong": {
          "id": "bigyeon",
          "ko": "비견",
          "han": "比肩",
          "group": "bigeop",
          "groupKo": "비겁"
        }
      },
      {
        "position": "month",
        "part": "stem",
        "glyph": "을",
        "weight": 10,
        "coefficient": 0,
        "points": 0,
        "via": null,
        "sipseong": {
          "id": "jeonggwan",
          "ko": "정관",
          "han": "正官",
          "group": "gwanseong",
          "groupKo": "관성"
        }
      },
      "… 외 5건"
    ],
    "availableWeight": 100,
    "cause": "비겁이 많아 강함",
    "meaning": "일간이 강한 원국은 자기 힘으로 서는 바탕이 있으므로, 그 힘을 쓰게 해 주는 관성·식상·재성이 어디에 있는지를 살피는 구조로 본다.",
    "reasoning": "신강(60점): 일간 무(戊)를 돕는 글자는 연간 무(戊, 비견) 10점·시간 병(丙, 편인) 10점·연지 진(辰, 정기 무 비견) 8점·일지 진(辰, 정기 무 비견) 20점·시지 진(辰, 정기 무 비견) 12점이다. 월간 을(乙, 정관)·월지 묘(卯, 정관)는 돕지 않는다. 원인은 비겁이 많아 강함이다.",
    "basis": [
      "일간 무(戊, 토)를 돕는 비겁·인성이 자리별로 얼마나 뿌리를 두는지 세어 60점(신강)으로 판정했다.",
      "득령 못함(월지 묘(卯) 정기 기준) · 득지 함 · 득세 함(월지·일지 외 4자리).",
      "… 외 1건"
    ]
  },
  "sinsal": {
    "auspicious": [
      {
        "id": "taegeuk",
        "ko": "태극귀인",
        "han": "太極貴人",
        "category": "auspicious",
        "positions": [
          "year",
          "day",
          "… 외 1건"
        ],
        "positionsKo": [
          "연주",
          "일주",
          "… 외 1건"
        ],
        "basis": [
          "일간 무(戊) → 지지 辰·戌·丑·未 (三命通會 論太極貴 甲乙子午·丙丁卯酉·戊己辰戌丑未·庚辛寅亥·壬癸申巳)"
        ],
        "source": "classic",
        "sourceKo": "원전(삼명통회)",
        "meaning": "태극귀인은 시작과 끝을 함께 보는 안목을 뜻하는 신살로, 깊이 있는 관심과 원리 탐구의 기운으로 읽는다."
      }
    ],
    "inauspicious": [
      {
        "id": "baekho",
        "ko": "백호",
        "han": "白虎",
        "category": "inauspicious",
        "positions": [
          "year",
          "day"
        ],
        "positionsKo": [
          "연주",
          "일주"
        ],
        "basis": [
          "기둥 간지가 甲辰·乙未·丙戌·丁丑·戊辰·壬戌·癸丑 중 하나"
        ],
        "source": "common",
        "sourceKo": "통용(현대 만세력)",
        "meaning": "백호는 강한 충격의 기운을 상징하는 간지로, 해당 기둥의 일에 급격한 변화가 있을 수 있는 신호로 읽는다."
      },
      {
        "id": "hongyeom",
        "ko": "홍염",
        "han": "紅艶",
        "category": "inauspicious",
        "positions": [
          "year",
          "day",
          "… 외 1건"
        ],
        "positionsKo": [
          "연주",
          "일주",
          "… 외 1건"
        ],
        "basis": [
          "일간 무(戊) → 지지 辰"
        ],
        "source": "common",
        "sourceKo": "통용(현대 만세력)",
        "meaning": "홍염은 붉은 빛으로 끄는 힘의 비유로, 매력과 정감이 두드러지는 기운으로 읽는다."
      }
    ],
    "twelveSinsal": {
      "byYear": {
        "year": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "month": {
          "id": "yukhae",
          "ko": "육해",
          "han": "六害",
          "meaning": "육해는 여섯 해로움이라는 이름의 자리로, 잔잔한 마찰과 방해가 놓일 수 있는 신호로 읽는다."
        },
        "day": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "hour": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        }
      },
      "byDay": {
        "year": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "month": {
          "id": "yukhae",
          "ko": "육해",
          "han": "六害",
          "meaning": "육해는 여섯 해로움이라는 이름의 자리로, 잔잔한 마찰과 방해가 놓일 수 있는 신호로 읽는다."
        },
        "day": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        },
        "hour": {
          "id": "hwagae",
          "ko": "화개",
          "han": "華蓋",
          "meaning": "화개는 화려한 덮개라는 비유의 자리로, 예술·종교·학문처럼 혼자 깊어지는 기운으로 읽는다."
        }
      }
    },
    "gongmang": {
      "xun": "갑자순",
      "xunHan": "甲子旬",
      "empties": [
        "술",
        "해"
      ],
      "emptiesHan": [
        "戌",
        "亥"
      ],
      "positions": [],
      "positionsKo": [],
      "meaning": "공망 지지 술·해가 원국 네 기둥에 없어 공망으로 비는 자리가 없는 구조로 본다."
    },
    "summary": {
      "auspiciousCount": 1,
      "inauspiciousCount": 2
    },
    "basis": [
      "신살은 길신 15종·흉/중립 17종의 규칙표(일간·년지·월지·일주·글자 기준)로 판정했고, 각 항목에 근거가 원전(삼명통회 권3)인지 현대 통용 규칙인지를 표시했다.",
      "12신살은 년지 기준을 기본으로 하고 일지 기준을 병기했으며, 공망은 일주가 속한 순(旬)의 빈 지지 두 개로 정했다.",
      "… 외 1건"
    ]
  },
  "decadeFortune": {
    "direction": "forward",
    "directionKo": "순행",
    "startAge": 7,
    "startAgeExact": 7.18,
    "firstStartsOn": "1995-05-21",
    "countedTo": {
      "nameKo": "청명",
      "atKst": "1988-04-04 22:39",
      "days": 21.55
    },
    "entries": [
      {
        "order": 1,
        "ganji": "병진",
        "ganjiHan": "丙辰",
        "ganjiIndex": 52,
        "stem": {
          "index": 2,
          "han": "丙",
          "ko": "병",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yang",
          "polarityKo": "양",
          "sipseong": "…"
        },
        "branch": {
          "index": 4,
          "han": "辰",
          "ko": "진",
          "element": "earth",
          "elementKo": "토",
          "elementHan": "土",
          "polarity": "yang",
          "polarityKo": "양",
          "animalKo": "용",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "gwandae",
          "ko": "관대",
          "han": "冠帶",
          "order": 3
        },
        "startAge": 7,
        "endAge": 16,
        "ageAtStart": {
          "international": 7,
          "korean": 8
        },
        "startsOn": "1995-05-21",
        "endsOn": "2005-05-21",
        "isCurrent": false,
        "meaning": "대운 천간에 편인이 오는 시기는 배움과 탐구가 깊어지되 활동이 안으로 향하는 흐름으로 읽는다. 대운 지지가 일간에게 관대인 시기는 모양을 갖추고 뜻을 세워 나서는 흐름으로 읽는다."
      },
      {
        "order": 2,
        "ganji": "정사",
        "ganjiHan": "丁巳",
        "ganjiIndex": 53,
        "stem": {
          "index": 3,
          "han": "丁",
          "ko": "정",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yin",
          "polarityKo": "음",
          "sipseong": "…"
        },
        "branch": {
          "index": 5,
          "han": "巳",
          "ko": "사",
          "element": "fire",
          "elementKo": "화",
          "elementHan": "火",
          "polarity": "yin",
          "polarityKo": "음",
          "animalKo": "뱀",
          "sipseong": "…",
          "hiddenStems": [
            "…",
            "…",
            "… 외 1건"
          ]
        },
        "twelveStage": {
          "id": "geonrok",
          "ko": "건록",
          "han": "建祿",
          "order": 4
        },
        "startAge": 17,
        "endAge": 26,
        "ageAtStart": {
          "international": 17,
          "korean": 18
        },
        "startsOn": "2005-05-21",
        "endsOn": "2015-05-21",
        "isCurrent": false,
        "meaning": "대운 천간에 정인이 오는 시기는 보호와 학습, 문서·자격의 기운이 보태지는 흐름으로 읽는다. 대운 지지가 일간에게 건록인 시기는 제 힘으로 서는 안정된 흐름으로 읽는다."
      },
      "… 외 11건"
    ],
    "selection": {
      "mode": "count",
      "value": 13,
      "firstOrder": 1,
      "lastOrder": 13
    },
    "current": {
      "order": 4,
      "phase": "within",
      "reasoning": "현재 대운은 4번째 기미(己未) 37~46세 구간으로, 천간 겁재·지지 겁재·12운성 쇠로 본다."
    },
    "basis": [
      "연간 양간 · 남성이라 순행(양남음녀)한다 (三命通會 論大運).",
      "출생 이후 다음 절인 청명(1988-04-04 22:39 KST)까지 21.55일을 3일=1년으로 환산해 대운수 7.18년(반올림 7)을 얻었다.",
      "… 외 1건"
    ]
  }
}

반환 형식

모듈마다 최상위 필드입니다. 스키마는 실제 응답에서 생성되므로 손으로 쓴 설명과 달리 어긋날 수 없습니다.

fourPillars

담기는 토픽: 만세력 · 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 건강운 · 전체 스키마

elements

담기는 토픽: 만세력 · 고민 상담 · 관계 궁합 · 연애 운 · 건강운 · 전체 스키마

sinStrength

담기는 토픽: 만세력 · 월 운세 · 대운 10년 · 고민 상담 · 금전운 · 건강운 · 전체 스키마

sinsal

담기는 토픽: 만세력 · 오늘의 운세 · 일일 운세 · 월 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 건강운 · 전체 스키마

decadeFortune

담기는 토픽: 만세력 · 일일 운세 · 연간 운세 · 대운 10년 · 평생 흐름 · 고민 상담 · 관계 궁합 · 연애 운 · 금전운 · 전체 스키마

해설 문장

이 응답에는 해설 문장 62개와 용어 69종이 실립니다. 문장은 종류마다 하는 일이 다릅니다.

reasoning 예시

• sinStrength.reasoning신강(60점): 일간 무(戊)를 돕는 글자는 연간 무(戊, 비견) 10점·시간 병(丙, 편인) 10점·연지 진(辰, 정기 무 비견) 8점·일지 진(辰, 정기 무 비견) 20점·시지 진(辰, 정기 무 비견) 12점이다. 월간 을(乙, 정관)·월지 묘(卯, 정관)는 돕지 않는다. 원인은 비겁이 많아 강함이다.
• decadeFortune.current.reasoning현재 대운은 4번째 기미(己未) 37~46세 구간으로, 천간 겁재·지지 겁재·12운성 쇠로 본다.

meaning 예시

• fourPillars.pillars.year.stem.sipseong.meaning비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.
• fourPillars.pillars.year.branch.sipseong.meaning비견은 일간과 같은 오행·같은 음양의 기운으로, 나와 어깨를 나란히 하는 동료·형제와 자기 주장의 힘으로 읽는다.
• fourPillars.pillars.year.twelveStage.meaning관대는 기운이 형태를 갖추고 옷을 입듯 사회적 모습을 갖추는 단계로, 의욕과 자기 표현이 커지는 흐름으로 본다.

활용 지침 — data.guide

응답에 이 지침이 함께 실립니다. 고객이 별도 시스템 프롬프트를 쓰지 않아도 활용법이 같이 전달됩니다.

목적: 이 사람의 사주 명식은 어떻게 생겼나? — 만세력 토픽의 계산 결과입니다.

1. data.modules 는 계산된 사실 근거입니다 — 여기에 없는 사실을 지어내지 마세요.
2. data.modules 의 키 순서가 해석 순서입니다 — 원국(fourPillars)부터 그 순서대로 읽으세요.
3. meaning·basis·reasoning·positionMeaning 필드가 판정 결론이 담긴 문장 재료입니다 — 요약과 톤 변환만으로 풀이를 만들 수 있습니다.
4. data.glossary 는 이 응답에 나온 명리 용어의 뜻입니다 — 이 뜻을 기준으로 삼고 다르게 정의하지 마세요.
5. 숫자는 분기·정렬에만 쓰고, 문장에는 함께 담긴 말(label·phase·season)을 쓰세요.
6. 명식 자체를 설명하는 토픽입니다 — 시기 예측으로 넘어가지 마세요.

LLM 연동

판정을 LLM 에게 다시 시키지 마십시오. 응답의 문장을 요약하고 톤만 바꾸게 하십시오. 사주 판정을 LLM 이 하면 그럴듯한 오답이 나오고, 문장이 매끄러워서 틀린 줄을 모릅니다.

[시스템]
data.modules 는 계산된 사실 근거입니다 — 여기에 없는 사실을 지어내지 마세요.
아래 '계산된 사실' 밖의 내용을 말하지 마세요.

[사용자]
{"guide":"…","glossary":"…","modules":"…"}

존댓말로 6문장. 첫 문장은 결론, 마지막 문장은 주의점.

오늘의 운세 →