# 适用于姓名、电子邮箱和用户名的 Gender API

> 根据名字、全名、电子邮箱地址或用户名估算可能的性别。GenderAPI.io V2 返回结构化 JSON，包含预测来源、置信度以及可选的国家/地区背景。

Canonical HTML: https://www.genderapi.io/zh

Last reviewed: 2026-09-29

## 概览

根据名字、全名、电子邮箱地址或用户名估算可能的性别。GenderAPI.io V2 返回结构化 JSON，包含预测来源、置信度以及可选的国家/地区背景。

## 试用 V2 姓名请求

每条请求消耗 1 个积分。如果没有保存密钥或密钥无法识别，将使用 IP 试用：每 24 小时 10 个积分，由使用同一 IP 地址的所有用户共享。

2026年10月1日获取的真实 V2 响应。发送请求即可查看实时结果。

**代表性响应，并非实时查询结果**

```json
{
  "data": {
    "input": {
      "type": "name",
      "value": "Hao",
      "country": null
    },
    "name": "hao",
    "gender": "male",
    "country": "US",
    "confidence": 0.9107981220657277,
    "confidence_kind": "observed_frequency",
    "sample_count": 852,
    "source": "dataset",
    "result_status": "identified",
    "reason": null,
    "country_source": "dataset",
    "match": {
      "name": "hao",
      "method": "normalized",
      "scope": "global",
      "country": null
    }
  },
  "meta": {
    "request_id": "67c19ed6-db8d-4a8c-a045-234a7e0adbbe",
    "duration_ms": 26,
    "access": {
      "mode": "api_key",
      "reason": null
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 49999,
      "billing_status": "confirmed",
      "resets_at": null,
      "limit": null,
      "period_seconds": null
    }
  }
}
```

- [在 HTML 页面中打开在线演示](https://www.genderapi.io/zh#name-demo)

## 面向全球姓名的 Gender API

您可以逐条查询、发送批量请求，或使用我们的表格工具。V2 会明确区分有预测和无预测的结果，让您的应用保留不确定性，而不是强行给出猜测。

覆盖范围因姓名和国家/地区而异：全球

置信度，并注明来源和含义：0–1

JSON 中包含结果和已用积分：V2

使用 API 密钥时每个批量请求的条目数；IP 试用为 10 个：50

## 根据名字或全名估算性别

获得附带置信度和预测来源的估算结果。无法做出预测时，V2 会明确将其标记为未知结果。

- 名字和全名

- 已知国家/地区时可提供地区背景

- 拉丁及非拉丁文字姓名

- [了解 V2 姓名 API →](https://www.genderapi.io/zh/docs/v2/gender-from-name)

## 利用电子邮箱地址中的姓名信号

解读常见邮箱格式中的姓名信号，为 CRM、潜在客户和分析数据补充性别估算及其来源。

- 个人和企业邮箱地址

- 补充 CRM 记录

- 响应中包含置信度和来源

- [了解 V2 电子邮箱 API →](https://www.genderapi.io/zh/docs/v2/gender-from-email)

## 分析用户名和昵称

识别用户名中包含的常见名字。使用 forceToGenderize 时，即使昵称中没有真实名字，也可以请求估算，但不保证一定得到预测。

- 社交媒体和社区的用户数据

- 可选的昵称分析

- 没有预测时状态清晰明确

- [了解 V2 用户名 API →](https://www.genderapi.io/zh/docs/v2/gender-from-username)

## 批量处理姓名列表

上传 Excel 或 CSV 文件，选择来源列并下载结果。如需从您的应用发送批量请求，请参阅 V2 批量请求指南。

- Excel 和 CSV 文件

- 包含名字、全名或电子邮箱地址的列

- 可选的国家/地区背景

- [阅读 V2 批量请求指南 →](https://www.genderapi.io/zh/docs/v2/batch)

## 集成 API，或连接您已在使用的工具

从 REST API 开始，或将 GenderAPI.io 连接到电子表格、电商平台和自动化服务。请在每份指南中确认该集成使用的 API 版本。

- [查看全部集成](https://www.genderapi.io/zh/integrations)

## 开始使用前需要了解的内容

了解请求类型、置信度、免费使用方式和积分消耗。请求格式和代码示例请参阅 V2 文档。

- [查看全部常见问题 →](https://www.genderapi.io/zh/frequently-asked-questions)

### GenderAPI.io 是什么？

GenderAPI.io 根据姓名、电子邮箱地址或用户名估算可能的性别。V2 在 JSON 中返回预测、置信度、来源和已用积分。这些估算基于姓名中的常见规律，并不能确认一个人自述的性别认同。

### V2 什么时候使用 AI？

单条请求会先查询数据集。如果数据集中没有预测，默认会使用 AI。这一默认模式总共消耗 1 个积分，包括 AI 的使用。批量请求默认不使用 AI。您可以选择 AI 模式，或启用 forceToGenderize 来分析昵称。

### 如何解读置信度和未知结果？

在 V2 中，confidence 字段的值为 0 到 1 之间的数值或 null。confidence_kind 字段用于区分数据集中观察到的频率和模型给出的数值；置信度并不能保证结果正确。没有预测时，响应包含 gender: null 和 result_status: unknown。

### 一条请求消耗多少积分？

标准 V2 请求消耗 1 个积分，即使使用了 AI，或成功处理的结果中没有预测也是如此。AI 模式 always 消耗 2 个积分。使用 forceToGenderize 时，来自数据集的预测消耗 1 个积分；如果需要使用 AI，总共消耗 2 个积分。批量请求按条目计费。

### 可以在一条请求中发送多个条目吗？

可以。使用有效的 API 密钥时，V2 每个批量请求最多接受 50 个条目；使用 IP 试用时最多 10 个。因此，一条 HTTP 请求可能消耗多个积分。较大的文件也可以使用 Excel 和 CSV 工具或其他集成进行处理。

### 可以免费试用 API 吗？

没有 API 密钥时，V2 演示使用 IP 试用，每 24 小时提供 10 个积分，由使用同一 IP 地址的所有用户共享。免费账户每天可获得 200 个积分。这些是积分额度，而不是固定的请求次数：消耗 2 个积分的模式会更快用完余额。

### 我现有的 API 密钥可以用于 V2 吗？

可以。V1 和 V2 使用同一个 API 密钥和同一个账户余额。现有的 V1 集成仍然可用。新的集成应以 V2 文档为准，因为 V2 的接口、响应字段和错误格式都与 V1 不同。

## 免费试用 GenderAPI.io

创建账户，用每天 200 个免费积分测试您的第一批请求，并在需要时处理 Excel 或 CSV 文件。

- [创建账户](https://app.genderapi.io/user/register)
- [查看文档](https://www.genderapi.io/zh/api-documentation)