四柱推命API

生年月日時（と性別・タイムゾーン）を送ると、四柱推命（サジュ）の計算と解釈がすぐにJSONで返ります。四柱推命は、生まれた年・月・日・時の4つの柱から人生を読み解く、韓国でも広く使われている占術です。このAPIは占いアプリ「INTA – Life is Timing」と同じ四柱推命エンジンで動き、節気（東アジアの太陽暦の季節の区切り）にもとづく命式、用神、格局、日干の強弱、大運・年運、神殺を古典の理論どおりに計算します。1つのキーですべての商品を呼び出せ、使った分だけウォン建てのクレジットから差し引かれます。

はじめにガイド キーなしで試す 料金

AIにアプリを作らせる — 無料の電子書籍（韓国語）

電子書籍を選ぶ（韓国語）オールインワン占いアプリ（韓国語）キャラクターチャットアプリ（韓国語）会員制Webアプリ（韓国語）

計算型APIと解釈型API

エンドポイント

ベースURLは https://api.hrum.ai/api/v1/partners/v1、認証は X-Partner-Api-Key ヘッダーで行います。

パス（リファレンス）商品（概要）返すもの
POST /manseryeok万歳暦四柱の命式、通変星、蔵干、十二運星、神殺、用神、格局、日干の強弱、大運・年運、Saju Identity
POST /ziwei-chart紫微斗数の命盤十二宮、主星・補佐星、生年四化、大限・流年（出生時刻が必要）
POST /compat相性二人の四柱推命と星座の相性、総合スコアと解釈文
POST /astrology西洋占星術トータル10天体、ハウス、アスペクト、品位と、あらかじめ書かれた解釈文
POST /saju-flow運勢フロー大運・年運・月運をグラフにする数値と、合・沖・刑の一覧
POST /today今日の運勢今日の日柱と日干の関係、良い時間帯と避けたい時間帯
POST /dream夢占い夢の内容から見つかったシンボル語（シンボルが見つからなければ課金なし）
POST /tarotタロット78枚のデッキから引いたカード、正位置/逆位置、意味とカード画像URL
POST /lifetime生涯四柱性格・財運・仕事・恋愛・健康・人間関係・アドバイスの7テーマの解釈文
POST /readingAI四柱推命リーディング質問に合わせたAIの相談と解釈 (/reading/memory は過去のセッションを覚えています)
POST /reading/report四柱推命レポート質問なしで、セクションごとの解釈を一度に

リクエスト例

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: $HRUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":15,"hour":12,"minute":0,"timezone":"Asia/Seoul","gender":"male"}'

レスポンスの形は {"success": true, "data": { … }}です。Python と JavaScript の例、エラー処理は はじめにガイドにあります。

料金

使った呼び出しの分だけプリペイドのクレジットから差し引かれます。計算型APIは1回ごとの固定料金、AI四柱推命リーディングは質問と回答のトークンだけが課金され、AIに渡す命式のデータは無料です。表示価格はVAT別です。

商品料金
商品ごとの料金は料金表をご覧ください

料金一覧 · キーがなくても プレイグラウンド で IP ごとに月5回まで試せます。新規登録のクレジットの条件は はじめにガイドにあります。

よくある質問

出生時刻がわからない場合は？

万歳暦は時柱と真太陽時だけを外し、用神・格局・日干の強弱などを年・月・日の三柱から計算します。紫微斗数の命盤には出生時刻が必要です。

結果を保存してもいいですか？

はい。計算型APIと生涯四柱は同じ入力なら同じ結果を返すので、保存して再利用することをおすすめします。もう一度呼ばなければ、再び課金されることはありません。

作ったアプリはどこでホスティングしますか？

同じコンソールの RIDM Apps アプリホスティング に GitHub リポジトリをつなぐとビルド・デプロイされ、アプリごとに専用の PostgreSQL データベースが付きます。

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