四柱推命API › 運勢フローAPI

運勢フローAPI

1人の生年月日時を送ると、大運・年運（歳運）・月運が命式にどう重なるかを計算し、グラフを描くための数値と、運と命式の関係の一覧をJSONで返します。四柱推命（サジュ）では、命式は生まれたときに決まる文字の組み合わせで、それぞれの運が自分の文字を持ち込んで命式と作用し合います。商品名は「運勢フロー」で、1回の呼び出しで1人を扱い、LLMは使いません。

はじめにガイドプレイグラウンド料金

返すもの

累積ライン — 大運は命式 + 大運、年運は命式 + その年の大運 + 年運。±100で頭打ち (line)
文字ごとの割合 — 運の1文字の割合を、生扶・剋制・蔵干・通根に分けたもの (share)
5つの役割名 — その文字の五行が、命式にとって用神（喜ぶ）・喜神（助ける）・忌神（嫌う）・仇神（害する）・閑神（中立）のどれにあたるか。点数ではなく名前です (shinRole)
合・沖・刑 — 運の文字と命式の文字の関係の一覧で、ルールID付き。点数には含めません (relations·triples)
解ける合 — 大運・年運の文字が触れる命式の合、新しくできる合、画面の文章を作るためのコード (hapPulim)
相性を重ねるための入力 — 用神の五行と、見えている文字の五行の数。複数人を重ねるときに使います (compatInputs)

縦軸の読み方

縦軸の値は「運の文字を加えた日干側の点数」です。命式の強弱の合計に、運の各文字を命式と同じ文字ごとの表（生扶・剋制・蔵干・通根）で採点した割合を足し、±100で頭打ちにしたものです。運の良し悪しを測るものではありません。強・中和・弱のラベルは命式そのもののものです。月運には累積ラインがなく、その月の割合だけを返します (delta)。

範囲と月運

range は年運の範囲です（新暦の年単位、最大101年）。生まれ年から生まれ年 + 100 までを一度取得し、画面で切り出すことをおすすめします。 monthsOfYear は月運12か月を計算する四柱推命上の年です（その年の立春（春の始まりの節気）から翌年の立春の直前まで）。省略すると、現在（韓国時間）が属する四柱推命上の年になります。 nullにすると月運の層はありません。

出生時刻・性別・出生地

birthTime がないと、時柱は不明として扱い、残りの6文字で計算し、 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 ヘッダーで行い、ベースURLは 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 です（VAT別、VAT込み ₩55）。範囲を広げても月運を付けても、1回分の料金のままです。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

一度受け取った結果は保存して再利用してください。 同じリクエストをもう一度送ると、また課金されます。同じ生年月日時と同じオプションならいつも同じ結果なので、最初のレスポンスをデータベースに保存し（例：リクエストボディのハッシュをキーに）、以降は保存した値を無料で使ってください。今日の運勢のように日付で変わる結果は、日付をキーに含め、その日のあいだだけ再利用してください。

料金一覧

リファレンス全体

パラメータ表の全体、レスポンスフィールドの説明、エラーコードはリファレンスにあります: 運勢フローAPI リファレンス。ほかの四柱推命商品は四柱推命APIすべてにあります。

お問い合わせ: contact@float.do · 運営: FLOAT Co., Ltd.