# 从 GenderAPI v1 迁移到 v2

> 使用相同的 API 密钥和余额将 GenderAPI 集成从 v1 移动到 v2。映射请求字段、批处理路由、响应、错误和重试行为。

Canonical HTML: https://www.genderapi.io/zh/docs/v2/migration

Last reviewed: 2026-09-25

## 将集成从 v1 移至 v2

V1 仍然可用。准备好后使用相同的密钥和信用余额迁移各个集成。 V2 是不同的请求和响应合约，因此仅更改 URL 是不够的。

| V1概念 | V2 等效 |
| --- | --- |
| 单独的姓名、电子邮件和用户名端点 | POST /api/v2/gender 与 type 和 value |
| 分离多个端点 | POST /api/v2/gender/batch 与 items |
| askToAI | options.ai_mode: fallback;单个请求已默认为 fallback |
| forceToGenderize | 所有三种类型的可选字段相同；首先是数据集，然后是昵称感知人工智能 |
| 平坦响应字段 | data 为结果； meta 用于访问和计费 |
| probability 百分比 | confidence（0-1 等级）加上 confidence_kind； AI 分数不是校准概率 |
| total_names | data.sample_count，可为空 |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| 旧版错误格式 | HTTP 状态加上 Problem Details code 和 action |
| POST 重试 | 每次重试都是一次新操作，计费正常 |

- [阅读 v1 参考](https://www.genderapi.io/zh/api-documentation/v1)
- [使用v2 OpenAPI合约](https://api.genderapi.io/api/v2/openapi.json)

## 更新并验证您的客户端

对您要迁移的集成使用 v2 请求和响应协定。验证 meta.access.mode、保留 JSON null 结果、检查每个项目的批次错误并在重试之前检查计费。将 v1 集成保留在现有路径上，直到更新客户端为止。

- [从身份验证开始](https://www.genderapi.io/zh/docs/v2/authentication)
- [读取 v2 响应](https://www.genderapi.io/zh/docs/v2/responses)
- [处理重试](https://www.genderapi.io/zh/docs/v2/errors-and-retries)