aov-mingyu-api

name	aov-mingyu-api
description	通过 aov.cc 公开 API 调用命理、占卜和一站式提示词能力。用于需要八字排盘、紫微斗数排盘、六爻、梅花易数、奇门遁甲、大六壬、小六壬、塔罗、三山国王灵签、黄历择日、雷诺曼、星盘，或直接返回可交给 AI 解读的完整提示词的任务。

AOV 命理与占卜 API

使用 https://aov.cc/api/v1 作为基础地址。所有接口返回统一 JSON：

{
  "ok": true,
  "data": {},
  "meta": {
    "service": "aov.cc",
    "version": "v1"
  }
}

错误响应：

{
  "ok": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "错误说明"
  },
  "meta": {
    "service": "aov.cc",
    "version": "v1"
  }
}

工作流

1. 先读取 GET /manifest 或 GET /openapi.json 确认接口能力。
2. 只需要结构化数据时，调用 /calculate 或 /divination/{method} 排盘接口。
3. 需要 AI 解读提示词时，优先调用对应 /prompt 一站式接口，直接读取 data.result 和 data.prompt；占卜类接口还会返回 data.summary。
4. 向用户展示结果时，说明这是排盘和提示词数据，不替代医疗、法律、投资等专业建议。

常用接口

• GET /health：健康检查。
• GET /manifest：API 元数据、OpenAPI 地址和 skill 地址。
• GET /openapi.json：完整 OpenAPI JSON。
• POST /bazi/calculate：八字排盘。
• POST /bazi/prompt：八字排盘并生成结构化 AI 解读提示词。
• POST /ziwei/calculate：紫微斗数排盘。
• POST /ziwei/prompt：紫微斗数排盘并生成结构化 AI 解读提示词。
• POST /divination/liuyao：六爻起卦。
• POST /divination/liuyao/prompt：六爻起卦并生成结构化 AI 解读提示词。
• POST /divination/meihua：梅花易数起卦。
• POST /divination/meihua/prompt：梅花易数起卦并生成结构化 AI 解读提示词。
• POST /divination/xiaoliuren：小六壬起课。
• POST /divination/xiaoliuren/prompt：小六壬起课并生成结构化 AI 解读提示词。
• POST /divination/qimen：奇门遁甲排盘。
• POST /divination/qimen/prompt：奇门遁甲排盘并生成结构化 AI 解读提示词。
• POST /divination/liuren：大六壬排盘。
• POST /divination/liuren/prompt：大六壬排盘并生成结构化 AI 解读提示词。
• POST /divination/tarot：塔罗抽牌。
• POST /divination/tarot/prompt：塔罗抽牌并生成结构化 AI 解读提示词。
• POST /divination/ssgw：三山国王灵签求签。
• POST /divination/ssgw/prompt：三山国王灵签求签并生成结构化 AI 解读提示词。
• POST /divination/almanac：黄历择日。
• POST /divination/almanac/prompt：黄历择日并生成结构化 AI 解读提示词。
• POST /divination/lenormand：雷诺曼抽牌。
• POST /divination/lenormand/prompt：雷诺曼抽牌并生成结构化 AI 解读提示词。
• POST /divination/astrolabe：星盘生成。
• POST /divination/astrolabe/prompt：星盘生成并生成结构化 AI 解读提示词。

请求示例

八字排盘：

curl -X POST https://aov.cc/api/v1/bazi/calculate \
  -H "Content-Type: application/json" \
  -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar"}'

紫微斗数排盘：

curl -X POST https://aov.cc/api/v1/ziwei/calculate \
  -H "Content-Type: application/json" \
  -d '{"name":"测试","gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4}'

八字排盘并生成提示词：

curl -X POST https://aov.cc/api/v1/bazi/prompt \
  -H "Content-Type: application/json" \
  -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar","question":"我适合创业还是上班？","promptTopic":"career"}'

紫微斗数排盘并生成提示词：

curl -X POST https://aov.cc/api/v1/ziwei/prompt \
  -H "Content-Type: application/json" \
  -d '{"name":"测试","gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4,"question":"我的感情关系要注意什么？","promptTopic":"relationship","promptScope":"origin"}'

塔罗抽牌：

curl -X POST https://aov.cc/api/v1/divination/tarot \
  -H "Content-Type: application/json" \
  -d '{"spreadType":"single"}'

塔罗抽牌并生成提示词：

curl -X POST https://aov.cc/api/v1/divination/tarot/prompt \
  -H "Content-Type: application/json" \
  -d '{"spreadType":"single","question":"我近期事业应该注意什么？"}'

按自定时间起卦并生成提示词：

curl -X POST https://aov.cc/api/v1/divination/liuyao/prompt \
  -H "Content-Type: application/json" \
  -d '{"customDate":"2025-01-01T08:30:00+08:00","question":"这个项目现在适合推进吗？"}'

黄历择日：

curl -X POST https://aov.cc/api/v1/divination/almanac \
  -H "Content-Type: application/json" \
  -d '{"topic":"move","startDate":"2026-06-01","endDate":"2026-06-05","participants":[{"id":"self","name":"本人","gender":"男","year":1990,"month":1,"day":1,"timeIndex":12,"dateType":"solar"}]}'

星盘生成：

curl -X POST https://aov.cc/api/v1/divination/astrolabe \
  -H "Content-Type: application/json" \
  -d '{"name":"本人","gender":"女","year":1995,"month":5,"day":20,"hour":12,"minute":30,"latitude":39.9042,"longitude":116.4074,"timezone":8,"locationName":"北京"}'

参数约定

通用参数：

• gender：八字和紫微使用 male 或 female；黄历择日和星盘使用 男、女 或空字符串。
• dateType：使用 solar（阳历）或 lunar（农历）。
• timeIndex：范围为 0 到 12，其中 0 为早子时，1 为丑时，...，11 为亥时，12 为晚子时。
• isLeapMonth：布尔值，仅农历有效。
• useTrueSolarTime：布尔值，启用真太阳时校正。八字和紫微开启后需提供 birthHour、birthMinute、birthLongitude，此时 timeIndex 由程序自动换算；星盘开启后使用 hour、minute 和 longitude 校正。

八字 promptTopic 支持以下主题： general（综合）、recent（近期）、career（事业）、job-change（跳槽）、startup-partnership（创业合作）、investment-partnership（投资合作）、wealth（财运）、marriage（婚恋）、relationship-push（感情推进）、relationship-decision（关系去留）、reconciliation-decision（复合判断）、children（子女）、family（家庭）、home-move（搬家置业）、settle-relocate（定居换城）、social（人际合作）、emotion（情绪心理）、health（健康）、parents（父母）、study（学业）、study-advance（考证进修）、exam-landing（考试上岸）、growth（成长方向）、talent（天赋特质）。

紫微 promptTopic 支持以下主题： destiny（命局）、relationship（感情）、relationship-push（感情推进）、relationship-decision（关系去留）、career-wealth（事业财运）、job-change（工作变动）、startup-partnership（创业合作）、investment-partnership（投资合作）、recent（近期趋势）、family（六亲家庭）、home-move（搬家置业）、settle-relocate（定居换城）、social（人际合作）、emotion（情绪心理）、health（健康养护）、study（学业成长）、study-advance（考证进修）、exam-landing（考试上岸）、growth（成长方向）、talent（天赋特质）、reconciliation-decision（复合判断）、life（人生解析）、chat（自由聊天）。

紫微 promptScope 支持：origin（本命）、decadal（大限）、yearly（流年）、monthly（流月）、daily（流日）、hourly（流时）、age（年龄）。

promptMode 支持：framework（内置完整框架，默认）、custom（只围绕用户问题自由作答，不塞框架）。

占卜时间参数：

• customDate：六爻、梅花易数、小六壬、奇门遁甲、大六壬可用该字段指定起卦或排盘时间；不提供则使用当前时间。必须传带时区的 ISO 8601 时间字符串，例如 2025-01-01T08:00:00+08:00。

占卜通用参数：

• question：所有 /prompt 接口的必填字段，黄历择日 /prompt 中可不填。
• supplementaryInfo：对象类型，占卜补充信息。

各占卜方法特有参数：

• 梅花易数 method：time（时间起卦）、number（数字起卦）、random（随机起卦）、external（外应起卦）。method 为 number 时需提供 number（正整数）；method 为 external 时需提供 externalOmens，至少两项可映射外应，并提供 count 作为动爻数量，例如 {"direction":"南","object":"火电文书","count":3}。
• 小六壬 xiaoliurenMethod：time、number、random。number 时需提供 xiaoliurenNumber（正整数）。
• 塔罗 spreadType：single（单牌指引）、three（时间流）、love（爱情）、career（事业）、decision（选择）。
• 六爻 liuyaoTemplate：general（通用）、ganqing（感情）、shiye（事业）、caifu（财运）、guaishen（鬼神怪异）。
• 大六壬 liurenTemplate：general（通用）、ganqing（感情）、shiye（事业）、caifu（财富）。
• 黄历择日 topic：marriage（嫁娶）、move（搬家）、opening（开业）、contract（签约）、travel（出行）、medical（求医）、study（求学）、custom（自定义）。
• 黄历择日 startDate、endDate：日期范围字符串。participants：参与者数组，每人包含 id、name、gender、year、month、day、timeIndex、dateType、isLeapMonth。
• 雷诺曼 spreadType：single、three、relationship、decision、nine。
• 星盘 year、month、day、hour、minute：出生时间。latitude、longitude：经纬度。timezone：时区偏移。locationName：地点名称。可传 useTrueSolarTime 启用真太阳时校正；提示词接口可传 astrolabeTopic 和 astrolabeScopeText，用于写入本命、流年、流月或流日分析对象。