# GenderAPI.io 价格｜API 套餐与积分

> 先从免费账户开始，按月订阅积分满足持续使用，或一次性付款购买积分套餐。V2 请求根据 AI 选项消耗 1 或 2 个积分。

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

Last reviewed: 2026-09-29

## 免费账户与 IP 试用

注册的免费账户使用 API 密钥，每天提供 200 个积分，最多可用于 200 条消耗 1 个积分的标准请求；部分 AI 模式每个条目消耗 2 个积分。

V2 的 IP 试用无需注册，每个公网 IP 地址每 24 小时提供 10 个积分。当 API 密钥缺失、格式无效或无法识别时，会使用 IP 试用。使用同一公网 IP 地址的所有用户共享这部分余额，V1 试用访问的用量也从同一余额中扣除。已识别但被停用、已过期或受限的密钥不会转为使用 IP 试用。

## 积分套餐

价格与 HTML 页面使用同一份目录。购买前，请在价格页面确认当前条件和总金额。

| 套餐 | 积分 | 按月（EUR） | 一次性付款（EUR） |
| --- | --- | --- | --- |
| Tester | 5,000 | 6.69 | 8.39 |
| Mini | 25,000 | 15 | 19 |
| Start-Up | 50,000 | 25 | 30 |
| Basic | 100,000 | 40 | 50 |
| Basic+ | 200,000 | 50 | 60 |
| Pro | 500,000 | 75 | 90 |
| Advanced | 1,000,000 | 90 | 110 |
| Premium | 2,000,000 | 130 | 160 |
| Elite | 5,000,000 | 200 | 250 |
| Enterprise | 10,000,000 | 300 | 370 |
| Ultra | 20,000,000 | 450 | 560 |
| Ultimate | 50,000,000 | 900 | 1100 |

## V2 的积分消耗

积分衡量的是完成的处理量，而不是 HTTP 请求的次数。以下费用适用于 V2 的姓名、电子邮箱和用户名请求。V1 和 V2 使用您现有的 API 密钥，并共用同一个账户余额。

成功处理但没有预测的结果（gender: null）按所选模式的费用计费。计费前发生的输入验证错误不消耗积分；预测失败的请求在确认退还后不计费。如果计费结果尚未确认，请检查 billing_status。

批量请求按每个成功处理的条目计费，而不是按每次 HTTP 请求计费一次。批量条目默认仅使用数据集；如有需要，请为单个条目设置 fallback、always 或 forceToGenderize。一个包含 50 个条目、每个成功处理的标准条目消耗 1 个积分的批量请求，共消耗 50 个积分。使用 API 密钥的批量请求最多包含 50 个条目，使用 IP 试用时最多 10 个。

剩余余额至少为 1 个积分，即可开始一条单独请求或一个批量请求。完整扣费可能使余额变为负数：以 1 个积分开始一条消耗 2 个积分的请求后，余额为 -1。余额为零或负数时，将无法进行新的计费操作。

每次重复请求都是一次独立操作，会正常计费。如果某个请求的结果或扣费情况不明，请不要自动重试。

| 操作 | 每个条目的积分 | 说明 |
| --- | --- | --- |
| 仅使用数据集 | 1 | 设置 ai_mode: off 时，只查询数据集，不调用 AI。 |
| 标准请求（自动 AI 回退） | 1 | 设置 ai_mode: fallback 时，先查询数据集，无法确定性别时再使用 AI。即使使用了 AI，总费用也是 1 个积分。这是单条请求的默认设置。 |
| 直接使用 AI 的请求 | 2 | 设置 ai_mode: always 时，跳过数据集，直接使用 AI。 |
| 昵称推断：数据集结果 | 1 | 设置 forceToGenderize: true 时，先查询数据集。由数据集确定的性别消耗 1 个积分。 |
| 昵称推断：AI 结果 | 2 | 设置 forceToGenderize: true 后，如果数据集无法确定性别，AI 会解读姓名、电子邮箱或用户名，即使其中没有真实名字也可以。总费用为 2 个积分。 |
| 电话号码验证 | 1 | 每完成一次号码验证消耗 1 个积分，结果为 valid: false 时也同样计费。 |
| 查询余额 | 0 | GET /api/v2/usage 不消耗积分，但仍计入请求频率限制。 |

## 请求频率限制

所有套餐的 V2 请求都受请求频率和并发限制。积分余额与请求频率限制相互独立：请处理 HTTP 429，并在发送下一条请求前等待 Retry-After 响应头指定的时间。当前默认值和响应头请参阅 V2 文档。

- [V2 积分与用量指南](https://www.genderapi.io/zh/docs/v2/credits-and-usage)
- [V2 错误与重试指南](https://www.genderapi.io/zh/docs/v2/errors-and-retries)
- [V1 文档](https://www.genderapi.io/zh/api-documentation/v1)

## 每条 API 请求都只消耗 1 个积分吗？

不是。标准 V2 请求消耗 1 个积分，包括自动 AI 回退。ai_mode: always 消耗 2 个积分。使用 forceToGenderize 时，结果来自数据集消耗 1 个积分，使用 AI 时消耗 2 个积分。批量请求按每个成功处理的条目计费，成功处理但没有预测的结果同样计费。

## 免费账户和 IP 试用有什么区别？

注册账户使用 API 密钥，每天提供 200 个免费积分。无需密钥的 V2 IP 试用为每个公网 IP 地址每 24 小时提供 10 个积分，由该 IP 地址的其他用户以及 V1 试用访问共享。两种方式都按正常请求费用计费。

## 付费套餐也有请求限制吗？

有。V2 的请求频率和并发限制与积分余额无关。购买更大的积分套餐并不会取消这些限制。请处理 HTTP 429、遵循 Retry-After，并在 V2 文档中查看当前限制。