八字 API › 運勢走勢 API

運勢走勢 API

只要傳送一個人的出生年月日時，就會計算大運、流年、流月疊加在命盤（原局）上的走勢，以 JSON 回傳繪製圖表用的數值，以及運與命盤之間的關係清單。商品名稱為「運勢走勢」，一次處理一個人，不使用 LLM。

回傳內容

累積線 — 大運為命盤 + 大運，流年為命盤 + 當年大運 + 流年，數值截在 ±100 的線 (line)
各字比重 — 將運的單一字的比重，分為生扶、剋制、藏干、通根的數值 (share)
五神名稱 — 該字五行屬於用神、喜神、忌神、仇神、閑神中的哪一個，是名稱而不是分數 (shinRole)
刑沖會合 — 運的字與命盤字之間的關係清單與規則 ID，不計入分數 (relations·triples)
合解 — 大運、流年的字所觸動的命盤合、新形成的合，以及產生畫面文字用的代碼 (hapPulim)
合盤疊加用輸入 — 疊加多人時使用的用神五行、外顯字五行個數 (compatInputs)

縱軸數值的讀法

縱軸數值是「加上運的字之後的日干一方分數」。在命盤強弱總分上，加上每個運的字以與命盤相同的單字分數表（生扶、剋制、藏干、通根）評出的比重，再截在 ±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 },
        …

這是回應範例的開頭（命盤與第一個大運）。包含流年、流月、合解的回應與欄位說明請見參考文件。

價格

運勢走勢每次呼叫 ₩50（VAT 另計 · 含 VAT ₩55）。擴大範圍或加上流月，仍是相同的單次價格。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

取得一次的結果請儲存起來重複使用。 再次傳送相同請求會再次計費。相同出生年月日時、相同選項的計算結果相同，因此請把第一次的回應存入資料庫（例如以請求內容的雜湊值作為鍵），之後使用儲存的值就不會產生費用。像今日運勢這類會隨日期改變的結果，請把日期也放進鍵中，只在當天重複使用。

完整價目表

完整參考文件

完整參數表、回應欄位說明與錯誤代碼都在參考文件中：運勢走勢 API 參考文件。其他八字商品請見所有八字 API。

聯絡我們：contact@float.do · 營運：FLOAT Co., Ltd.