一分钟接入
请求
curl -s https://api.ziweilu.cn/v1/chart \
-H 'Content-Type: application/json' \
-d '{"solar":"1990-05-15","hour":7,"gender":"男","city":"南京"}'返回 200：soulBranch / bodyBranch / fiveElements / majorStars / palaces（十二宫）/ mutagens（生年四化）/ decades（大限）/ hash。
hour 为时辰索引：0=早子时(23:00–00:59)，1=丑时 …… 12=晚子时。错误码：400 参数错、422 日期非法、429 限流。
核对 hash
curl -s https://api.ziweilu.cn/v1/chart -H 'Content-Type: application/json' \
-d '{"solar":"1990-05-15","hour":7,"gender":"男"}' | python3 -c '
import sys,json,hashlib
d=json.load(sys.stdin); h=d.pop("hash")
c=json.dumps(d,ensure_ascii=False,sort_keys=True,separators=(",",":"))
print("local:",hashlib.sha256(c.encode()).hexdigest()[:16],"api:",h)'规则：删掉 hash → 键名递归升序 → 无空格序列化 → sha256 前 16 位。
MCP
两个 tool：ziwei_chart（返回 facts + hash）、ziwei_interpret（v1 未开放，固定 501，不编造解读）。
{"mcpServers":{"ziweilu":{"command":"node","args":["/opt/ziwei-facts/mcp.js"]}}}HTTP 方式：把 JSON-RPC 2.0 请求 POST 到 https://api.ziweilu.cn/mcp，先 initialize，再 tools/list / tools/call。
价格
商用
¥299/月
10 万次/月，独立额度，可开票。适合产品集成、批量排盘、Agent 工作流。
解读按份
¥3–9/份
针对具体问题的人工/半自动解读，按份计费，不做无限次承诺。
付费走站内支付宝通道；未登录会先跳登录，支付完成后回到本页。额度按订单发放，可在账户页查看。
常见问题
为什么你们的排盘是「确定」的？
排盘由服务端规则引擎（iztro 2.6.3，MIT 许可）计算，不经过大模型。同一组出生信息任何时候调用都返回同一份事实，并附 hash 供你核对。大模型生成的说法每次都可能不同，这里不会。
接口会返回吉凶结论吗？
不会。只返回命宫/身宫地支、五行局、命宫主星、十二宫、生年四化与大限等结构化事实，不做吉凶预测或建议。
会不会存我的生日数据？
接口无状态、无数据库，请求体不落盘；访问日志只记录 IP、路径、状态码与耗时。
额度超了怎么办？
免费档每 IP 每天 100 次，超出返回 429 与 retryAfterSec；需要稳定额度走商用档。
解读服务现在能用吗？
ziwei_interpret 在 v1 固定返回 501 占位，不生成任何解读文本；需要解读走按份付费通道。