个人中心 - 灵汐AI

创建API密钥

密钥名称

使用次数限制（0表示不限制）

📖 API调用文档

🔐 认证方式

所有API请求必须在请求头中携带API密钥：

X-API-Key: sk-xxxxxxxxxxxxxxxx

📡 接口列表

1. 排盘接口

URL：POST /api/external/paipan

请求参数：

{
  "year": 1995, "month": 11, "day": 18,
  "hour": 9, "minute": 56, "gender": "male",
  "province": "广东省", "city": "广州市",
  "calendar": "solar", "name": "张三"
}

2. 八字测算接口

URL：POST /api/external/bazi

请求参数：同排盘接口，额外支持 customQuestion 自定义问题

{
  "year": 1995, "month": 11, "day": 18,
  "hour": 9, "minute": 56, "gender": "male",
  "customQuestion": "请详细分析事业财运"
}

返回结果：

{
  "success": true,
  "data": {
    "eightChar": "乙亥 丁亥 癸丑 丁巳",
    "result": "完整的八字分析报告...",
    "paipan": "排盘详细数据...",
    "actualModel": "deepseek-chat",
    "complexity": "simple"
  }
}

3. 合婚接口

URL：POST /api/external/hehun

请求参数：

{
  "maleYear": 1995, "maleMonth": 11, "maleDay": 18,
  "maleHour": 9, "maleMinute": 56,
  "femaleYear": 1987, "femaleMonth": 12, "femaleDay": 26,
  "femaleHour": 14, "femaleMinute": 2,
  "customQuestion": "请详细分析合婚"
}

4. 其他接口

POST /api/external/naming - 起名
POST /api/external/fengshui - 风水
POST /api/external/three-pass - 三传
GET /api/external/agents - 获取可用智能体列表

⭐ 5. 大师版接口（专业版）

大师版接口使用更高级的AI模型，分析更深入、更专业，适合需要深度解读的场景。具体算力扣除以管理后台智能体配置为准。

POST /api/external/master/bazi - 大师版八字深度分析
POST /api/external/master/hehun - 大师版合婚深度分析
POST /api/external/master/naming - 大师版专业起名
POST /api/external/master/fengshui - 大师版风水堪舆
POST /api/external/master/three-pass - 大师版三传精解

大师版八字请求示例：

{
  "year": 1995, "month": 11, "day": 18,
  "hour": 9, "minute": 56, "gender": "male",
  "customQuestion": "请深度分析事业财运和婚姻",
  "stream": true
}

大师版合婚请求示例：

{
  "maleYear": 1995, "maleMonth": 11, "maleDay": 18, "maleHour": 9,
  "femaleYear": 1987, "femaleMonth": 12, "femaleDay": 26, "femaleHour": 14,
  "customQuestion": "请深度分析两人婚姻匹配度和未来走势",
  "stream": true
}

📡 流式输出（SSE）

八字测算和合婚接口支持流式输出，在请求参数中添加 "stream": true 即可启用。流式输出使用 SSE（Server-Sent Events）协议，逐字推送报告内容。

流式输出数据格式：

// 第一条：元数据
data: {"type":"meta","eightChar":"乙亥 丁亥 癸丑 丁巳","actualModel":"deepseek-chat","complexity":"simple"}

// 中间条：报告内容（每100字一个chunk）
data: {"type":"content","content":"报告内容片段..."}

// 最后一条：完成信号
data: {"type":"done","totalLength":12345}

流式输出调用示例：

// 使用 fetch + ReadableStream
const response = await fetch('/api/external/bazi', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'sk-xxxxxxxxxxxxxxxx'
  },
  body: JSON.stringify({
    year: 1995, month: 11, day: 18,
    hour: 9, minute: 56, gender: 'male',
    stream: true
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = '';

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split('\n');
  buffer = lines.pop();
  for (const line of lines) {
    if (line.startsWith('data: ')) {
      const data = JSON.parse(line.slice(6));
      if (data.type === 'content') {
        console.log(data.content); // 逐字输出
      }
    }
  }
}

⚠️ 错误码说明

状态码	说明
200	请求成功
401	API密钥无效/已禁用/已过期/次数用尽
400	缺少必要参数
500	服务器内部错误/算力不足

💻 调用示例（cURL）

curl -X POST https://你的域名/api/external/bazi \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "year": 1995, "month": 11, "day": 18,
    "hour": 9, "minute": 56, "gender": "male"
  }'

📝 注意事项

API密钥请妥善保管，不要泄露给他人
算力不足时接口会返回错误，请及时充值
具体各接口算力扣除标准以管理后台智能体配置为准
建议设置合理的使用次数限制，防止密钥泄露后被滥用

🔑 API密钥管理

🎁 邀请得算力