Playground

Input

API key

Without an API key you can test up to 5 times a month for free.

Year

Month

Day

Hour

Minute

Time zone

Gender

Male Female

Result

Enter a birth date and click Calculate.

Code example

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"
  }'

Input

API key

Without an API key you can test up to 5 times a month for free.

Year

Month

Day

Hour

Minute

Latitude

Longitude

Time precision

Gender

Male Female

Result

Enter a birth date and click Calculate.

Code example

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"
  }'

Input

API key (required)

Compatibility analysis requires an API key.

Person A

Birth date

Gender

Birth time (optional, HH:MM)

Person B

Birth date

Gender

Birth time (optional, HH:MM)

Result

Enter both birth dates and click Analyze.

Code example

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"
  }'

Input

API key (optional)

The premium question set (93 items) requires an API key.

Version

Free Lite (24 questions) Premium (93 questions, ₩10)

Fills in random sample answers automatically.

Result

Load sample answers, then run the test.

Code example

cURL (24-question sample)

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},
      ...
    ]
  }'

Input

API key (required)

AI Saju Reading requires an API key.

Year

Month

Day

Hour (optional)

Minute (optional)

Gender

Male Female

Question (required)

Attach a file

AI analysis — store in memory

Include Western astrology (natal chart)

Tone (optional)

Max length (optional)

Result

Fill in the details and click Get reading.

Code example

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
  }'

Input

API key (required)

AI Saju Reading · Memory requires an API key.

End-user ID (required)

Calls with the same ID take past context into account.

Year

Month

Day

Hour (optional)

Minute (optional)

Gender

Male Female

Question (required)

Tone (optional)

Include Western astrology (natal chart)

Result

Fill in the details and click Get reading.

Code example

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"
  }'

Input

API key (required)

Image generation requires an API key.

Year

Month

Day

Hour (optional)

Minute (optional)

Gender

Male Female

Style (optional)

Generation takes 20–30 seconds.

Result

Fill in the details and click Generate image.

Code example

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"
  }'

Input

API key

Text-to-image generation (Google and OpenAI models supported)

Prompt (required)

Model

Size

gpt-image takes ~40 seconds; google/fal take 10–20 seconds.

Result

Enter a prompt and click Generate image.

Code example

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
  }'

Input

API key

The memory management API is free (no charge).

End-user ID (required)

Your user's unique ID

Search tags (optional)

Comma-separated tags (for tag search)

Result

Enter an end-user ID and click Get.

Code example

cURL — Get

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"

Input

Same models plus a memory engine. Conversations are saved and recalled automatically per endUserId (resale price ×1.30; recalled context is billed as input tokens).

API key (required)

Sent in the x-partner-api-key header.

Model

User ID (endUserId)

Requests with the same endUserId get past context recalled automatically by the server (required for RIDM).

Message

Summary interval (summaryEvery)

How often (in turns) the summary and emotion state are refreshed — ridm/* only

Emotion analysis

Emotion analysis — ridm/* only; runs with the summary cycle at no extra charge

Attach a file

AI analysis — store in memory

Splits, summarizes and tags the content for storage (RIDM method)

Result

Type a message and click Send.

Code example

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?' }
  ],
});

Input

The original models as they are (resale: cost × exchange rate ×1.10). No automatic recall of memory, emotion or files — if you need memory, use the RIDM tab and just add the ridm/ prefix to model.

API key (required)

Sent in the x-partner-api-key header.

Model

User ID (optional · resale does not store memory)

Message

Result

Type a message and click Send.

Code example

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?' }
  ],
});

Input

API key (required)

Generating a Saju Report requires an API key.

Year

Month

Day

Hour (optional)

Minute (optional)

Gender

Male Female

Tone (optional)

Persona (optional)

Generating a Saju Report takes about 30 seconds.

Result

Fill in the details and click Generate Saju Report.

Code example

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"
  }'

Feature settings

Manage the features enabled for each API key. Settings are not available without an API key.

Enter an API key to see feature settings.