八字起名

API

输入父母姓氏与出生时间，基于「八字五行 + 五格数理 + 三才配置」综合评分生成高分名字候选，附寓意标签与全国重名预估。三个 action：naming（智能起名）/ duplicate（重名查询）/ bazi（八字查询）。内置 396 姓氏笔画 + 175 起名字 + 88 姓…

接入文档

由极数本源提供·更新于昨天

先试用，再接接口

不用写代码。打开工具页跑一遍宝宝起名，看清结果再来订阅。

打开宝宝起名

累计调用

7ms

平均响应

100.00%

服务可用性

5,000 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 2

今日已用 … / 5,000 次/日…

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每天 3,000 次 · QPS 1

登录免费

当前方案

每天 5,000 次 · QPS 2

黄金会员

每天 50,000 次 · QPS 10

钻石会员

每天 100,000 次 · QPS 30

企业会员

每天 1,000,000 次 · QPS 120

AI 文档

把这个地址发给 AI，就能生成调用代码

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

surnamestring

必填 · 父姓（≤ 2 字） · 示例：王

mother_surnamestring

可选 · 母姓；填写则生成双姓名 · 示例：李

birth_yearinteger

必填 · 出生年 2000–2100 · 示例：2026

birth_monthinteger

必填 · 出生月 1–12 · 示例：5

birth_dayinteger

必填 · 出生日 1–31 · 示例：10

birth_hourinteger

可选 · 出生时 0–23，默认 12 · 默认 12 · 示例：12

genderstring

可选 · 性别偏好 male / female / neutral · 默认 neutral · 示例：male

countinteger

可选 · 返回名字数量 1–30，默认 10 · 默认 10 · 示例：3

名称	类型	说明
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

请求头说明

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_ 形态时生效）。匿名可不传，受每日免费额度限制。

返回字段说明

baziobject

八字四柱与日主

八字string

八字

四柱array

四柱

bazi.四柱[]string

bazi.四柱的一项

日主string

日主

wu_xing_analysisobject

五行分布 / 缺失 / 建议补充

五行分布object

五行分布

金number

金

木number

木

水number

水

火number

火

土number

土

五行缺失array

五行缺失

wu_xing_analysis.五行缺失[]string

wu_xing_analysis.五行缺失的一项

建议补充array

建议补充

wu_xing_analysis.建议补充[]string

wu_xing_analysis.建议补充的一项

needed_wuxingarray

建议补充的五行

needed_wuxing[]string

needed_wuxing 的一项

namesarray

候选名字（含评分、五格、重名预估）

namestring

名称

surnamestring

surname

given_namestring

given_name

scorenumber

score

wugeobject

wuge

天格number

天格

人格number

人格

地格number

地格

外格number

外格

总格number

总格

wuge_scorenumber

wuge_score

wuxing_charsstring

wuxing_chars

meaning_tagsarray

meaning_tags

names[].meaning_tags[]string

names[].meaning_tags 的一项

duplicate_rateobject

duplicate_rate

estimated_countnumber

estimated_count

levelstring

level

descriptionstring

description

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

名称

类型

说明

bazi

object

八字四柱与日主

八字

string

八字

四柱

array

四柱

bazi.四柱[]

string

bazi.四柱的一项

日主

string

日主

wu_xing_analysis

object

五行分布 / 缺失 / 建议补充

五行分布

object

五行分布

金	number	金
木	number	木
水	number	水
火	number	火
土	number	土

五行缺失

array

五行缺失

wu_xing_analysis.五行缺失[]

string

wu_xing_analysis.五行缺失的一项

建议补充

array

建议补充

wu_xing_analysis.建议补充[]

string

wu_xing_analysis.建议补充的一项

needed_wuxing

array

建议补充的五行

needed_wuxing[]

string

needed_wuxing 的一项

names

array

候选名字（含评分、五格、重名预估）

name

string

名称

surname

string

surname

given_name

string

given_name

score

number

score

wuge

object

wuge

天格	number	天格
人格	number	人格
地格	number	地格
外格	number	外格
总格	number	总格

wuge_score

number

wuge_score

wuxing_chars

string

wuxing_chars

meaning_tags

array

meaning_tags

names[].meaning_tags[]

string

names[].meaning_tags 的一项

duplicate_rate

object

duplicate_rate

estimated_count	number	estimated_count
level	string	level
description	string	description

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

免责声明

八字计算为近似算法（简化了节气和农历转换），仅供参考；重名率为统计估算非精确查询；起名建议仅供趣味参考。

加载接口文档…

名称

类型

说明

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

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