GenderAPI 帮助中心
GenderAPI 常见问题
关于姓名性别预测、API 请求、AI 辅助、积分、数据隐私和账户管理的清晰解答。
结果与准确性
如何解读 GenderAPI 的识别结果
了解国家/地区、概率和基于姓名的性别预测分别代表什么。
同一个姓名在不同国家的使用习惯不同时，结果会怎样？
如果知道国家/地区，请提交对应的 ISO 国家代码。GenderAPI 会结合地区背景分析姓名，因此对于在不同国家用法不同的姓名，返回的性别信号和概率可能会改变。
GenderAPI 的结果能确定一个人的真实性别吗？
不能。GenderAPI 根据可用的姓名数据返回统计预测；结果不等同于个人自我认同的性别，不能视为经过核实的个人信息，也不应单独用于会对个人产生重大影响的决策。
应该如何使用 probability 字段？
可将 probability 作为置信度信号，并根据业务场景设定人工复核阈值。请保留“未知”结果，不要把低概率或含义模糊的记录强行归类。
API 与 AI
API 请求、接口与 AI 辅助
选择合适的接口，并了解查询与 AI 回退的工作方式。
一次 API 请求可以分析多个姓名吗？
可以。使用多姓名接口，一次请求最多可处理 100 个姓名。每条记录会分别返回结果，并按处理的结果消耗积分。
如何通过电子邮箱识别性别？
邮箱接口会从个人邮箱地址 @ 前的部分提取可能的名字，然后分析该姓名。info@、support@ 等职能型邮箱通常不包含可用的个人姓名信号。
如何通过用户名或昵称预测性别？
用户名接口会先从账号名、昵称或显示名称中寻找可能的真实姓名，再进行分析。品牌式或抽象的用户名可能不会返回结果。
askToAI 参数有什么作用？
当 askToAI 为 true 且数据库无法识别提交或提取出的姓名时，系统可以启用 AI 辅助。该选项不保证一定返回预测，也不会强行生成结果。
是否提供客户端库和代码示例？
提供。客户端库页面列出了可用的 SDK 和验证工具，每个接口指南也包含当前的请求示例。
隐私与文件
查询数据和上传文件如何处理
了解 GenderAPI 公布的数据处理、保留和删除规则。
GenderAPI 会保存成功的查询吗？
不会。成功的 GenderAPI 查询不会被保存。只有非邮箱查询在未找到性别结果时，才可能被保留用于改进 GenderAPI。
邮箱查询的输入数据会被保存吗？
不会。邮箱查询的输入数据不会被保存，即使服务未能返回性别结果也不会保存。
上传的 Excel 或 CSV 文件会保存多久？
上传的 Excel 和 CSV 文件最多保留五天，之后会被删除。导出结果后，用户也可以立即删除文件，无需等待系统自动删除。
查询数据或上传文件会与第三方共享吗？
不会。GenderAPI 不会与第三方共享查询输入数据或上传文件的内容。
账户与支持
账户、账单与技术支持
管理 API 密钥、订阅、账单和支持请求。
如何保护 GenderAPI 的 API 密钥？
请把 API 密钥保存在服务器端，并通过可信的后端发送认证请求。不要在公开的客户端 JavaScript 中暴露生产密钥，也不要把密钥提交到版本控制系统。
在哪里管理或取消订阅？
登录 GenderAPI 应用，即可管理与 API 密钥关联的订阅。由于控制面板可能更新，请以当前账户界面为准，不要依赖旧版菜单说明。
在哪里更新账单信息？
与 API 密钥或订阅对应的账单和付款设置，可在登录后的 GenderAPI 应用中管理。
如何反馈错误结果或寻求集成帮助？
请向支持团队提供请求参数、响应内容和可复现的最小示例，但不要发送生产 API 密钥或敏感个人数据。
仍然需要帮助？
请提供可复现的示例
请附上接口、请求参数和返回的错误信息，但不要发送生产环境 API 密钥或敏感个人数据。