プレイグラウンド

入力

APIキー

APIキーなしでも月5回まで無料でテストできます。

年

月

日

時

分

タイムゾーン

性別

男性女性

結果

生年月日を入力して「計算する」を押してください。

コード例

cURL

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "timezone": "Asia/Seoul",
    "gender": "male"
  }'

入力

APIキー

APIキーなしでも月5回まで無料でテストできます。

年

月

日

時

分

緯度

経度

時刻の精度

性別

男性女性

結果

生年月日を入力して「計算する」を押してください。

コード例

cURL

curl -X POST https://api.hrum.ai/api/v1/partners/v1/natal-chart \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDate": "2000-01-15",
    "birthTime": "14:30",
    "birthLatitude": 37.57,
    "birthLongitude": 126.98,
    "birthTimePrecision": "exact",
    "gender": "male"
  }'

入力

APIキー（必須）

相性分析にはAPIキーが必要です。

人物A

生年月日

性別

出生時刻（任意、HH:MM）

人物B

生年月日

性別

出生時刻（任意、HH:MM）

結果

2人の生年月日を入力して「分析する」を押してください。

コード例

cURL

curl -X POST https://api.hrum.ai/api/v1/partners/v1/compat \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "personABirthDate": "2000-01-15",
    "personABirthTime": "14:30",
    "personAGender": "male",
    "personBBirthDate": "2002-06-20",
    "personBBirthTime": "09:45",
    "personBGender": "female"
  }'

入力

APIキー（任意）

プレミアム版の質問セット（93問）にはAPIキーが必要です。

バージョン

無料ライト版（24問）プレミアム版（93問、₩10）

ランダムなサンプル回答を自動で入力します。

結果

サンプル回答を読み込んでから、テストを実行してください。

コード例

cURL（24問のサンプル）

curl -X POST https://api.hrum.ai/api/v1/partners/v1/personality-type \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "free",
    "answers": [
      {"questionId": "q001", "value": 3},
      {"questionId": "q002", "value": 4},
      ...
    ]
  }'

入力

APIキー（必須）

AI四柱推命リーディングにはAPIキーが必要です。

年

月

日

時（任意）

分（任意）

性別

男性女性

質問（必須）

ファイルを添付

AI分析してメモリーに保存

西洋占星術（ネイタルチャート）を含める

口調（任意）

最大文字数（任意）

結果

項目を入力して「リーディングする」を押してください。

コード例

cURL

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 '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "question": "Can you tell me about my life path and give me some advice?",
    "tone": "warm",
    "maxLength": 800
  }'

入力

APIキー（必須）

AI四柱推命リーディング・メモリーにはAPIキーが必要です。

エンドユーザーID（必須）

同じIDで呼び出すと、過去の文脈を踏まえて回答します。

年

月

日

時（任意）

分（任意）

性別

男性女性

質問（必須）

口調（任意）

西洋占星術（ネイタルチャート）を含める

結果

項目を入力して「リーディングする」を押してください。

コード例

cURL

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": "user_12345",
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "question": "Can you tell me about my life path and give me some advice?",
    "tone": "warm"
  }'

入力

APIキー（必須）

画像生成にはAPIキーが必要です。

年

月

日

時（任意）

分（任意）

性別

男性女性

スタイル（任意）

生成には20–30秒かかります。

結果

項目を入力して「画像を生成」を押してください。

コード例

cURL

curl -X POST https://api.hrum.ai/api/v1/partners/v1/image \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "style": "background"
  }'

入力

APIキー

テキストから画像を生成します（GoogleとOpenAIのモデルに対応）

プロンプト（必須）

モデル

サイズ

gpt-image は約40秒、google/fal は10–20秒かかります。

結果

プロンプトを入力して「画像を生成」を押してください。

コード例

cURL

curl -X POST https://api.hrum.ai/api/v1/partners/v1/images/generations \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "prompt": "A serene mountain landscape at sunset with golden clouds",
    "size": "1024x1024",
    "n": 1
  }'

入力

APIキー

メモリー管理APIは無料です（課金なし）。

エンドユーザーID（必須）

利用者ごとの一意のID

検索タグ（任意）

カンマ区切りのタグ（タグ検索用）

結果

エンドユーザーIDを入力して「取得」を押してください。

コード例

cURL — 取得

curl -X GET https://api.hrum.ai/api/v1/partners/v1/memory/user_123 \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

入力

同じモデルにメモリーエンジンを加えたものです。会話は endUserId ごとに自動で保存・想起されます（再販価格 ×1.30。想起した文脈は入力トークンとして課金されます）。

APIキー（必須）

x-partner-api-key ヘッダーで送信します。

モデル

ユーザーID（endUserId）

同じ endUserId のリクエストでは、サーバーが過去の文脈を自動で想起します（RIDMでは必須）。

メッセージ

要約の間隔（summaryEvery）

要約と感情状態を何ターンごとに更新するか（ridm/* のみ）

感情分析

感情分析（ridm/* のみ）。要約サイクルと一緒に実行され、追加料金はかかりません

ファイルを添付

AI分析してメモリーに保存

内容を分割・要約・タグ付けして保存します（RIDM方式）

結果

メッセージを入力して「送信」を押してください。

コード例

JavaScript (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.PARTNER_API_KEY,
  baseURL: 'https://api.hrum.ai/api/v1/partners/v1',
});

const response = await client.chat.completions.create({
  model: 'ridm/gpt-5.6-terra',
  user: 'user_123',  // endUserId
  messages: [
    { role: 'user', content: 'Hi! How is the weather today?' }
  ],
});

入力

元のモデルをそのまま使います（再販: 原価 × 為替レート ×1.10）。メモリー・感情・ファイルの自動想起はありません。メモリーが必要な場合はRIDMタブを使い、model に ridm/ プレフィックスを付けるだけです。

APIキー（必須）

x-partner-api-key ヘッダーで送信します。

モデル

ユーザーID（任意・再販ではメモリーを保存しません）

メッセージ

結果

メッセージを入力して「送信」を押してください。

コード例

JavaScript (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.PARTNER_API_KEY,
  baseURL: 'https://api.hrum.ai/api/v1/partners/v1',
});

const response = await client.chat.completions.create({
  model: 'openai/gpt-5.6-terra',
  messages: [
    { role: 'user', content: 'Hi! How is the weather today?' }
  ],
});

入力

APIキー（必須）

四柱推命レポートの生成にはAPIキーが必要です。

年

月

日

時（任意）

分（任意）

性別

男性女性

口調（任意）

ペルソナ（任意）

四柱推命レポートの生成には約30秒かかります。

結果

項目を入力して「四柱推命レポートを生成」を押してください。

コード例

cURL

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 '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "tone": "warm",
    "persona": "Talk casually, like a playful young fortune teller in her 20s"
  }'

機能設定

APIキーごとに有効な機能を管理します。APIキーがない場合は設定できません。

APIキーを入力すると機能設定が表示されます。