# Tài liệu GenderAPI.io V2

> Gửi yêu cầu đầu tiên, kết nối ứng dụng của bạn và hiểu kết quả. Bắt đầu với một tên, địa chỉ email hoặc tên người dùng.

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

Last reviewed: 2026-09-29

## Gửi yêu cầu đầu tiên

Gửi một tên, địa chỉ email hoặc tên người dùng để nhận dự đoán giới tính ở dạng JSON. Hãy thử URL bên dưới trong trình duyệt mà không cần khóa API, sau đó chọn một hướng dẫn để kết nối ứng dụng của bạn.

Dùng thử miễn phí theo IP có 10 tín dụng cho mỗi địa chỉ IP trong mỗi 24 giờ, dùng chung với V1. Ví dụ chỉ dùng tập dữ liệu này tốn 1 tín dụng cho mỗi yêu cầu, kể cả mỗi lần tải lại trang. Khi bạn kết nối khóa API hiện có, V1 và V2 dùng cùng một số dư tài khoản.

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

- [Mở ví dụ GET (tốn 1 tín dụng dùng thử theo IP)](https://api.genderapi.io/api/v2/gender?type=name&value=Huong&country=VN&ai_mode=off)
- [Thiết lập khóa API](https://www.genderapi.io/vi/docs/v2/authentication#environment-setup)
- [Hiểu phản hồi JSON](https://www.genderapi.io/vi/docs/v2/responses)

## Bạn muốn làm gì?

Chọn loại đầu vào để xem ví dụ chạy được bằng cURL, JavaScript, Python, PHP, Java, C# và Go. Khi đã sẵn sàng xử lý phản hồi thực tế, hãy dùng các hướng dẫn về kết quả và tính phí.

- [Khóa API và dùng thử theo IP](https://www.genderapi.io/vi/docs/v2/authentication): Kết nối khóa API hoặc dùng thử API miễn phí.
- [Tham số yêu cầu](https://www.genderapi.io/vi/docs/v2/request-parameters): Chọn trường đầu vào, ngữ cảnh quốc gia và tùy chọn yêu cầu.
- [SDK chính thức](https://www.genderapi.io/vi/docs/v2/sdks): Cài đặt thư viện máy khách chính thức cho ngôn ngữ lập trình của bạn.
- [Giới tính từ tên](https://www.genderapi.io/vi/docs/v2/gender-from-name): Tra cứu tên hoặc họ tên đầy đủ.
- [Giới tính từ email](https://www.genderapi.io/vi/docs/v2/gender-from-email): Tìm tín hiệu tên trong địa chỉ email.
- [Giới tính từ tên người dùng](https://www.genderapi.io/vi/docs/v2/gender-from-username): Dùng tên người dùng hoặc biệt danh làm đầu vào.
- [Yêu cầu hàng loạt (batch)](https://www.genderapi.io/vi/docs/v2/batch): Xử lý tối đa 50 tên, địa chỉ email hoặc tên người dùng cùng lúc.
- [Xác thực số điện thoại](https://www.genderapi.io/vi/docs/v2/phone-validation): Kiểm tra và định dạng số điện thoại.
- [Đọc phản hồi](https://www.genderapi.io/vi/docs/v2/responses): Đọc dự đoán, giá trị độ tin cậy và kết quả không xác định.
- [AI và biệt danh](https://www.genderapi.io/vi/docs/v2/ai-options): Chọn khi nào dùng AI và cách xử lý biệt danh.
- [Tín dụng và số dư](https://www.genderapi.io/vi/docs/v2/credits-and-usage): Kiểm tra số dư và chi phí của từng yêu cầu.
- [Lỗi và thử lại](https://www.genderapi.io/vi/docs/v2/errors-and-retries): Khắc phục lỗi và quyết định khi nào nên thử lại.
- [Chuyển từ V1](https://www.genderapi.io/vi/docs/v2/migration): Cập nhật tích hợp hiện có mà vẫn dùng cùng khóa API.

## Tham chiếu endpoint

Ghép https://api.genderapi.io với các đường dẫn tuyệt đối trong bảng này, ví dụ: https://api.genderapi.io/api/v2/gender. Tham số truy vấn chỉ được hỗ trợ trên GET /gender. Dùng nội dung JSON cho các endpoint POST; không gửi các trường của V1 như name, email, username hoặc askToAI trong yêu cầu V2.

| Phương thức | Đường dẫn | Mục đích |
| --- | --- | --- |
| GET | /api/v2 | Tính năng công khai và giới hạn hiện tại; miễn phí. |
| GET | /api/v2/openapi.json | Hợp đồng OpenAPI chuẩn; miễn phí. |
| GET | /api/v2/errors | Danh mục lỗi mà máy có thể đọc; miễn phí. |
| GET | /api/v2/usage | Số dư hiện tại của tài khoản hoặc dùng thử theo IP; miễn phí. |
| GET / POST | /api/v2/gender | Một tên, địa chỉ email hoặc tên người dùng. |
| POST | /api/v2/gender/batch | Một lô có thứ tự gồm tên, địa chỉ email và/hoặc tên người dùng. |
| POST | /api/v2/phone/validate | Xác thực và định dạng số điện thoại. |