結婚相談・ウェディング・引越・不動産・アプリの各サービスが、自社の画面の中で四柱推命・相性・択日・日運を使えるように。正統命理の判定エンジンを REST API で提供します。応答は JSON ひとつです。
月 1,000 回まで無料です。承認手続きはなく、その場で鍵が出ます——契約前に実際に組み込んでご判断ください。上限に達すると止まるだけで、追加で請求される金額はありません。
四柱推命 API はすでにいくつもあります。私たちが違うのは三点です。
判定はルールエンジンが行い、AI は説明だけを担います。生成 AI に尋ねると同じ人に毎回違う答えが返り、他社サービスに組み込めません。私たちの応答は再現します——お客様から問い合わせが来ても、そのときの値をもう一度取り出せます。
元嗔殺・鬼門関殺・三災など古典的根拠の弱い要素は判定に入れません。恐怖で売る構造を作らないため、導入されるサービスの信頼度を損ないません。
生年月日時は計算にのみ使い、そのまま破棄します。残すのは呼び出し回数だけです。貴社が個人情報の処理委託の負担を負う必要はありません。
발급받은 키를 x-klm-key 헤더에 넣어 호출합니다. 그게 전부입니다.
# Health check — does not count against your quota curl -H "x-klm-key: klm_live_..." \ https://klifemap.ai/api/v1/ping
判定値（格局・用神・五行など）は韓国語の用語で返ります。英語表記が必要な場合はお問い合わせください。
{ "ok": true, "version": "v1", "engine": "taekil-2.0.0", "at": "2026-08-01T03:16:29.867Z" }
Content-Type: application/json です。calendar で新暦・旧暦・閏月を区別し、出生時刻が不明な場合は timeUnknown: true を送ります（時柱を使わず、年・月・日柱のみで判定します）。longitude は真太陽時補正に使います（既定 127.0 — 韓国標準）。四つです。応答フィールドは追加されることはあっても、削除や改名はしません——どうしても必要になれば /api/v2 を新設します。
{
"year": 1990, "month": 5, "day": 15,
"hour": 10, "minute": 0,
"gender": "male", // male | female (required)
"calendar": "solar", // solar | lunar | lunar_leap
"timeUnknown": false, // birth time unknown
"longitude": 127.0, // true solar time correction
"daeunCount": 9 // how many luck cycles (1-12)
}
{
"ok": true, "version": "v1", "engine": "taekil-2.0.0",
"result": {
"items": { /* The four pillars — stem, branch, element, yin/yang */ },
"gyeok": {
"name": "칠살격", "sipsung": "편관",
"sunyong": false, // true = favourable structure (4 kinds) · false = adverse structure (4 kinds)
"fromMonthBranch": { … }, "exposed": false
},
"yongsin": {
"element": "수", // the useful god
"helper": "금", // the helpful god
"avoid": "토", // the taboo god
"eokbu": "수", "johu": { … }, "rule": "…"
},
"strength": { "level": "신약(身弱)", "isStrong": false, "relation": { … } },
"daeun": { "forward": true, "startAge": 7, "list": [ … ] },
"relations": { /* Clashes and combinations within the natal chart */ },
"pagyeok": { /* Whether the structure is broken */ },
"sinsal": [ /* The 12 Sinsal — four of them, keyed to the day branch */ ]
}
}
{
"personA": { "year": 1990, "month": 5, "day": 15, "hour": 10, "gender": "male" },
"personB": { "year": 1992, "month": 8, "day": 3, "hour": 14, "gender": "female" }
}
{
"ok": true,
"result": {
"totalScore": 66,
"axes": { /* Per-axis scores — day stem, day branch, useful god, clash/combination */ },
"notes": [ "일지끼리 육합을 이루어…" ]
}
}
{
"birth": { "year": 1990, "month": 5, "day": 15, "hour": 10, "gender": "male" },
"year": 2026, "month": 9,
"category": "결혼" // wedding | moving | opening | contract | surgery …
}
{
"ok": true,
"best": [
{ "date": "2026-09-08", "score": 100, "tier": "대길", "reasons": [ "일진이 일지와 육합을…" ] },
{ "date": "2026-09-20", "score": 80, "tier": "길", "reasons": [ … ] }
],
"results": [ /* Score for every day in that month */ ]
}
{
"date": "2026-08-15",
"birth": { "year": 1990, "month": 5, "day": 15, "hour": 10, "gender": "male" } // optional
}
{
"ok": true,
"result": {
"date": "2026-08-15",
"dayGan": { "ko": "신", "hanja": "辛", "oheng": "금" },
"dayJi": { "ko": "유", "hanja": "酉", "oheng": "금" },
"forPerson": { /* Today's effect against the useful god — only when birth is supplied */ }
}
}
{
"ok": true,
"quota": { "monthly": 30000, "used": 4127, "ratePerMin": 120 },
"daily": [ { "day": "2026-08-01", "endpoint": "taekil", "calls": 312, "errors": 0 } ]
}
なぜ失敗したのかをコードで区別します。「動かないが理由が分からない」がサポート費用の大半だからです。
| HTTP | error | 意味と対処 |
|---|---|---|
| 400 | invalid_input | fields にどの値が誤っていたかがそのまま入っています。 |
| 401 | missing_key / invalid_key | ヘッダー名は x-klm-key です（x-api-key ではありません）。 |
| 402 | quota_exceeded | 今月の上限に達しました。プランを上げれば直ちに解除されます。 |
| 403 | client_suspended | 契約状態が有効ではありません。 |
| 429 | rate_limited | 毎分の上限を超えました。Retry-After ヘッダーの秒数だけ待って再試行してください。 |
| 500 | engine_error | 当方の問題です。再試行しても同じ場合はお知らせください。 |
月額基本料に呼び出し数が含まれ、超えた分だけ従量で加算されます。表示金額は供給価（消費税別）です。
どのサービスにどう使われるかをお知らせください。想定呼び出し量を添えていただければ、それに合わせたプランをご提案します。
月 1,000 回の無料鍵をすぐにお渡しします。契約前に実際に組み込んでご判断ください。
適格請求書を発行します。使用量はいつでも /usage でご自身で確認できます。