# Di chuyển từ GenderAPI v1 sang v2

> Di chuyển tích hợp GenderAPI từ v1 sang v2 bằng cách sử dụng cùng một phím và số dư API. Ánh xạ các trường yêu cầu, lộ trình hàng loạt, phản hồi, lỗi và hành vi thử lại.

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

Last reviewed: 2026-09-25

## Chuyển tích hợp từ v1 sang v2

V1 vẫn còn. Di chuyển các tích hợp riêng lẻ khi sẵn sàng sử dụng cùng một khóa và số dư tín dụng. V2 là một hợp đồng yêu cầu và phản hồi khác nên chỉ thay đổi URL là không đủ.

| Khái niệm V1 | V2 tương đương |
| --- | --- |
| Tách biệt các điểm cuối tên, email và tên người dùng | POST /api/v2/gender với type và value |
| Tách nhiều điểm cuối | POST /api/v2/gender/batch với items |
| askToAI | options.ai_mode: fallback; các yêu cầu đơn lẻ đã được mặc định là fallback |
| forceToGenderize | Trường tùy chọn giống nhau cho cả ba loại; tập dữ liệu trước, sau đó là AI nhận biết biệt hiệu |
| Trường phản hồi phẳng | data cho kết quả; meta để truy cập và thanh toán |
| probability phần trăm | confidence trên thang điểm 0–1 cộng với confidence_kind; Điểm AI không phải là xác suất được hiệu chỉnh |
| total_names | data.sample_count, vô giá trị |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Định dạng lỗi kế thừa | Trạng thái HTTP cộng với Problem Details code và action |
| POST thử lại | Mỗi lần thử lại là một thao tác mới với hóa đơn bình thường |

- [Đọc tài liệu tham khảo v1](https://www.genderapi.io/vi/api-documentation/v1)
- [Sử dụng hợp đồng v2 OpenAPI](https://api.genderapi.io/api/v2/openapi.json)

## Cập nhật và xác minh khách hàng của bạn

Sử dụng hợp đồng yêu cầu và phản hồi v2 cho tiện ích tích hợp mà bạn đang di chuyển. Xác minh meta.access.mode, bảo toàn kết quả JSON null, kiểm tra lỗi lô từng mặt hàng và kiểm tra thanh toán trước khi thử lại. Giữ tích hợp v1 trên đường dẫn hiện có của họ cho đến khi khách hàng của họ được cập nhật.

- [Bắt đầu với xác thực](https://www.genderapi.io/vi/docs/v2/authentication)
- [Đọc phản hồi v2](https://www.genderapi.io/vi/docs/v2/responses)
- [Xử lý lần thử lại](https://www.genderapi.io/vi/docs/v2/errors-and-retries)