Gender API cho tên, địa chỉ email và tên người dùng
Ước tính giới tính có khả năng cao từ tên, họ tên đầy đủ, địa chỉ email hoặc tên người dùng. GenderAPI.io V2 trả về JSON có cấu trúc, kèm nguồn của dự đoán, điểm độ tin cậy và ngữ cảnh quốc gia tùy chọn.
Kiểm tra từng mục, gửi yêu cầu hàng loạt hoặc dùng công cụ bảng tính của chúng tôi. V2 phân biệt kết quả có dự đoán với kết quả không có dự đoán, nhờ đó ứng dụng của bạn giữ nguyên sự không chắc chắn thay vì ép ra một ước tính.
Phạm vi phụ thuộc vào tên và quốc gia
Toàn cầu
Độ tin cậy kèm nguồn và cách diễn giải
0–1
Kết quả và số tín dụng đã dùng trong JSON
V2
Mục mỗi lô khi dùng khóa API; 10 khi dùng thử theo IP
50
Giới tính từ tên
Ước tính giới tính từ tên hoặc họ tên đầy đủ
Nhận ước tính kèm điểm độ tin cậy và nguồn của dự đoán. Khi không thể dự đoán, V2 ghi rõ đó là kết quả không xác định.
Nhận diện các tên phổ biến trong tên người dùng. Với forceToGenderize, bạn có thể yêu cầu ước tính cả cho biệt danh không chứa tên thật, nhưng không bảo đảm sẽ có dự đoán.
Bắt đầu với REST API hoặc kết nối GenderAPI.io với bảng tính, nền tảng thương mại điện tử và công cụ tự động hóa. Mỗi hướng dẫn cho biết tích hợp đó dùng phiên bản API nào.
REST APIGoogle SheetsExcel và CSVShopifyAirtableZapierMakeIntegrately
GenderAPI.io ước tính giới tính có khả năng cao từ tên, địa chỉ email hoặc tên người dùng. V2 trả về dự đoán, độ tin cậy, nguồn và số tín dụng đã dùng trong JSON. Đây là các ước tính dựa trên những mẫu thường gặp trong tên; chúng không xác nhận bản dạng giới do một người tự công bố.
Khi nào V2 dùng AI?
Một yêu cầu đơn lẻ tra cứu tập dữ liệu trước. Nếu tập dữ liệu không có dự đoán, AI sẽ được dùng theo mặc định. Chế độ mặc định này tốn tổng cộng 1 tín dụng, đã bao gồm AI. Với yêu cầu hàng loạt, AI bị tắt theo mặc định. Bạn có thể chọn một chế độ AI hoặc bật forceToGenderize để phân tích biệt danh.
Nên hiểu độ tin cậy và kết quả không xác định như thế nào?
Trong V2, trường confidence chứa giá trị từ 0 đến 1 hoặc null. Trường confidence_kind cho biết đó là tần suất quan sát được trong tập dữ liệu hay giá trị do mô hình báo cáo; độ tin cậy không bảo đảm kết quả là đúng. Khi không có dự đoán, phản hồi chứa gender: null và result_status: unknown.
Một yêu cầu tốn bao nhiêu tín dụng?
Một yêu cầu V2 tiêu chuẩn tốn 1 tín dụng, kể cả khi dùng AI hoặc khi kết quả được xử lý thành công nhưng không có dự đoán. Chế độ AI always tốn 2 tín dụng. Với forceToGenderize, dự đoán từ tập dữ liệu tốn 1 tín dụng; nếu cần AI, tổng chi phí là 2 tín dụng. Yêu cầu hàng loạt được tính phí theo từng mục.
Tôi có thể gửi nhiều mục trong một yêu cầu không?
Có. V2 nhận tối đa 50 mục mỗi lô với khóa API hợp lệ hoặc tối đa 10 mục khi dùng thử theo IP. Vì vậy, một yêu cầu HTTP có thể tiêu tốn nhiều tín dụng. Bạn cũng có thể xử lý các tệp lớn hơn bằng công cụ Excel và CSV hoặc qua các tích hợp khác.
Tôi có thể dùng thử API miễn phí không?
Khi không có khóa API, bản demo V2 dùng thử theo IP với 10 tín dụng mỗi 24 giờ, được chia sẻ cho mọi người dùng chung một địa chỉ IP. Tài khoản miễn phí nhận 200 tín dụng mỗi ngày. Đây là hạn mức tín dụng, không phải số yêu cầu cố định: các chế độ 2 tín dụng làm số dư giảm nhanh hơn.
Khóa API hiện tại của tôi có dùng được với V2 không?
Có. V1 và V2 dùng cùng khóa API và cùng số dư tài khoản. Các tích hợp V1 hiện có vẫn hoạt động. Tích hợp mới nên được xây dựng theo tài liệu V2, vì endpoint, trường phản hồi và định dạng lỗi khác với V1.
Bắt đầu phát triển
Dùng thử GenderAPI.io miễn phí
Tạo tài khoản, thử các yêu cầu đầu tiên với 200 tín dụng miễn phí mỗi ngày và xử lý tệp Excel hoặc CSV khi cần.