Playground

輸入

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）

結果

請輸入兩人的出生年月日並點選「分析」。

程式碼範例

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，回想的脈絡也以輸入 token 計費）

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 金鑰後會顯示功能設定。