# GenderAPI.io V2 文档

> 发送您的第一个请求，连接您的应用，并了解返回的结果。您可以从姓名、电子邮箱地址或用户名开始。

Canonical HTML: https://www.genderapi.io/zh/api-documentation

Last reviewed: 2026-09-29

## 发送您的第一个请求

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

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

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

- [打开 GET 示例（消耗 1 个 IP 试用积分）](https://api.genderapi.io/api/v2/gender?type=name&value=Ming&country=CN&ai_mode=off)
- [设置您的 API 密钥](https://www.genderapi.io/zh/docs/v2/authentication#environment-setup)
- [了解 JSON 响应](https://www.genderapi.io/zh/docs/v2/responses)

## 您想做什么？

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

- [API 密钥与 IP 试用](https://www.genderapi.io/zh/docs/v2/authentication): 连接您的 API 密钥，或免费试用 API。
- [请求参数](https://www.genderapi.io/zh/docs/v2/request-parameters): 选择输入字段、国家/地区背景和请求选项。
- [官方 SDK](https://www.genderapi.io/zh/docs/v2/sdks): 为您使用的编程语言安装官方客户端。
- [根据姓名判断性别](https://www.genderapi.io/zh/docs/v2/gender-from-name): 查询名字或全名。
- [根据电子邮箱判断性别](https://www.genderapi.io/zh/docs/v2/gender-from-email): 在电子邮箱地址中查找姓名信号。
- [根据用户名判断性别](https://www.genderapi.io/zh/docs/v2/gender-from-username): 使用用户名或昵称作为输入。
- [批量请求（batch）](https://www.genderapi.io/zh/docs/v2/batch): 一次最多处理 50 个姓名、电子邮箱地址或用户名。
- [电话号码验证](https://www.genderapi.io/zh/docs/v2/phone-validation): 检查电话号码并进行格式化。
- [解读响应](https://www.genderapi.io/zh/docs/v2/responses): 解读预测、置信度和未知结果。
- [AI 与昵称](https://www.genderapi.io/zh/docs/v2/ai-options): 选择何时使用 AI，以及如何处理昵称。
- [积分与余额](https://www.genderapi.io/zh/docs/v2/credits-and-usage): 查看您的余额以及每个请求的费用。
- [错误与重试](https://www.genderapi.io/zh/docs/v2/errors-and-retries): 排查错误，并决定何时重试。
- [从 V1 迁移](https://www.genderapi.io/zh/docs/v2/migration): 使用同一个 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 | 验证电话号码并进行格式化。 |