加载接口文档…
424
累计调用
9ms
平均响应
100.00%
服务可用性
5,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 3,000 次 · QPS 1
登录免费
当前方案每日 5,000 次 · QPS 2
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/baby-naming/raw.md接口请求地址
https://v1.apizero.cn/api/baby-naming
接口请求方式
POST
请求参数格式
FORM / QUERY / JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/baby-naming?action=naming&surname=%E7%8E%8B&mother_surname=%E6%9D%8E&birth_year=2026&birth_month=5&birth_day=10&birth_hour=12&gender=male&count=3
接口信息备注
按出生八字 + 五行补缺 + 五格数理生成高分名字。可填 mother_surname 生成双姓。文档示例为真实算法结果（已截断）。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| action | string | 可选 · 固定 naming（默认） · 默认 naming · 示例：naming |
| surname | string | 必填 · 父姓（≤ 2 字） · 示例：王 |
| mother_surname | string | 可选 · 母姓；填写则生成双姓名 · 示例：李 |
| 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 · 示例：12 |
| gender | string | 可选 · 性别偏好 male / female / neutral · 默认 neutral · 示例：male |
| count | integer | 可选 · 返回名字数量 1–30，默认 10 · 默认 10 · 示例：3 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| bazi | object | 八字四柱与日主 |
| wu_xing_analysis | object | 五行分布 / 缺失 / 建议补充 |
| needed_wuxing | array | 建议补充的五行 |
| names | array | 候选名字（含评分、五格、重名预估） |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"bazi": {
"八字": "丙午癸午甲戌庚午",
"四柱": [
"丙午",
"癸午",
"甲戌",
"庚午"
],
"日主": "木"
},
"wu_xing_analysis": {
"五行分布": {
"金": 1,
"木": 1,
"水": 1,
"火": 4,
"土": 1
},
"五行缺失": [],
"建议补充": [
"金"
]
},
"needed_wuxing": [
"金"
],
"names": [
{
"name": "王远瑞",
"surname": "王",
"given_name": "远瑞",
"score": 87.9,
"wuge": {
"天格": 5,
"人格": 21,
"地格": 31,
"外格": 18,
"总格": 35
},
"wuge_score": 100,
"wuxing_chars": "土+金",
"meaning_tags": [
"高远",
"吉祥"
],
"duplicate_rate": {
"estimated_count": 257,
"level": "较低",
"description": "预估全国约有 257 人与此同名同姓"
}
},
{
"name": "王怡钦",
"surname": "王",
"given_name": "怡钦",
"score": 87.9,
"wuge": {
"天格": 5,
"人格": 13,
"地格": 21,
"外格": 16,
"总格": 25
},
"wuge_score": 100,
"wuxing_chars": "土+金",
"meaning_tags": [
"愉快",
"敬慕"
],
"duplicate_rate": {
"estimated_count": 257,
"level": "较低",
"description": "预估全国约有 257 人与此同名同姓"
}
}
]
},
"tips": "极数本源 · https://apizero.cn"
}免责声明
八字计算为近似算法（简化了节气和农历转换），仅供参考；重名率为统计估算非精确查询；起名建议仅供趣味参考。