# Bảng giá GenderAPI.io Gói API và tín dụng

> Bắt đầu với tài khoản miễn phí, chọn tín dụng hằng tháng cho nhu cầu sử dụng thường xuyên hoặc mua một gói tín dụng bằng thanh toán một lần. Mỗi yêu cầu V2 tốn 1 hoặc 2 tín dụng tùy theo tùy chọn AI.

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

Last reviewed: 2026-09-29

## Tài khoản miễn phí và dùng thử theo IP

Tài khoản miễn phí đã đăng ký dùng khóa API và nhận 200 tín dụng mỗi ngày. Số tín dụng này đủ cho tối đa 200 yêu cầu tiêu chuẩn 1 tín dụng; một số chế độ AI tốn 2 tín dụng cho mỗi mục.

Dùng thử theo IP của V2 cung cấp 10 tín dụng cho mỗi địa chỉ IP công khai trong mỗi 24 giờ, không cần đăng ký. Chế độ này được dùng khi thiếu khóa API, khóa sai định dạng hoặc không được nhận diện. Mọi người dùng chung một địa chỉ IP công khai sẽ chia sẻ số dư này, và lượt dùng thử của V1 cũng được trừ vào cùng số dư đó. Khóa đã được nhận diện nhưng bị vô hiệu hóa, hết hạn hoặc bị hạn chế sẽ không chuyển sang dùng thử theo IP.

## Gói tín dụng

Giá được lấy từ cùng danh mục với trang HTML. Trước khi mua, hãy kiểm tra các điều kiện hiện hành và tổng số tiền trên trang bảng giá.

| Gói | Tín dụng | Hằng tháng (EUR) | Thanh toán một lần (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 |

## Mức tiêu thụ tín dụng trong V2

Tín dụng phản ánh khối lượng công việc đã hoàn thành, không phải số yêu cầu HTTP. Mức phí dưới đây áp dụng cho các yêu cầu V2 với tên, địa chỉ email và tên người dùng. V1 và V2 dùng khóa API hiện có của bạn và cùng một số dư tài khoản.

Kết quả được xử lý thành công nhưng không có dự đoán (gender: null) vẫn bị tính phí theo mức của chế độ đã chọn. Lỗi xác thực đầu vào xảy ra trước khi tính phí không tiêu tốn tín dụng; dự đoán không thành công không bị tính phí sau khi việc hoàn trả được xác nhận. Hãy kiểm tra billing_status nếu kết quả tính phí chưa được xác nhận.

Yêu cầu hàng loạt được tính phí theo từng mục xử lý thành công, không phải một lần cho mỗi yêu cầu HTTP. Theo mặc định, các mục trong lô chỉ dùng tập dữ liệu; hãy đặt fallback, always hoặc forceToGenderize cho từng mục khi cần. Một lô gồm 50 mục tiêu chuẩn xử lý thành công, mỗi mục 1 tín dụng, tốn 50 tín dụng. Lô dùng khóa API nhận tối đa 50 mục, lô dùng thử theo IP nhận tối đa 10 mục.

Chỉ cần số dư còn lại ít nhất 1 tín dụng là có thể bắt đầu một yêu cầu đơn lẻ hoặc một yêu cầu hàng loạt. Toàn bộ chi phí vẫn được trừ nên số dư có thể âm: một yêu cầu 2 tín dụng bắt đầu khi còn 1 tín dụng sẽ để lại số dư -1. Khi số dư bằng 0 hoặc âm, các thao tác tính phí tiếp theo sẽ bị chặn.

Mỗi yêu cầu gửi lại là một thao tác riêng và được tính phí như bình thường. Không tự động gửi lại các yêu cầu chưa rõ kết quả hoặc chưa rõ việc tính phí.

| Thao tác | Tín dụng cho mỗi mục | Mô tả |
| --- | --- | --- |
| Chỉ dùng tập dữ liệu | 1 | Với ai_mode: off, hệ thống chỉ tra cứu tập dữ liệu và không gọi AI. |
| Yêu cầu tiêu chuẩn với AI dự phòng tự động | 1 | Với ai_mode: fallback, hệ thống kiểm tra tập dữ liệu trước và chỉ dùng AI khi không xác định được giới tính. Tổng chi phí là 1 tín dụng, kể cả khi có dùng AI. Đây là chế độ mặc định cho yêu cầu đơn lẻ. |
| Yêu cầu gửi thẳng đến AI | 2 | Với ai_mode: always, hệ thống bỏ qua tập dữ liệu và gửi yêu cầu thẳng đến AI. |
| Phân tích biệt danh: kết quả từ tập dữ liệu | 1 | Với forceToGenderize: true, hệ thống kiểm tra tập dữ liệu trước. Giới tính được xác định từ tập dữ liệu tốn 1 tín dụng. |
| Phân tích biệt danh: kết quả từ AI | 2 | Nếu với forceToGenderize: true mà tập dữ liệu không xác định được giới tính, AI sẽ diễn giải tên, địa chỉ email hoặc tên người dùng, kể cả khi không có tên thật. Tổng chi phí là 2 tín dụng. |
| Xác thực số điện thoại | 1 | Mỗi lần xác thực số điện thoại hoàn tất tốn 1 tín dụng, kể cả khi kết quả là valid: false. |
| Kiểm tra số dư | 0 | GET /api/v2/usage không tiêu tốn tín dụng nhưng vẫn được tính vào giới hạn tần suất yêu cầu. |

## Giới hạn yêu cầu

V2 áp dụng giới hạn tần suất yêu cầu và giới hạn số yêu cầu đồng thời cho mọi gói. Số dư tín dụng và giới hạn tần suất là hai việc độc lập: hãy xử lý HTTP 429 và chờ đúng thời gian ghi trong tiêu đề Retry-After trước khi gửi yêu cầu tiếp theo. Giá trị mặc định hiện tại và các tiêu đề phản hồi được mô tả trong tài liệu V2.

- [Hướng dẫn về tín dụng và số dư trong V2](https://www.genderapi.io/vi/docs/v2/credits-and-usage)
- [Hướng dẫn về lỗi và thử lại trong V2](https://www.genderapi.io/vi/docs/v2/errors-and-retries)
- [Tài liệu V1](https://www.genderapi.io/vi/api-documentation/v1)

## Mỗi yêu cầu API có luôn tốn đúng 1 tín dụng không?

Không. Một yêu cầu V2 tiêu chuẩn tốn 1 tín dụng, đã bao gồm AI dự phòng tự động. ai_mode: always tốn 2 tín dụng. forceToGenderize tốn 1 tín dụng khi kết quả đến từ tập dữ liệu hoặc 2 tín dụng khi dùng AI. Yêu cầu hàng loạt được tính phí theo từng mục xử lý thành công, và kết quả không xác định được xử lý thành công cũng bị tính phí.

## Tài khoản miễn phí và dùng thử theo IP khác nhau thế nào?

Tài khoản đã đăng ký dùng khóa API và nhận 200 tín dụng miễn phí mỗi ngày. Dùng thử theo IP của V2 không cần khóa, cung cấp 10 tín dụng cho mỗi địa chỉ IP công khai trong mỗi 24 giờ, được chia sẻ với những người dùng khác trên cùng IP và với lượt dùng thử của V1. Cả hai đều áp dụng mức phí thông thường cho từng yêu cầu.

## Gói trả phí có bị giới hạn tần suất yêu cầu không?

Có. V2 áp dụng giới hạn tần suất yêu cầu và giới hạn số yêu cầu đồng thời, độc lập với số dư tín dụng. Mua gói tín dụng lớn hơn không loại bỏ các giới hạn này. Hãy xử lý HTTP 429, tuân theo Retry-After và kiểm tra giới hạn hiện tại trong tài liệu V2.