加载接口文档…
八字起名
API输入父母姓氏与出生时间，基于「八字五行 + 五格数理 + 三才配置」综合评分生成高分名字候选，附寓意标签与全国重名预估。三个 action：naming（智能起名）/ duplicate（重名查询）/ bazi（八字查询）。内置 396 姓氏笔画 + 175 起名字 + 88 姓…
由 极数本源 提供·更新于 昨天
5K
累计调用
6ms
平均响应
100.00%
服务可用性
5,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每天 3,000 次 · 每秒 1 次
登录免费
当前方案每天 5,000 次 · 每秒 2 次
黄金会员
每天 50,000 次 · 每秒 10 次
钻石会员
每天 100,000 次 · 每秒 30 次
企业会员
企业接口额度 · QPS 120
接入文档
在线工具
接口请求地址
https://v1.apizero.cn/api/baby-naming
接口请求方式
POST
请求参数格式
FORM / QUERY / JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/baby-naming?action=bazi&birth_year=2026&birth_month=5&birth_day=10&birth_hour=8
接口信息备注
仅排出生八字与五行分析，不生成名字。需传出生年月日（时辰可选）。
请求参数说明
action（操作）string
必填 · 固定 bazi · 示例：bazi
birth_yearinteger
必填 · 出生年 2000–2100 · 示例：2026
birth_monthinteger
必填 · 出生月 1–12 · 示例：5
birth_dayinteger
必填 · 出生日 1–31 · 示例：10
birth_hourinteger
可选 · 出生时 0–23，默认 12 · 默认 12 · 示例：8
| 名称 | 类型 | 说明 |
|---|---|---|
| action（操作） | string | 必填 · 固定 bazi · 示例：bazi |
| birth_year | integer | 必填 · 出生年 2000–2100 · 示例：2026 |
| birth_month | integer | 必填 · 出生月 1–12 · 示例：5 |
| birth_day | integer | 必填 · 出生日 1–31 · 示例：10 |
| birth_hour | integer | 可选 · 出生时 0–23，默认 12 · 默认 12 · 示例：8 |
请求头说明
Authorizationstring
可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
八字string
八字字符串
四柱array
年/月/日/时柱
四柱[]string
四柱 的一项
日主string
日主五行
五行分布object
五行计数
金number
金
木number
木
水number
水
火number
火
土number
土
五行缺失array
缺失五行
五行缺失[]string
五行缺失 的一项
建议补充array
建议补充五行
建议补充[]string
建议补充 的一项
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 八字 | string | 八字字符串 | |||||||||||||||
| 四柱 | array | 年/月/日/时柱 | |||||||||||||||
| |||||||||||||||||
| 日主 | string | 日主五行 | |||||||||||||||
| 五行分布 | object | 五行计数 | |||||||||||||||
| |||||||||||||||||
| 五行缺失 | array | 缺失五行 | |||||||||||||||
| |||||||||||||||||
| 建议补充 | array | 建议补充五行 | |||||||||||||||
| |||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | |||||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"八字": "丙午癸午甲戌戊辰",
"四柱": [
"丙午",
"癸午",
"甲戌",
"戊辰"
],
"日主": "木",
"五行分布": {
"金": 0,
"木": 1,
"水": 1,
"火": 3,
"土": 3
},
"五行缺失": [
"金"
],
"建议补充": [
"金"
]
},
"tips": "极数本源 · https://apizero.cn"
}免责声明
八字计算为近似算法（简化了节气和农历转换），仅供参考；重名率为统计估算非精确查询；起名建议仅供趣味参考。