四柱推命API › 四柱推命解釈API

四柱推命解釈API

生年月日時と質問を送ると、サーバーが四柱推命（サジュ）の命式を計算してAIに渡し、AIが質問に合わせた解釈を返します。四柱推命は、生まれた年・月・日・時から人を読み解く韓国でも広く使われている占術です。商品名は「AI四柱推命リーディング」で、会話を覚える「AI四柱推命リーディング・メモリー」と、質問なしで一度に受け取る「四柱推命レポート」が同じシリーズです。レスポンスには内部のプロンプトや理論は含まれず、解釈だけが返ります。

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

3つの呼び出し方

単発の相談 POST /reading — 1つの質問に1つの解釈。レスポンスは最大2,000文字です。
続きの相談 POST /reading/memory — HRUM がエンドユーザーごとに会話の記憶を保持し、戻ってきたときは前の文脈を引き継いで解釈します。
ワンショットレポート POST /reading/report — 総論・財運・恋愛・大運などセクションごとのレポートを、質問なしで一度に返します（最大12セクション）。

追加できるもの

紫微斗数・西洋占星術・夢占い・タロットの根拠を解釈に加えたり、そのうち1つだけを呼んだりできます（only）。その日の日柱（四柱推命の暦で今日がどこにあたるか）は、別に呼ばなくてもすべての解釈に反映されます。出生時刻（hour）を省くと時柱を外し、年・月・日の三柱で解釈します。

リクエスト例

単発の相談 (/reading)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "올해 이직해도 괜찮을까요?",
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
    "maxLength": 600,
    "tone": "warm"
  }'

続きの相談 (/reading/memory)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/memory \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "endUserId": "member-1024",
    "question": "지난번에 얘기한 이직 건, 다음 달에 움직여도 될까요?",
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" }
  }'

ワンショットレポート (/reading/report)

curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/report \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
    "sections": ["총평", "재물운", "연애·인연"]
  }'

認証は X-Partner-Api-Key ヘッダーで行い、ベースURLは https://api.hrum.ai/api/v1/partners/v1です。Python と JavaScript の例、エラー処理ははじめにガイドにあります。

レスポンス例 (/reading)

{
  "success": true,
  "data": {
    "interpretation": "당신의 사주에서 보이는 특징은...",
    "sajuSource": "computed",
    "usage": {
      "inputTokens": 450,
      "outputTokens": 280
    },
    "costPoints": 18
  }
}

costPoints はこの呼び出しで差し引かれた金額です。メモリーモードとレポートモードのレスポンスフィールドはリファレンスにあります。

料金

AI四柱推命リーディングは入力 1Mトークンあたり ₩2,888（VAT別、VAT込み ₩3,177）、出力 1Mトークンあたり ₩23,100（VAT別、VAT込み ₩25,410）です。AI四柱推命リーディング・メモリーは入力 1Mトークンあたり ₩3,754（VAT別、VAT込み ₩4,129）、出力 1Mトークンあたり ₩30,030（VAT別、VAT込み ₩33,033）です。四柱推命レポートはトークン課金のため1回あたりの固定料金はなく、目安の範囲は料金表をご覧ください。AIに渡す計算済みの命式とシステムプロンプトは課金されず、質問・ペルソナ・回答のトークンだけが課金されます。ほかの項目を加えると、その根拠ブロックが入力トークンに加わり、項目ごとの固定料金もかかります。成功した呼び出しだけがプリペイドのクレジットから差し引かれ、4xx・5xx のエラーレスポンスは課金されません。

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

料金一覧

リファレンス全体

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

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