Câu hỏi thường gặp

Không. GenderAPI suy luận giới tính từ các tín hiệu gắn với tên hoặc, khi bật tùy chọn này, từ tín hiệu trong biệt danh. Dự đoán không phải là dữ liệu đã được xác minh về một người. Hãy giữ nguyên sự không chắc chắn, tôn trọng bản dạng giới do người đó tự công bố và không đưa ra quyết định có ảnh hưởng lớn chỉ dựa trên ước tính này.

Mã quốc gia ISO viết hoa tùy chọn cung cấp ngữ cảnh khu vực cho yêu cầu. Chỉ gửi mã này khi quốc gia có liên quan và đã biết. Cùng một tên có thể được dùng khác nhau ở từng khu vực; quốc gia được trả về mô tả mối liên hệ với tên, không chứng minh quốc tịch hay nơi cư trú.

Quốc gia và tham số yêu cầu →

confidence là giá trị từ 0 đến 1, hoặc null khi không có giá trị. Hãy đọc giá trị này cùng confidence_kind: observed_frequency là số lượng của nhóm chiếm ưu thế trong tập dữ liệu chia cho tổng số lượng; model_reported là giá trị do AI báo cáo. Các giá trị này không phải là xác suất đã hiệu chỉnh cho một người cũng không phải độ chính xác sản phẩm đã được đo lường. Hãy đặt ngưỡng xem xét dựa trên dữ liệu đại diện.

Trường phản hồi và bằng chứng →

Một kết quả V2 thành công với gender: null nghĩa là các tín hiệu hiện có không đủ để xác định giới tính. Đây là giá trị null gốc của JSON, không phải chuỗi "null". Kết quả không xác định thành công bị tính phí theo mức của chế độ đã chọn. Hãy xử lý nó như kết quả không xác định; lỗi của nhà cung cấp hoặc lỗi yêu cầu là trường hợp lỗi riêng.

Kết quả không xác định →Quy tắc tính phí tín dụng →

Có. Hãy gửi tên ở dạng Unicode, giữ nguyên ký tự gốc và các dấu có ý nghĩa, chẳng hạn dấu thanh tiếng Việt. Phạm vi hỗ trợ và độ tin cậy phụ thuộc vào tên, khu vực và tín hiệu hiện có. Vì vậy, hãy kiểm thử một mẫu đại diện cho các hệ chữ và quốc gia mà ứng dụng của bạn xử lý.

Ví dụ yêu cầu cho tên →

Có. POST /api/v2/gender/batch nhận tối đa 50 mục khi dùng khóa API hoặc tối đa 10 mục khi dùng thử theo IP. Mỗi mục có trường type và value riêng, country tùy chọn và cài đặt AI riêng. Theo mặc định, AI bị tắt cho các mục trong lô. Hãy kiểm tra từng kết quả: một lô có thể trả về HTTP 200 ngay cả khi một số mục không thành công. Tín dụng được tính theo từng mục xử lý thành công, kể cả kết quả không xác định.

Yêu cầu hàng loạt và lỗi một phần →

Dùng type: email với một địa chỉ hợp lệ. API tìm tín hiệu tên có thể dùng được trong phần cục bộ trước ký tự @; tên miền không cho biết danh tính hay quốc gia của một người. Hộp thư dùng chung và địa chỉ không có tín hiệu tên có thể cho kết quả không xác định. Theo mặc định, yêu cầu đơn lẻ dùng AI khi tập dữ liệu không đưa ra kết quả.

Ví dụ yêu cầu cho địa chỉ email →

Dùng type: username. Yêu cầu thông thường tìm một tên nhận diện được trong tên người dùng hoặc tên hiển thị. Bí danh trừu tượng có thể cho kết quả không xác định. Hãy bật forceToGenderize nếu bạn muốn dùng AI có phân tích biệt danh sau khi tập dữ liệu không cho kết quả; khi đó giới tính có thể được xác định ngay cả khi không trích xuất được tên thật.

Ví dụ tên người dùng và biệt danh →

Theo mặc định, yêu cầu đơn lẻ dùng options.ai_mode: fallback: hệ thống tra cứu tập dữ liệu trước và dùng AI nếu chưa xác định được giới tính, với tổng chi phí 1 tín dụng. off chỉ dùng tập dữ liệu với giá 1 tín dụng; always bỏ qua tập dữ liệu và dùng AI với giá 2 tín dụng. Các mục trong lô dùng off theo mặc định và có thể bật AI cho từng mục. Không chế độ nào bảo đảm kết quả khác null.

Tùy chọn AI và chi phí →

Cờ tùy chọn này dùng được với tên, địa chỉ email và tên người dùng, kể cả với từng mục trong lô. Kết quả được xác định từ tập dữ liệu tốn 1 tín dụng. Nếu không, AI có phân tích biệt danh sẽ được dùng, với tổng chi phí 2 tín dụng, kể cả khi kết quả thành công vẫn là không xác định. Không cần có tên thật. Hãy bỏ qua ai_mode hoặc dùng fallback; kết hợp cờ này với off hoặc always sẽ trả về 422.

Phân tích biệt danh →

Đọc meta.usage.charged_credits để biết số tín dụng thực tế đã tính cho một thao tác và billing_status để biết việc tính phí đã được xác nhận hay chưa. Dự đoán thông thường từ tập dữ liệu và ở chế độ fallback tốn 1 tín dụng cho mỗi mục xử lý thành công; always và AI có phân tích biệt danh tốn 2 tín dụng. 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à không hợp lệ. Chỉ cần số dư ban đầu dương, nên lần tính phí cuối cùng có thể làm số dư âm. Tín dụng của các dự đoán không thành công được hoàn trả; khoản phí chưa được xác nhận cần được bộ phận hỗ trợ kiểm tra.

Tín dụng và mức sử dụng →Xem các gói →

Có. Giá trị mặc định hiện tại là 120 yêu cầu mỗi phút cho mỗi tài khoản, 600 yêu cầu mỗi phút cho mỗi địa chỉ IP và 2 thao tác đồng thời cho mỗi tài khoản. Ngoài ra còn áp dụng dung lượng dùng chung của dịch vụ. Nội dung yêu cầu POST tối đa 64 KiB; lô nhận 50 mục khi dùng khóa hoặc 10 mục khi dùng thử theo IP. Hãy xử lý HTTP 429 và Retry-After thay vì cho rằng mọi yêu cầu trong các giới hạn này luôn được chấp nhận.

Giới hạn và cách xử lý thử lại →

Mỗi yêu cầu dự đoán là một thao tác mới và được tính phí như bình thường. Hết thời gian chờ hoặc mất phản hồi không chứng minh rằng không có tín dụng nào bị trừ. Hãy kiểm tra billing_status trước khi thử lại; nếu việc tính phí chưa được xác nhận, hãy liên hệ bộ phận hỗ trợ kèm request_id. Với lô thất bại một phần, chỉ gửi lại các mục không thành công sau khi việc tính phí đã được xác nhận. Khi gặp 429, hãy tuân theo tiêu đề Retry-After.

Lỗi và thử lại an toàn →

Các hướng dẫn V2 có ví dụ bằng cURL, JavaScript, Python, PHP, Java, C# và Go. Swagger và Postman dùng cùng một hợp đồng V2. Hãy chọn loại đầu vào và lưu khóa API trong cấu hình phía máy chủ.

Tài liệu V2 →Swagger V2 →

Có. Các tích hợp V1 hiện có vẫn giữ endpoint và định dạng phản hồi của chúng. V1 và V2 dùng cùng khóa API và cùng số dư, nhưng khác nhau về trường yêu cầu, phản hồi và lỗi. Hãy dùng tài liệu V1 riêng để duy trì client hiện có và dùng hướng dẫn chuyển đổi khi bạn muốn nâng cấp lên V2.

Tài liệu V1 →Chuyển từ V1 sang V2 →

Chính sách quyền riêng tư giải thích những dữ liệu yêu cầu, dữ liệu vận hành và nhật ký bảo mật nào có thể được lưu giữ, chúng được xử lý cho mục đích gì và việc xóa diễn ra như thế nào. Hãy kiểm tra các thông tin này cho tích hợp của bạn và không gửi dữ liệu cá nhân không cần thiết.

Chính sách quyền riêng tư →

Chính sách quyền riêng tư mô tả cách xử lý địa chỉ email trong yêu cầu và dữ liệu kỹ thuật liên quan. Địa chỉ email có thể là dữ liệu cá nhân: chỉ gửi những gì yêu cầu cần và không lưu địa chỉ đầy đủ trong nhật ký chẩn đoán của bạn.

Địa chỉ email và quyền riêng tư →

Chính sách quyền riêng tư quy định việc lưu giữ, xóa và sao lưu tệp đã tải lên. Hãy xuất các kết quả bạn cần và xóa tệp bằng chức năng của không gian làm việc khi không còn cần đến. Liên hệ bộ phận hỗ trợ nếu bạn có câu hỏi về yêu cầu lưu giữ của tổ chức mình.

Lưu giữ tệp →Liên hệ hỗ trợ →

Chính sách quyền riêng tư và thông tin về bên xử lý phụ mô tả cách nhà cung cấp dịch vụ xử lý dữ liệu và những biện pháp bảo vệ được áp dụng. Hãy xem xét các tài liệu này và mọi thỏa thuận áp dụng cho tài khoản của bạn khi đánh giá nơi dữ liệu của bạn được xử lý.

Chính sách quyền riêng tư →Bên xử lý phụ →Thông tin về GDPR →

Có. Tài khoản miễn phí đã đăng ký nhận 200 tín dụng mỗi ngày. Độc lập với tài khoản nà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 V1 và với những người dùng khác trên cùng địa chỉ IP. Cả hai đều áp dụng mức phí thông thường; số tín dụng không phải lúc nào cũng bằng số yêu cầu HTTP.

Gói miễn phí và bảng giá →Dùng thử theo IP →

Dùng Authorization: Bearer YOUR_API_KEY trong mã phía máy chủ đáng tin cậy; yêu cầu POST còn cần Content-Type: application/json. Không đưa khóa thật vào mã trình duyệt, kho mã công khai hoặc nhật ký. Khóa bị thiếu, sai định dạng hoặc không được nhận diện có thể dẫn đến dùng thử theo IP; vì vậy hãy kiểm tra meta.access.mode có giá trị api_key. 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ử.

Xác thực V2 →

Gọi GET /api/v2/usage với khóa Bearer của bạn. Việc kiểm tra số dư này miễn phí và trả về data.remaining_credits. Khi không có khóa, hệ thống đọc số dư dùng chung của dùng thử theo IP. V1 và V2 dùng cùng số dư tài khoản; giá trị remaining_credits trong một dự đoán là số dư tại thời điểm thao tác đó hoàn tất.

Số dư và mức sử dụng →

Đăng nhập ứng dụng GenderAPI để quản lý gói đăng ký gắn với khóa API của bạn. Gói hiện tại và tùy chọn hủy nằm trong phần cài đặt tài khoản hiện hành.

Mở tài khoản GenderAPI →

Bạn có thể quản lý cài đặt hóa đơn và thanh toán cho từng khóa API hoặc gói đăng ký sau khi đăng nhập ứng dụng GenderAPI.

Mở tài khoản GenderAPI →

Gửi cho bộ phận hỗ trợ phiên bản API, endpoint, request_id và một ví dụ ngắn có thể tái hiện. Nêu mã lỗi nếu có, nhưng hãy xóa khóa API và dữ liệu cá nhân nhạy cảm.

Gửi email cho bộ phận hỗ trợ →