释玄斋玄学排盘 API

快速开始

无需注册即可先试用一次（每 IP 每小时 20 次），确认效果后再申请正式 Key。

1. 试调一次（无需 Key）

curl -X POST https://www.zjhl.fjzyi.com/api/calc/v1/demo/bazi \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":20,"hour":14,"gender":"男"}'

2. 申请 API Key

见页面底部「申请 Key」，或在站内「个人中心 → API 套餐充值」自助购买。

3. 正式调用

curl -X POST https://www.zjhl.fjzyi.com/api/calc/v1/bazi \
  -H "Authorization: Bearer $SXZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":5,"day":20,"hour":14,"gender":"男"}'

调用约定

功能列表

全部 28 项功能均为 POST /v1/{功能ID}，参数规格见下表，完整参数见机器可读规范。

价格

预付费积分包，按需购买，永不过期。

大批量采购（10000 积分以上）、私有部署与专属对接，请联系微信客服详谈。

大模型接入（OpenAI function-calling）

1. 取回工具清单：GET https://www.zjhl.fjzyi.com/api/calc/v1/openai-tools，返回一个 tools 数组（15 个玄学工具，无需鉴权）。
2. 随对话请求传给模型：{"model":"gpt-4o","tools":[...],"messages":[...]}。该格式通义、文心、豆包、DeepSeek、Kimi 通用。
3. 模型返回 tool_calls 时，去掉工具名的 sxz_ 前缀得到功能 ID，调用 POST /v1/{功能ID}，把 arguments 原样作为 JSON body。
4. 把响应的 data 字段作为 tool 消息回填，模型即可生成解读。

// Node.js 示例
const tools = await (await fetch(
  'https://www.zjhl.fjzyi.com/api/calc/v1/openai-tools')).json();

const res = await fetch('https://api.openai.com/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.OPENAI_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: '帮我排一下1990年5月20日下午2点的八字' }],
    tools: tools.tools
  })
});

// 模型请求调用某个工具时
// toolCall.function.name = 'sxz_bazi' → POST /v1/bazi
const body = JSON.parse(toolCall.function.arguments);
const r = await fetch('https://www.zjhl.fjzyi.com/api/calc/v1/bazi', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.SXZ_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
});
const result = await r.json();  // result.data 即排盘结果

Python 同理，把 tools.tools 传给 client.chat.completions.create(tools=...) 即可。

MCP 接入（推荐：模型自动发现）

支持 MCP 的客户端（Claude Desktop、Cursor、Cline、Trae、Coze、Dify 等）只需粘贴一段配置，模型即可自动发现并调用全部 28 项工具，无需手动列工具。

{
  "mcpServers": {
    "shixuanzhai": {
      "type": "http",
      "url": "https://www.zjhl.fjzyi.com/api/calc/mcp",
      "headers": {
        "Authorization": "Bearer 你的API_KEY"
      }
    }
  }
}

MCP 端点实现标准 JSON-RPC：tools/list 返回工具清单，tools/call 执行排盘。 客户端也可直接读取 MCP Server 描述 自动生成配置。

机器可读规范

供 API 市场导入、SDK 自动生成、以及 AI 爬虫索引使用。

申请 API Key

1. 自助购买（推荐）：登录本站 → 个人中心 → 「API 套餐充值」→ 微信支付 → 支付成功自动开通 Key 并显示在个人中心。
2. 人工申请：添加客服微信，说明用途（模型名 / 接入方式 / 预估日调用量），获取 Key 与报价。

常见问题