八字喜用神起名大师

内容仅供娱乐与姓名文化参考，不代表科学预测或方言检测。8 个候选是补生成目标，不保证返回固定数量；有效候选少于 8 个时仍可能成功。实时片段可能包含最终排除的姓名，以校验后的完整结果为准。异步任务受理时不扣次，完成成功后结算一次，轮询不扣次。免责声明为可选字段，返回时为非空字符串。
结合姓氏、性别、出生时间和地点生成姓名候选，适合起名参考与姓名文化阅读应用。
可填写父母姓名作为补充信息，让生成内容结合家庭命名偏好进行音韵搭配参考。
支持提交避用字，在请求中表达不希望使用的字，便于整理家庭已有的命名要求。
支持指定禁生成姓名，可使用列表或分隔文本提交，便于排除已经看过或不希望采用的名字。
返回多个姓名候选，便于在同一页面中逐项比较名字、读音和相关文化解释。
候选条目提供汉语拼音，可辅助整理读音展示；具体方言发音仍需结合当地实际核对。
提供五行补益相关的传统文化说明，便于了解每个候选名字采用的文化解释角度。
提供三才五格相关的数理文化解读，适合制作姓名文化资料卡与分项阅读内容。
包含现代寓意与推荐理由，便于读者结合自己的审美、家庭偏好和实际使用习惯比较名字。
支持异步提交并在完成后获取姓名结果，适合需要等待完整候选清单的起名报告页面。

当前接口契约

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

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	保留 Query、JSON／表单、AppKey、X-API-Key、X-GUGUDATA-APPKEY 与 Bearer 鉴权；多处一致凭据允许，重复或冲突凭据失败。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
lastname	string	是	无	姓氏；与出生资料一起用于姓名文化参考，不是业务默认值。
gender	string	是	无	保留男／女及已有英文表达：male／female、m／f、boy／girl、男生／女生。
birthDateTime	string	是	无	公历出生日期时间；支持 YYYY年MM月DD日 HH:MM、YYYY-MM-DD HH:MM 及已有 ISO、秒级表达，日期时间必须有效。
birthPlace	string	是	无	出生地点，作为姓名文化解读的补充信息；不提供方言读音检测。
parentNames	string	否	无	父母姓名，可选；作为家庭命名偏好的补充信息。不传时使用空字符串。
avoidWords	string	否	无	可选避用字；保持既有逗号分隔表达。不传时使用空字符串。
avoidNames	string／array	否	无	禁生成姓名；支持逗号、中文逗号、顿号分隔的字符串或 JSON 字符串数组。表单使用分隔字符串。
streaming	boolean	否	false	实时片段沿用 content 事件；片段是未完成内容，可能含最终排除的名字，以校验后的唯一 done.full_text 完整 JSON 和 end/[DONE] 为成功终态。responseMode=task 时不能为 true。
responseMode	string	否	sync	保留 sync／task；task 首响应为任务受理信息，须通过 /ai/operations/{operation_id} 轮询至终态。任务受理不代表结果成功。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次真实业务请求参数，不含鉴权凭据；Demo 与公开样例输入对应。
DataStatus.StatusCode	integer	成功为 100；参数错误 501／HTTP 400，依赖及处理失败 901／HTTP 503；公共鉴权、权益和限流契约保持。
DataStatus.StatusDescription	string	本次业务处理结果说明；任务受理不等于完成。
DataStatus.ResponseDateTime	string	接口响应时间，不表示姓名分析经过事实核验。
DataStatus.DataTotalCount	integer	成功业务对象数量为 1，不表示候选名字数量。
Data	object	同步返回命盘分析摘要、候选名字清单、最佳推荐和注意事项；免责声明可选，不补写模型未返回的内容。task 首响应返回既有任务对象。
Data.命盘分析摘要	string	输入出生资料对应的传统文化说明。
Data.候选名字清单	array	候选条目保留姓名全称、汉语拼音、五行补益分析、三才五格分析、经典出处和现代寓意解读。候选数量以有效生成结果为准。
Data.最佳推荐	array	推荐姓名均来自本次有效候选；保留模型返回的综合评分与推荐理由，不补造评分。
Data.注意事项	string	供用户结合家庭审美与实际使用习惯审阅的说明。
Data.免责声明	string	可选的生成内容参考边界；模型返回时为非空字符串。
Data.operationId	string	仅任务模式返回的任务标识。
Data.status	string	PENDING／RUNNING／SUCCEEDED／FAILED／EXPIRED；终态结果或失败须结合该字段判断。
Data.pollingUrl	string	既有任务状态查询路径。
Data.expiresAt	string	结果保留的到期时间，不表示模型可以持续执行到该时间。
Data.result	object	仅 SUCCEEDED 返回，结构与同步 Data 一致。
Data.error	object	仅 FAILED 返回安全失败信息。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
901	处理、依赖失败或超时	HTTP 503
502	请求频率限制	HTTP 429
503	权益过期	HTTP 403
504	凭据无效或无权限	HTTP 401
505	调用额度不足	HTTP 403

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例

{
  "lastname": "王",
  "gender": "女",
  "birthDateTime": "2023-05-12 14:30",
  "birthPlace": "江苏苏州",
  "avoidNames": [
    "王清涵"
  ],
  "responseMode": "sync",
  "streaming": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"{\"lastname\":\"王\",\"gender\":\"女\",\"birthDateTime\":\"2023-05-12 14:30\",\"birthPlace\":\"江苏苏州\",\"parentNames\":\"\",\"avoidWords\":\"\",\"avoidNames\":[\"王清涵\"],\"streaming\":false,\"responseMode\":\"sync\"}","StatusCode":100,"StatusDescription":"姓名生成成功","ResponseDateTime":"2026-10-22 11:09:12.735","DataTotalCount":1},"Data":{"命盘分析摘要":"日主癸水生于巳月，火旺土相，水处绝地，身弱。八字中火土较旺，金水偏弱。喜用神为金、水，以印比帮身，调候降温。忌火、土。取名宜补金水，增强日主能量，平衡五行。","候选名字清单":[{"姓名全称":"王舒漫","汉语拼音":"Wáng Shū Màn","五行补益分析":"舒字五行属金，漫字五行属水，金生水，顺应喜用神，增强日主癸水之力。","三才五格分析":"天格5(土)，人格13(火)，地格24(火)，总格28(金)，外格16(土)。三才配置土火火，虽火旺但数理吉祥，寓意才智出众。","经典出处":"舒：舒展、从容；漫：浪漫、无边际。出自《楚辞》“路漫漫其修远兮”。","现代寓意解读":"寓意生活从容自在，思维开阔，具有艺术气质和浪漫情怀。"},{"姓名全称":"王瑾瑜","汉语拼音":"Wáng Jǐn Yú","五行补益分析":"瑾字五行属火（带土），瑜字五行属金。虽瑾含火，但瑜为美玉属金，金能生水，且瑾瑜常连用指美玉，整体偏向高贵典雅，金气助身。","三才五格分析":"天格5(土)，人格19(水)，地格18(金)，总格22(木)，外格14(火)。三才土水金，相生有情，大吉。","经典出处":"出自《楚辞·九章》“怀瑾握瑜兮，穷不知所示”。","现代寓意解读":"比喻拥有美好的品德和才能，如玉般温润光泽，受人尊敬。"},{"姓名全称":"王沛琳","汉语拼音":"Wáng Pèi Lín","五行补益分析":"沛字五行属水，琳字五行属木/金（玉旁多视为金或木，此处取金玉之意含金）。水旺助身，金木相辅，利于成长。","三才五格分析":"天格5(土)，人格12(木)，地格13(火)，总格17(金)，外格6(土)。三才土木火，木生火，火生土，流通顺畅。","经典出处":"沛：充沛、盛大；琳：美玉。出自《说文》“琳，美玉也”。","现代寓意解读":"寓意精力充沛，才华横溢，如美玉般珍贵纯洁。"},{"姓名全称":"王汐若","汉语拼音":"Wáng Xī Ruò","五行补益分析":"汐字五行属水，若字五行属木。水木相生，水生木，泄秀有情，适合身弱需疏通之局，且水气直接帮扶日主。","三才五格分析":"天格5(土)，人格10(水)，地格11(木)，总格15(土)，外格6(土)。三才土水木，虽克但有情，吉凶参半，需注意人际。","经典出处":"汐：夜间的潮水；若：像、如。出自《庄子》“若夫乘天地之正”。","现代寓意解读":"寓意如潮水般有规律、有力量，性格温婉如水，智慧灵动。"},{"姓名全称":"王婉清","汉语拼音":"Wáng Wǎn Qīng","五行补益分析":"婉字五行属土，清字五行属水。土克水，但清字水气强，能润土，且清字直接补水，符合喜用。","三才五格分析":"天格5(土)，人格15(土)，地格12(木)，总格16(土)，外格2(木)。三才土土木，木克土，略有冲突，但数理吉利。","经典出处":"出自《诗经·郑风·野有蔓草》“有美一人，清扬婉兮”。","现代寓意解读":"寓意女子温婉贤淑，气质清新脱俗，品行高洁。"},{"姓名全称":"王钰涵","汉语拼音":"Wáng Yù Hán","五行补益分析":"钰字五行属金，涵字五行属水。金生水，强力补益日主癸水，格局稳健。","三才五格分析":"天格5(土)，人格14(火)，地格22(木)，总格26(土)，外格13(火)。三才土火木，火木相生，虽耗身但才艺佳。","经典出处":"钰：珍宝；涵：包容、涵养。","现代寓意解读":"寓意如珍宝般珍贵，内心有涵养，学识渊博，待人宽厚。"},{"姓名全称":"王洛宁","汉语拼音":"Wáng Luò Níng","五行补益分析":"洛字五行属水，宁字五行属火/金（宝盖头通常视为安守，五行偏火或金，此处取其安静之意，配合洛水）。水气为主，助身。","三才五格分析":"天格5(土)，人格14(火)，地格14(火)，总格18(金)，外格5(土)。三才土火火，火旺，需注意平衡，但总格金吉。","经典出处":"洛：洛水；宁：安宁。出自《洛神赋》意象。","现代寓意解读":"寓意如洛水女神般美丽，生活安宁祥和，心态平和。"},{"姓名全称":"王诗雅","汉语拼音":"Wáng Shī Yǎ","五行补益分析":"诗字五行属金，雅字五行属木。金克木，但诗书之气属金，能生水之源，雅字提升格调。","三才五格分析":"天格5(土)，人格14(火)，地格12(木)，总格16(土)，外格3(火)。三才土火木，流通较好。","经典出处":"诗：诗歌；雅：高雅。出自《论语》“不学诗，无以言”。","现代寓意解读":"寓意富有诗意，举止高雅，文化修养深厚，气质不凡。"}],"最佳推荐":[{"姓名":"王舒漫","综合评分":96,"推荐理由":"五行金水相生，完美契合喜用神，音韵优美，寓意从容浪漫，避开禁字，三才配置虽火旺但数理吉祥，整体平衡度高。"},{"姓名":"王瑾瑜","综合评分":94,"推荐理由":"经典成语出处，文化底蕴深厚，金气助身，寓意品德高尚，虽然笔画稍多，但气场强大，适合女孩培养高贵气质。"}],"注意事项":"以上姓名方案基于传统姓名学理论生成，仅供娱乐和文化参考。名字对人的影响是潜移默化的，并非决定性因素。请结合家庭喜好、读音习惯及个人感觉最终决定。避免迷信，理性看待。"}}

🟠400参数错误（业务码 501）。

🔴503处理、依赖失败或超时（业务码 901）。

🟠429请求频率限制（业务码 502）。

🟠403权益过期（业务码 503）；调用额度不足（业务码 505）。

🟠401凭据无效或无权限（业务码 504）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明