宝宝起名API接口文档 GET / POST 娱乐测试

依据输入的出生日期来进行八字五行分析、喜用五行计算，为用户推荐符合命理的好名字。

请求 GET / POST返回 application/json10 积分 / 次上线 2026-09-24 14:57:41

依据输入的出生日期来进行八字五行分析、喜用五行计算，为用户推荐符合命理的好名字。

10 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=babyname
方法
GET / POST
分类
娱乐测试
计费
10 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

宝宝起名接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=babyname
请求方式：
GET / POST
返回格式：
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=babyname

apikey=你的API密钥&surname=请填写surname&birthday=请填写birthday&birthTime=请填写birthTime&gender=请填写gender&limit=请填写limit

GET 参数放在查询字符串中。参数值请替换为实际有效值。

宝宝起名请求参数

参数名类型必填说明示例
surnamestring是姓氏
birthdaystring是出生日期 YYYY-MM-DD
birthTimestring是出生时辰：子时~亥时（见接口详情）
genderinteger否性别：0不限、1男、2女
limitinteger否返回数量 1-500
返回示例
{"code":200,"message":"起名成功","data":{"surname":"李","gender":"男","birthday":"2024-05-20","birth_time":"辰时","bazi":"甲辰 己巳 甲申 戊辰","xiyongshen":["火","土"],"jiyongshen":["金","水"],"qiming_advice":"八字喜用神：火、土；忌用神：金、水。命局金、水气场清冷肃敛偏亢，压制克制本命。取名宜用火土相生组合，生化流通、气机周流，以化解克制、扶助喜神。须避开金、水属性过强之字，兼顾音律、字形与内涵，饱含家人对孩子行稳致远、进而有为的殷切期许。","total_names":2,"names":[{"full_name":"李煜城","name":"煜城","score":98,"match_priority":3,"match_level":"最佳匹配","characters":{"surname":{"char":"李","strokes":7,"wuxing":"火","pinyin":"lǐ"},"char1":{"char":"煜","strokes":13,"wuxing":"火","pinyin":"yù","analysis":"煜字的五行为火，光明磊落，一生前程似锦。","meaning":"煜字用着取名寓指光明、照耀、辉煌之义。"},"char2":{"char":"城","strokes":10,"wuxing":"土","pinyin":"chéng","analysis":"城字的五行为土，稳重可靠，有领导才能。","meaning":"城字用着取名寓指坚固、稳重、大气之义。"}},"poetry":"取自唐代：王之涣《登鹳雀楼》欲穷千里目，更上一层楼。","gender":"男"},{"full_name":"李炎彬","name":"炎彬","score":95,"match_priority":2,"match_level":"良好匹配","characters":{"surname":{"char":"李","strokes":7,"wuxing":"火","pinyin":"lǐ"},"char1":{"char":"炎","strokes":8,"wuxing":"火","pinyin":"yán","analysis":"炎字的五行为火，热情开朗，充满活力。","meaning":"炎字用着取名寓指热情、光明、向上之义。"},"char2":{"char":"彬","strokes":11,"wuxing":"木","pinyin":"bīn","analysis":"彬字的五行为木，文雅有礼，品德高尚。","meaning":"彬字用着取名寓指文质彬彬、品德高尚之义。"}},"poetry":"取自《论语》文质彬彬，然后君子。","gender":"男"}]},"timestamp":1725000000}

详细文档

宝宝起名 API 接口文档

接口描述

依据输入的出生日期来进行八字五行分析、喜用五行计算，为用户推荐符合命理的好名字。

功能特性

  • 依据输入的出生日期来进行八字五行分析、喜用五行计算，为用户推荐符合命理的好名字。
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=babyname

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

  • URL 参数：key=SK-你的密钥
  • 或请求头：X-API-Key: SK-你的密钥

请求参数

参数名 类型 必填 描述
surname string 是 姓氏
birthday string 是 出生日期 YYYY-MM-DD
birthTime string 是 出生时辰：子时~亥时（见接口详情）
gender integer 否 性别：0不限、1男、2女
limit integer 否 返回数量 1-500

请求参数 (JSON格式)

[
  {"name": "surname", "type": "string", "required": true, "description": "姓氏"},
  {"name": "birthday", "type": "string", "required": true, "description": "出生日期 YYYY-MM-DD"},
  {"name": "birthTime", "type": "string", "required": true, "description": "出生时辰：子时~亥时（见接口详情）"},
  {"name": "gender", "type": "integer", "required": false, "description": "性别：0不限、1男、2女"},
  {"name": "limit", "type": "integer", "required": false, "description": "返回数量 1-500"}
]

响应格式

JSON 格式响应

成功返回示例：

{"code":200,"message":"起名成功","data":{"surname":"李","gender":"男","birthday":"2024-05-20","birth_time":"辰时","bazi":"甲辰 己巳 甲申 戊辰","xiyongshen":["火","土"],"jiyongshen":["金","水"],"qiming_advice":"八字喜用神：火、土；忌用神：金、水。命局金、水气场清冷肃敛偏亢，压制克制本命。取名宜用火土相生组合，生化流通、气机周流，以化解克制、扶助喜神。须避开金、水属性过强之字，兼顾音律、字形与内涵，饱含家人对孩子行稳致远、进而有为的殷切期许。","total_names":2,"names":[{"full_name":"李煜城","name":"煜城","score":98,"match_priority":3,"match_level":"最佳匹配","characters":{"surname":{"char":"李","strokes":7,"wuxing":"火","pinyin":"lǐ"},"char1":{"char":"煜","strokes":13,"wuxing":"火","pinyin":"yù","analysis":"煜字的五行为火，光明磊落，一生前程似锦。","meaning":"煜字用着取名寓指光明、照耀、辉煌之义。"},"char2":{"char":"城","strokes":10,"wuxing":"土","pinyin":"chéng","analysis":"城字的五行为土，稳重可靠，有领导才能。","meaning":"城字用着取名寓指坚固、稳重、大气之义。"}},"poetry":"取自唐代：王之涣《登鹳雀楼》欲穷千里目，更上一层楼。","gender":"男"},{"full_name":"李炎彬","name":"炎彬","score":95,"match_priority":2,"match_level":"良好匹配","characters":{"surname":{"char":"李","strokes":7,"wuxing":"火","pinyin":"lǐ"},"char1":{"char":"炎","strokes":8,"wuxing":"火","pinyin":"yán","analysis":"炎字的五行为火，热情开朗，充满活力。","meaning":"炎字用着取名寓指热情、光明、向上之义。"},"char2":{"char":"彬","strokes":11,"wuxing":"木","pinyin":"bīn","analysis":"彬字的五行为木，文雅有礼，品德高尚。","meaning":"彬字用着取名寓指文质彬彬、品德高尚之义。"}},"poetry":"取自《论语》文质彬彬，然后君子。","gender":"男"}]},"timestamp":1725000000}

失败返回示例：

{"code":500,"message":"八字计算失败，请检查日期格式","data":null,"timestamp":1725000000}

返回参数说明

参数名 类型 说明
code integer 状态码，200表示成功
message string 状态描述，如"起名成功"
data object 起名结果数据
timestamp integer 服务器时间戳
其他参数见接口详情 string

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=babyname?key=SK-你的密钥&surname=%E5%BC%A0&birthday=2026-01-01&birthTime=%E5%AD%90%E6%97%B6&gender=1&limit=5"

错误响应

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
  • 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
  • 请合理控制调用频率，避免高频恶意调用触发风控
  • 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24