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/bazi/prompt \
  -H "Content-Type: application/json" \
  -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar","question":"近期工作发展如何？","promptTopic":"career","school":"mangpai"}'

紫微飞星派流派解读：

curl -X POST https://aov.cc/api/v1/ziwei/prompt \
  -H "Content-Type: application/json" \
  -d '{"gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4,"question":"2025年事业财运如何？","promptTopic":"career-wealth","promptScope":"yearly","school":"feixing"}'

奇门飞盘法排盘：

curl -X POST https://aov.cc/api/v1/divination/qimen/prompt \
  -H "Content-Type: application/json" \
  -d '{"qimenMethod":"feipan","question":"项目现在能推进吗？"}'

黄历安葬择日：

curl -X POST https://aov.cc/api/v1/divination/almanac \
  -H "Content-Type: application/json" \
  -d '{"topic":"burial","startDate":"2026-07-01","endDate":"2026-07-15"}'

黄历择日：

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（年龄）。公开 API 返回轻量排盘资料，默认只返回 origin；请求传入 promptScope 时，会返回 origin 加指定范围，包含分析对象、落宫与四化信息。

紫微排盘结果以 payloadByScope.origin.palaces 为主结构；接口同时提供 四化、fourMutagens、birthMutagens 和 gongList，方便 agent 直接读取生年四化和十二宫星曜。

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

八字 school 支持：traditional（传统派子平正法）、mangpai（盲派十神象法）、xinpai（新派调候流通）。不传则不附加流派指引。

紫微 school 支持：sanhe（三合派三方四正）、feixing（飞星派四化飞星链路）、sihua（四化派生年四化主线）。不传则不附加流派指引。

Python urllib 默认 User-Agent 可能被 Cloudflare 拦截；Python 调用时请显式设置正常 User-Agent，例如 curl/8.0.0 或业务自己的客户端名称。

占卜时间参数：

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

占卜通用参数：

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

各占卜方法特有参数：

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