婚介、婚庆、搬家、房产与各类应用，都可以在自己的产品内使用四柱、合婚、择日与每日运势。我们把正统命理判定引擎做成 REST API，返回一个 JSON。
每月 1,000 次免费。无需审批，密钥即时发放——签约前即可实际接入试用。额度用完即停止，不会额外计费。
市面上已有不少四柱 API。我们不同的地方有三点。
判定由规则引擎完成，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 自行确认。