자미두수 가이드
자미두수(紫微斗數)는 중국 고대 명리학의 정수로, 12궁위와 14정성을 활용한 심화 운명 분석 시스템입니다. 이 가이드에서는 자미두수 명반 생성부터 궁위 분석, 유년 운세까지 실전 활용법을 설명합니다.
개요
자미두수 API는 생년월일시를 기반으로 명반(命盤)을 생성합니다. API는 다음 정보를 제공합니다:
- 12궁위: 명궁, 형제궁, 부부궁, 자녀궁, 재백궁, 질액궁, 천이궁, 노복궁, 관록궁, 전택궁, 복덕궁, 부모궁
- 14정성: 자미, 천기, 태양, 무곡, 천동, 염정, 천부, 태음, 탐랑, 거문, 천상, 천량, 칠살, 파군
- 보좌성: 좌보우필, 문창문곡, 천괴천월, 천공지겁 등
- 대한: 10년 주기 대한(大限) 정보
- 유년운: 특정 연도의 12궁 운세 및 사화(四化)
빠른 시작
기본 명반 생성
자미두수 명반을 생성하려면 출생 정보와 분석 대상 연도가 필요합니다:
curl -X POST https://api.destinyapi.com/v1/jami/analysis \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"input_data": {
"name": "홍길동",
"birthdate": "1985-06-18",
"birth_time": "22:00",
"gender": "F",
"is_lunar": true,
"is_leap_month": false
},
"target_year_ganji": "갑신"
}'필수 파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
input_data.name | string | 이름 (메타데이터용) |
input_data.birthdate | string | 출생일 (YYYY-MM-DD 형식) |
input_data.birth_time | string | 출생 시간 (HH:MM 형식, 24시간제) |
input_data.gender | string | 성별 ("M" 또는 "F") |
target_year_ganji | string | 분석 대상 연도 간지 (예: "갑신", "을유") |
선택적 파라미터
| 파라미터 | 기본값 | 설명 |
|---|---|---|
input_data.is_lunar | false | 음력 여부 |
input_data.is_leap_month | false | 윤달 여부 |
⭐
target_year_ganji 확인
분석하려는 연도의 간지를 정확히 입력해야 합니다. 예를 들어 2024년은 "갑진"입니다. 간지는 60갑자 순환이므로 연도별로 달라집니다.
응답 구조
명반 생성 API의 응답:
주요 필드 설명
1. 기본 정보
납음오행: 출생 연도의 납음오행 (천중수, 대림목 등)국수: 명국의 강약을 나타내는 숫자 (1-5)명궁: 가장 중요한 궁위, 본인의 위치두군: 명반의 중심이 되는 궁위
2. 십이궁 (12 Palaces)
12개의 궁위는 인생의 각 영역을 나타냅니다:
명궁 (命宮)
본인의 성격, 외모, 기질
형제궁 (兄弟宮)
형제자매, 동료 관계
부부궁 (夫妻宮)
배우자, 결혼, 애정운
자녀궁 (子女宮)
자녀, 창작, 성생활
재백궁 (財帛宮)
재물, 금전운
질액궁 (疾厄宮)
건강, 질병
천이궁 (遷移宮)
이동, 외출, 대외 활동
노복궁 (奴僕宮)
친구, 부하, 대인관계
관록궁 (官祿宮)
직업, 사업, 명예
전택궁 (田宅宮)
부동산, 가정환경
복덕궁 (福德宮)
정신세계, 취미, 복
부모궁 (父母宮)
부모, 상사, 스승
3. 14정성 및 보좌성
각 궁위에 배치된 별들이 그 영역의 운세를 결정합니다:
- 자미성: 제왕성, 가장 고귀한 별
- 천기성: 지혜, 계획, 변화
- 태양성: 광명, 남성, 권위
- 태음성: 온화, 여성, 은혜
- 탐랑성: 욕망, 다재다능
- 거문성: 어두움, 변동
- ...그 외 천동, 염정, 무곡, 파군, 칠살, 천상, 천량, 천부
4. 대한 (Daehan)
10년 주기 운명의 흐름:
대한[갑자].palace: 해당 대한의 주궁대한[갑자].age_range: 적용 연령(예:"22 ~ 31")대한[갑자].daehan_palaces_branches: 대한 기간 동안 12궁이 차지하는 지지대한[갑자].inner_palaces: 주요 발생 궁위 (사건이 일어나는 곳)대한[갑자].outer_palaces: 외부 환경/타인으로부터 영향대한[갑자].daehan_sahwa: 대한 사화(록·권·과·기)의 위치와 진위(is_jin)대한[갑자].secondary_occurrence_palaces,problem_palaces,secondary_result_palaces: 이차 발생/주의/결과 궁위
5. 유년운 (Annual Fortune)
특정 연도의 세부 운세:
유년십이궁: 간지별로 이동한 12궁 위치 (original_palace_name,annual_palace_name,branch)유년사화: 해당 연도의 사화(四化) - 각 지지에 록·권·과·기가 배정됩니다.유년천마: 이동·변동을 일으키는 천마성 위치유년천괴천월: 귀인성 두 개의 위치(유괴,유월)유년녹존타라경양: 재물·권력·갈등을 나타내는 별(녹존, 타라, 경양)의 위치유년문창문곡: 문운을 담당하는 문창/문곡성 위치유년이차발생궁,유년문제궁위: 부차적 발생궁과 주의해야 할 궁위 리스트
명반 해석
명궁 중심 분석
// 명궁 확인
const mingPalace = data.명궁;
console.log('명궁 위치:', mingPalace);
// 명궁에 있는 별 확인
const mingStars = data['14정성 및 보좌성'][mingPalace];
console.log('명궁의 별:', mingStars);
// 명궁이 어느 오행인지 확인
const palaceElements = {
'자': '수', '축': '토', '인': '목', '묘': '목',
'진': '토', '사': '화', '오': '화', '미': '토',
'신': '금', '유': '금', '술': '토', '해': '수'
};
console.log('명궁 오행:', palaceElements[mingPalace]);대한 시기 찾기
// 현재 대한 찾기 (대한 객체 → 배열 변환)
function flattenDaehan(daehanMap) {
return Object.entries(daehanMap).map(([pillar, info]) => {
const [start, end] = info.age_range.split('~').map((v) => parseInt(v.trim(), 10));
return { pillar, start, end, ...info };
});
}
function getCurrentDaehan(daehanList, currentAge) {
return daehanList.find((item) => currentAge >= item.start && currentAge <= item.end) ?? null;
}
const currentYear = new Date().getFullYear();
const birthYear = 1985;
const currentAge = currentYear - birthYear + 1;
const daehanList = flattenDaehan(data.대한);
const currentDaehan = getCurrentDaehan(daehanList, currentAge);
if (currentDaehan) {
console.log(`현재 나이 ${currentAge}세의 대한: ${currentDaehan.pillar}`);
console.log('대한 궁위:', currentDaehan.palace);
console.log('내궁(발생궁):', currentDaehan.inner_palaces);
console.log('외궁(외부 영향):', currentDaehan.outer_palaces);
console.log('대한 사화:', currentDaehan.daehan_sahwa);
} else {
console.log('아직 대한이 시작되지 않았습니다.');
}유년 운세 분석
// 유년십이궁에서 관록궁 위치 찾기
const annualPalaces = data.유년십이궁;
const careerPalace = annualPalaces.find(
(palace) => palace.annual_palace_name === '관록궁'
);
if (careerPalace) {
console.log('올해 관록궁(직업/사업):');
console.log('간지:', careerPalace.ganji);
console.log('위치(지지):', careerPalace.branch);
}
// 유년 사화(록·권·과·기) 확인
const sihua = data.유년사화;
Object.entries(sihua).forEach(([branch, sahwaList]) => {
console.log(`${branch} 궁에 적용되는 사화: ${sahwaList.join(', ')}`);
});
// 천마·귀인 등 추가 별 위치
console.log('유년 천마:', data.유년천마);
console.log('유년 천괴/천월:', data.유년천괴천월);
console.log('유년 녹존·타라·경양:', data.유년녹존타라경양);
console.log('유년 문제 궁위:', data.유년문제궁위);차트 유형
현재 공개된 자미두수 API는 /v1/jami/analysis 하나로 명반·대한·유년 데이터를 모두 제공합니다. 별도의 차트 전용 엔드포인트 없이도 응답 내 십이궁, 14정성 및 보좌성, 궁별_성_배치 등을 활용해 궁위별 정보를 추출할 수 있습니다.
모범 사례
✅ 정확한 출생 시간 필수
자미두수는 2시간(1시진) 단위로 명궁이 변하므로 정확한 출생 시간이 매우 중요합니다. 출생 시간이 불확실하다면 가족 증빙이나 추가 문서를 통해 시간을 확정한 뒤 요청을 보내세요.
✅ 간지 확인
target_year_ganji는 정확한 간지 표기가 필요합니다. 년도를 간지로 변환하는 별도 API나 참조 테이블을 활용하세요.
✅ 복합 분석
자미두수는 사주와 함께 분석하면 더 정확한 해석이 가능합니다. 통합 분석 API를 활용하여 동서양 명리학을 결합하세요.
✅ 캐싱 활용
기본 명반은 변하지 않으므로 캐싱하여 사용하고, 유년운만 매년 새로 조회하면 API 사용량을 줄일 수 있습니다.
주요 용어
| 용어 | 설명 |
|---|---|
| 명반 (命盤) | 자미두수 차트, 12궁과 별의 배치도 |
| 12궁 (十二宮) | 인생의 12개 영역을 나타내는 궁위 |
| 14정성 (十四正星) | 자미두수의 주요 14개 별 |
| 보좌성 (輔佐星) | 정성을 보조하는 별들 |
| 사화 (四化) | 록(祿), 권(權), 과(科), 기(忌)의 4가지 변화 |
| 대한 (大限) | 10년 주기 운명의 큰 흐름 |
| 유년 (流年) | 특정 연도의 운세 |
다음 단계
자미두수 API를 마스터했다면, 다음 기능들을 살펴보세요: