사주 API › 운 흐름 API

운 흐름 API

한 사람의 생년월일시를 보내면 대운·세운·월운이 원국 위에 얹히는 흐름을 계산해, 그래프를 그릴 숫자와 운·원국 사이의 관계 목록을 JSON으로 돌려줘요. 상품 이름은 「운 흐름」이고, 한 번에 한 사람이며 LLM은 쓰지 않아요.

시작 가이드 플레이그라운드 요금표

돌려주는 것

세로축 값 읽는 법

세로축 값은 「운 글자를 얹은 일간 쪽 점수」예요. 원국 강약 총점에 운 글자마다 원국과 같은 글자당 점수표(지원·통제·지장간·뿌리)로 매긴 몫을 더하고 ±100으로 자른 값이고, 운세의 좋고 나쁨을 재지 않아요. 신강·중화·신약 이름은 원국 것 그대로예요. 월운은 누적선 없이 그 달 운 몫(delta)만 줘요.

범위와 월운

range로 세운 범위(양력 연도, 최대 101년)를 정해요. 출생연도부터 출생연도+100까지 한 번 받아 두고 화면에서 잘라 쓰는 방식을 권해요. monthsOfYear는 월운 12칸을 계산할 사주 연도(그해 입춘부터 다음 해 입춘 전까지)예요. 생략하면 지금(한국 시각)이 속한 사주 연도이고, null이면 월운 층이 없어요.

출생 시각·성별·출생지

birthTime이 없으면 시주 미상으로 여섯 글자 기준으로 계산하고 hourKnown: false를 붙여요. gender가 없으면 대운 층이 없어요. 출생지(birthLatitude·birthLongitude·country)는 만세력 API와 같은 필드이고 같은 방식으로 진태양시 보정을 해요. 만세력에 보낸 위치를 운 흐름에도 그대로 보내야 두 결과가 같은 원국을 써요.

요청 예시

{
  "birthDate": "1990-05-15",
  "birthTime": "14:30",
  "calendar": "solar",
  "gender": "male",
  "timezone": "Asia/Seoul",
  "range": { "fromYear": 1990, "toYear": 2090 },
  "monthsOfYear": 2026
}

인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.

응답 예시 (발췌)

{
  "success": true,
  "data": {
    "engineVersion": "saju-flow-6",
    "kbVersion": "2026.10.11-7",
    "hourKnown": true,
    "natalAmbiguous": null,
    "natal": {
      "score": -37, "result": "중화", "level": "약약",
      "breakdown": { "season": -30, "support": 36, "control": -28, "hidden": -5, "root": 5 },
      "primaryYongshin": "토",
      "shin": { "yongshin": "토", "huishin": "화", "gishin": "목", "gushin": "수", "hanshin": "금" },
      "ruleIds": ["R-SAJU-STR-001", "R-SAJU-STR-018", "R-SAJU-STR-019", "R-SAJU-YONG-170"]
    },
    "daeun": [
      { "startYear": 1997, "endYear": 2006, "startAge": 7,
        "chars": [
          { "pos": "stem", "char": "임", "hanja": "壬", "ohaeng": "수", "sipsin": "식신", "shinRole": "gushin",
            "share": { "support": 0, "control": -8, "hidden": 0, "root": 0, "total": -8 } },
          { "pos": "branch", "char": "오", "hanja": "午", "ohaeng": "화", "sipsin": "정관", "shinRole": "huishin",
            "share": { "support": 0, "control": -10, "hidden": -5, "root": 0, "total": -15 } }
        ],
        "delta": -23, "line": { "value": -60, "clamped": false },
        …

응답 예시의 앞부분(원국과 첫 대운)이에요. 세운·월운·합 풀림까지 담긴 응답과 필드 설명은 레퍼런스에 있어요.

가격

운 흐름은 호출 1회에 ₩50(부가세 별도 · 부가세 포함 ₩55)이에요. 범위·월운을 늘려도 같은 1회 가격이에요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.

한 번 받은 결과는 저장해 두고 다시 쓰세요. 같은 요청을 다시 보내면 다시 과금돼요. 같은 생년월일시·같은 옵션이면 계산 결과가 같으니, 첫 응답을 DB에 저장하고(예: 요청 본문 해시를 키로) 다음부터는 저장한 값을 쓰면 비용이 들지 않아요. 오늘의 운세처럼 날짜에 따라 바뀌는 결과는 날짜도 키에 넣어 그날 하루만 다시 쓰세요.

전체 요금표

전체 레퍼런스

파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 운 흐름 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.

문의: contact@float.do · 운영: 플로트 주식회사