1. 产品功能

基于传统八字命理学理论；
结合三才五格数理分析；
考虑五行相生相克关系；
提供多个候选姓名供选择；
包含详细的命理分析报告；
支持方言谐音检测；
全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
全面兼容 Apple ATS ；
全国多节点 CDN 部署；
接口极速响应，多台服务器构建 API 接口负载均衡；
接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/name-generator

接口地址: https://api.gugudata.com/ai/name-generator?appkey={{appkey}}

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/ai/name-generator?appkey={{appkey}}

数据预览: https://www.gugudata.com/preview/name-generator

接口测试: https://api.gugudata.com/ai/name-generator/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
lastname	string	是		姓氏
gender	string	是		性别（男/女）
birthdatetime	string	是	N/A	公历出生年月日时，格式：YYYY 年 MM 月 DD 日 HH:MM
birthplace	string	是	N/A	出生地点（省市），用于规避可能的谐音
parentnames	string	否		父母姓名（可选，用于亲子音韵搭配）
avoidwords	string	否		可选避用字（可选，多个字用逗号分隔）

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	此条件下的总数据量，一般用于分页计算
Data	object	接口返回的完整 JSON 数据，包含命盘分析、候选名字清单、最佳推荐、注意事项等所有字段，具体可查看 DEMO 接口返回数据

DEMO


{
    "Data": {
        "命盘分析摘要": "王姓女婴，生于 2023 年 5 月 12 日 14:30 （癸卯年丁巳月庚午日癸未时）。八字：庚午（日主）、丁巳、癸卯、癸未。日主庚金生于巳月火旺之地，失令；地支巳午未三会火局，火势极旺克金；天干双癸水透出，但水弱难制火。全局火旺土燥，金弱无根，为身弱格局。五行分析：火极旺（官杀），土旺（印星），金弱（日主），水弱（食伤），木休（财星）。喜用神为首选水（调候降温、制火护金），次选土（化火生金）。忌神为火、木。",
        "候选名字清单": [
            {
                "姓名全称": "王清涵",
                "汉语拼音": "Wáng Qīnghán",
                "五行补益分析": "补水（清、涵均属水），水能制火调候，并生助日主庚金",
                "三才五格分析": "天格 5(土)-人格 16(土)-地格 24(火)-总格 28(金)-外格 13(火)。三才配置：土土火。人格 16 为主运，厚重载德之吉数；总格 28 为磨铁成针之吉数，但地格 24 和外格 13 为火，需注意火旺压力。整体数理吉凶：吉多于凶（评分 92 ）",
                "经典出处": "无特定典籍出处，但清涵取自清泉涵玉之意，符合水象雅韵",
                "现代寓意解读": "清：清澈高洁；涵：包容涵养。名字寓意女子冰清玉洁、胸怀宽广，音韵柔美流畅"
            },
            {
                "姓名全称": "王沐瑶",
                "汉语拼音": "Wáng Mùyáo",
                "五行补益分析": "补水（沐属水）、补金（瑶属金，金生水助用神），水金相生强化调候",
                "三才五格分析": "天格 5(土)-人格 13(火)-地格 24(火)-总格 28(金)-外格 16(土)。三才配置：土火火。人格 13 为智略超群之吉数；总格 28 为吉数。但地格 24 火旺，需结合八字注意火势。整体数理吉凶：中吉（评分 91 ）",
                "经典出处": "无",
                "现代寓意解读": "沐：润泽沐浴；瑶：美玉。名字寓意如沐春风、温润如玉，现代感强且女性化"
            },
            {
                "姓名全称": "王雨宸",
                "汉语拼音": "Wáng Yǔchén",
                "五行补益分析": "补水（雨属水），水为第一用神，直接调候降温",
                "三才五格分析": "天格 5(土)-人格 13(火)-地格 18(金)-总格 22(木)-外格 11(木)。三才配置：土火金。人格 13 吉；地格 18 金吉，补益日主；总格 22 木为凶数（秋草逢霜），但八字忌木，需谨慎。整体数理吉凶：吉凶参半（评分 90 ）",
                "经典出处": "无",
                "现代寓意解读": "雨：甘霖；宸：帝王居所。名字寓意天降福泽、尊贵大气，音韵抑扬顿挫"
            },
            {
                "姓名全称": "王溪然",
                "汉语拼音": "Wáng Xīrán",
                "五行补益分析": "补水（溪属水），水制火调候，然字属火但为虚词影响小",
                "三才五格分析": "天格 5(土)-人格 18(金)-地格 20(水)-总格 24(火)-外格 13(火)。三才配置：土金水。人格 18 金吉，补益日主；地格 20 水吉，助用神；但总格 24 火为忌。整体数理吉凶：中吉（评分 91 ）",
                "经典出处": "无",
                "现代寓意解读": "溪：溪流；然：自然之态。名字寓意恬静自然、清澈灵动，符合现代简约审美"
            },
            {
                "姓名全称": "王沁怡",
                "汉语拼音": "Wáng Qìnyí",
                "五行补益分析": "补水（沁属水），水为用神；怡属土，土能化火生金，为次用神",
                "三才五格分析": "天格 5(土)-人格 13(火)-地格 17(金)-总格 21(木)-外格 10(水)。三才配置：土火金。人格 13 吉；地格 17 金吉，补日主；外格 10 水凶（万事终局），但水为用神可化解。整体数理吉凶：吉多于凶（评分 90 ）",
                "经典出处": "无",
                "现代寓意解读": "沁：渗透滋润；怡：愉悦安然。名字寓意心旷神怡、温婉可人，音韵柔和"
            }
        ],
        "最佳推荐": [
            {
                "姓名": "王清涵",
                "综合评分": 95,
                "推荐理由": "五行双水强补用神，数理人格 16 吉、总格 28 吉，音韵平仄协调（阳平-阴平-阳平），无方言不良谐音（检测吴语区：苏州话无歧音），寓意高雅且重名率低"
            },
            {
                "姓名": "王沐瑶",
                "综合评分": 93,
                "推荐理由": "水金相生契合喜用，数理人格 13 智略吉，现代感强，音律优美（阳平-去声-阳平），避用字检查无误"
            }
        ],
        "注意事项": "1. 八字火旺，避免使用火、木属性字（如炎、琳、森等）； 2. 地格数理 24 虽为吉数，但属火，需结合名字五行化解； 3. 出生在苏州（吴语区），已检测候选名字无当地方言不良谐音（如王沐瑶在苏州话中无歧义）； 4. 所有用字均符合通用规范汉字表一级字库。"
    }
}