| 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"
}
}
工作流
- 先读取
GET /manifest 或 GET /openapi.json 确认接口能力。
- 只需要结构化数据时,调用
/calculate 或 /divination/{method} 排盘接口。
- 需要 AI 解读提示词时,优先调用对应
/prompt 一站式接口,直接读取 data.result 和 data.prompt;占卜类接口还会返回 data.summary。
- 向用户展示结果时,说明这是排盘和提示词数据,不替代医疗、法律、投资等专业建议。
常用接口
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,用于写入本命、流年、流月或流日分析对象。