GenderAPI.io V2 文档

发送您的第一个请求

发送姓名、电子邮箱地址或用户名，即可获得 JSON 格式的性别预测。您可以先在浏览器中打开下方 URL（无需 API 密钥），再选择一篇指南来连接您的应用。

免费 IP 试用为每个 IP 地址每 24 小时提供 10 个积分，与 V1 共享。此示例仅使用数据集，每次请求（包括每次刷新页面）消耗 1 个积分。连接您现有的 API 密钥后，V1 和 V2 使用同一个账户余额。

https://api.genderapi.io/api/v2/gender?type=name&value=Ming&country=CN&ai_mode=off

您想做什么？

选择输入类型，查看可直接运行的 cURL、JavaScript、Python、PHP、Java、C# 和 Go 示例。准备处理真实响应时，请参阅结果和计费指南。

快速开始

发送请求

了解结果与费用

从 V1 迁移

从 V1 迁移 使用同一个 API 密钥更新现有集成。

端点参考

将 https://api.genderapi.io 与下表中的绝对路径组合使用。例如：https://api.genderapi.io/api/v2/gender。只有 GET /gender 支持查询参数。POST 路由请使用 JSON 请求体；不要在 V2 请求中发送 name、email、username 或 askToAI 等 V1 字段。

方法	路径	用途
GET	/api/v2	公开的功能和当前限制；免费。
GET	/api/v2/openapi.json	权威的 OpenAPI 契约；免费。
GET	/api/v2/errors	机器可读的错误目录；免费。
GET	/api/v2/usage	当前账户余额或 IP 试用余额；免费。
GET / POST	/api/v2/gender	单个姓名、电子邮箱地址或用户名。
POST	/api/v2/gender/batch	按顺序排列的一批姓名、电子邮箱地址和/或用户名。
POST	/api/v2/phone/validate	验证电话号码并进行格式化。