aov-mingyu-api

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AOV 命理与占卜 API

AOV Fortune-Telling & Divination API

使用

https://aov.cc/api/v1

作为基础地址。所有接口返回统一 JSON：

json

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

错误响应：

json

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

Use

https://aov.cc/api/v1

as the base URL. All interfaces return a unified JSON format:

json

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

Error response:

json

{
  "ok": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "Error description"
  },
  "meta": {
    "service": "aov.cc",
    "version": "v1"
  }
}

工作流

Workflow

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

First read
```
GET /manifest
```
or
```
GET /openapi.json
```
to confirm interface capabilities.
When only structured data is needed, call the calculation interfaces such as
```
/calculate
```
or
```
/divination/{method}
```
.
When AI interpretation prompts are needed, prioritize calling the corresponding
```
/prompt
```
one-stop interface, and directly read
```
data.result
```
and
```
data.prompt
```
; divination interfaces will also return
```
data.summary
```
.
When presenting results to users, note that this is calculation and prompt data, and does not replace professional advice such as medical, legal, or investment advice.

常用接口

Common Interfaces

```
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 解读提示词。

```
GET /health
```
: Health check.
```
GET /manifest
```
: API metadata, OpenAPI URL and skill URL.
```
GET /openapi.json
```
: Complete OpenAPI JSON.
```
POST /bazi/calculate
```
: Bazi Calculation.
```
POST /bazi/prompt
```
: Bazi Calculation and generate structured AI interpretation prompt.
```
POST /ziwei/calculate
```
: Zi Wei Dou Shu Calculation.
```
POST /ziwei/prompt
```
: Zi Wei Dou Shu Calculation and generate structured AI interpretation prompt.
```
POST /divination/liuyao
```
: Liu Yao Divination.
```
POST /divination/liuyao/prompt
```
: Liu Yao Divination and generate structured AI interpretation prompt.
```
POST /divination/meihua
```
: Meihua Yishu Divination.
```
POST /divination/meihua/prompt
```
: Meihua Yishu Divination and generate structured AI interpretation prompt.
```
POST /divination/xiaoliuren
```
: Xiao Liuren Divination.
```
POST /divination/xiaoliuren/prompt
```
: Xiao Liuren Divination and generate structured AI interpretation prompt.
```
POST /divination/qimen
```
: Qimen Dunjia Calculation.
```
POST /divination/qimen/prompt
```
: Qimen Dunjia Calculation and generate structured AI interpretation prompt.
```
POST /divination/liuren
```
: Da Liuren Calculation.
```
POST /divination/liuren/prompt
```
: Da Liuren Calculation and generate structured AI interpretation prompt.
```
POST /divination/tarot
```
: Tarot Card Drawing.
```
POST /divination/tarot/prompt
```
: Tarot Card Drawing and generate structured AI interpretation prompt.
```
POST /divination/ssgw
```
: SSGW Spirit Lot Drawing.
```
POST /divination/ssgw/prompt
```
: SSGW Spirit Lot Drawing and generate structured AI interpretation prompt.
```
POST /divination/almanac
```
: Chinese Almanac Date Selection.
```
POST /divination/almanac/prompt
```
: Chinese Almanac Date Selection and generate structured AI interpretation prompt.
```
POST /divination/lenormand
```
: Lenormand Card Drawing.
```
POST /divination/lenormand/prompt
```
: Lenormand Card Drawing and generate structured AI interpretation prompt.
```
POST /divination/astrolabe
```
: Astrolabe Generation.
```
POST /divination/astrolabe/prompt
```
: Astrolabe Generation and generate structured AI interpretation prompt.

请求示例

Request Examples

八字排盘：

bash

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"}'

紫微斗数排盘：

bash

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}'

八字排盘并生成提示词：

bash

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"}'

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

bash

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"}'

塔罗抽牌：

bash

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

塔罗抽牌并生成提示词：

bash

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

黄历择日：

bash

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"}]}'

星盘生成：

bash

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":"北京"}'

Bazi Calculation:

bash

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"}'

Zi Wei Dou Shu Calculation:

bash

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}'

Bazi Calculation and Generate Prompt:

bash

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"}'

Zi Wei Dou Shu Calculation and Generate Prompt:

bash

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"}'

Tarot Card Drawing:

bash

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

Tarot Card Drawing and Generate Prompt:

bash

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

Chinese Almanac Date Selection:

bash

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"}]}'

Astrolabe Generation:

bash

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":"北京"}'

参数约定

Parameter Conventions

通用参数：

```
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
```
，用于写入本命、流年、流月或流日分析对象。

General Parameters:

```
gender
```
: Use
```
male
```
or
```
female
```
for Bazi and Zi Wei Dou Shu; use
```
男
```
,
```
女
```
or empty string for Chinese Almanac date selection and astrolabe.
```
dateType
```
: Use
```
solar
```
(solar calendar) or
```
lunar
```
(lunar calendar).
```
timeIndex
```
: Range from
```
0
```
to
```
12
```
, where
```
0
```
is early Zi Shi,
```
1
```
is Chou Shi, ...,
```
11
```
is Hai Shi,
```
12
```
is late Zi Shi.
```
isLeapMonth
```
: Boolean value, only valid for lunar calendar.
```
useTrueSolarTime
```
: Boolean value, enable true solar time correction. For Bazi and Zi Wei Dou Shu,
```
birthHour
```
,
```
birthMinute
```
,
```
birthLongitude
```
are required after enabling, and
```
timeIndex
```
will be automatically converted by the program; for astrolabe, correction is done using
```
hour
```
,
```
minute
```
and
```
longitude
```
after enabling.

Supported

promptTopic

for Bazi:

general

(Comprehensive),

recent

(Recent),

career

(Career),

job-change

(Job Change),

startup-partnership

(Startup Partnership),

investment-partnership

(Investment Partnership),

wealth

(Wealth),

marriage

(Marriage & Love),

relationship-push

(Relationship Promotion),

relationship-decision

(Relationship Choice),

reconciliation-decision

(Reconciliation Judgment),

children

(Children),

family

(Family),

home-move

(House Moving & Property Purchase),

settle-relocate

(Settle Down & Relocate),

social

(Interpersonal Cooperation),

emotion

(Emotion & Psychology),

health

(Health),

parents

(Parents),

study

(Study),

study-advance

(Certification & Further Study),

exam-landing

(Exam Success),

growth

(Growth Direction),

talent

(Talent Traits).

Supported

promptTopic

for Zi Wei Dou Shu:

destiny

(Fate Chart),

relationship

(Relationship),

relationship-push

(Relationship Promotion),

relationship-decision

(Relationship Choice),

career-wealth

(Career & Wealth),

job-change

(Job Change),

startup-partnership

(Startup Partnership),

investment-partnership

(Investment Partnership),

recent

(Recent Trend),

family

(Relatives & Family),

home-move

(House Moving & Property Purchase),

settle-relocate

(Settle Down & Relocate),

social

(Interpersonal Cooperation),

emotion

(Emotion & Psychology),

health

(Health Care),

study

(Study & Growth),

study-advance

(Certification & Further Study),

exam-landing

(Exam Success),

growth

(Growth Direction),

talent

(Talent Traits),

reconciliation-decision

(Reconciliation Judgment),

life

(Life Analysis),

chat

(Free Chat).

Supported

promptScope

for Zi Wei Dou Shu:

origin

(Native Chart),

decadal

(Decade Luck),

yearly

(Annual Luck),

monthly

(Monthly Luck),

daily

(Daily Luck),

hourly

(Hourly Luck),

age

(Age).

Supported

promptMode

framework

(Built-in complete framework, default),

custom

(Answer freely around user's question without framework).

General Parameters for Divination:

```
customDate
```
: ISO 8601 time string with time zone, e.g.,
```
2025-01-01T08:00:00+08:00
```
; current time will be used if not provided.
```
question
```
: Required field for all
```
/prompt
```
interfaces, optional for Chinese Almanac date selection
```
/prompt
```
.
```
supplementaryInfo
```
: Object type, supplementary information for divination.

Method-Specific Parameters for Divination:

Meihua Yishu
```
method
```
:
```
time
```
(Divination by time),
```
number
```
(Divination by number),
```
random
```
(Random divination),
```
external
```
(Divination by external omens). When
```
method
```
is
```
number
```
,
```
number
```
(positive integer) is required; when
```
method
```
is
```
external
```
,
```
externalOmens
```
is required with at least two items mapping external omens, and
```
count
```
as the number of moving lines, e.g.,
```
{"direction":"南","object":"火电文书","count":3}
```
.
Xiao Liuren
```
xiaoliurenMethod
```
:
```
time
```
,
```
number
```
,
```
random
```
. When
```
number
```
is selected,
```
xiaoliurenNumber
```
(positive integer) is required.
Tarot
```
spreadType
```
:
```
single
```
(Single Card Guidance),
```
three
```
(Timeline),
```
love
```
(Love),
```
career
```
(Career),
```
decision
```
(Decision).
Liu Yao
```
liuyaoTemplate
```
:
```
general
```
(General),
```
ganqing
```
(Relationship),
```
shiye
```
(Career),
```
caifu
```
(Wealth),
```
guaishen
```
(Supernatural).
Da Liuren
```
liurenTemplate
```
:
```
general
```
(General),
```
ganqing
```
(Relationship),
```
shiye
```
(Career),
```
caifu
```
(Wealth).
Chinese Almanac Date Selection
```
topic
```
:
```
marriage
```
(Wedding),
```
move
```
(House Moving),
```
opening
```
(Business Opening),
```
contract
```
(Contract Signing),
```
travel
```
(Travel),
```
medical
```
(Medical Treatment),
```
study
```
(Study),
```
custom
```
(Custom).
Chinese Almanac Date Selection
```
startDate
```
,
```
endDate
```
: Date range strings.
```
participants
```
: Array of participants, each including
```
id
```
,
```
name
```
,
```
gender
```
,
```
year
```
,
```
month
```
,
```
day
```
,
```
timeIndex
```
,
```
dateType
```
,
```
isLeapMonth
```
.

Lenormand

spreadType

single

three

relationship

decision

nine

Astrolabe
```
year
```
,
```
month
```
,
```
day
```
,
```
hour
```
,
```
minute
```
: Birth time.
```
latitude
```
,
```
longitude
```
: Latitude and longitude.
```
timezone
```
: Time zone offset.
```
locationName
```
: Location name.
```
useTrueSolarTime
```
can be passed to enable true solar time correction; prompt interfaces can pass
```
astrolabeTopic
```
and
```
astrolabeScopeText
```
to write analysis objects such as native chart, annual luck, monthly luck or daily luck.