# Nguồn dữ liệu và nguồn gốc dữ liệu của GenderAPI.io V2

> Tìm hiểu các nhãn source của GenderAPI.io V2, bản thống kê cơ sở dữ liệu có ghi ngày, các phép kiểm tra tính nhất quán trên mẫu và giới hạn của bằng chứng hiện có về nguồn gốc dữ liệu.

Canonical HTML: https://www.genderapi.io/vi/data-provenance

Last reviewed: 2026-09-29

## source trong V2 có nghĩa là gì?

Trường source cho biết đường xử lý đã tạo ra kết quả cuối cùng: tra cứu tập dữ liệu đã lưu, suy luận bằng AI hoặc không có nguồn nào được chọn. Trường này không phải trích dẫn nhà phát hành gốc của một tập dữ liệu, không phải chứng nhận giấy phép và không bảo đảm rằng suy luận là đúng.

Hướng dẫn này mô tả hợp đồng phản hồi hiện tại của V2 và một hồ sơ cơ sở dữ liệu do chính GenderAPI.io lập. Các quan sát cơ sở dữ liệu dưới đây là thống kê số lượng và kiểm tra tính nhất quán đã đo; danh mục nguồn đã được xem xét và phép đo chuẩn độ chính xác độc lập vẫn chưa được công bố.

| source | Cho bạn biết điều gì | Không chứng minh điều gì |
| --- | --- | --- |
| `dataset` | Một bản ghi đã lưu được chọn; khi số lượng bằng nhau tuyệt đối, giới tính vẫn có thể không xác định | Nhà phát hành gốc, phương pháp thu thập, giấy phép, độ cũ của bản ghi hay tính độc lập của các quan sát |
| `ai` | Phản hồi cuối cùng đến từ đường suy luận AI đã được cấu hình; giới tính vẫn có thể là null | Một mẫu đã được đếm, trích dẫn tập dữ liệu hay độ chính xác dự đoán đã được hiệu chỉnh |
| `none` | Không có bản ghi đã lưu nào được chọn cho kết quả cuối cùng ở chế độ chỉ dùng tập dữ liệu | Rằng đầu vào không có mối liên hệ nào với tên trong mọi cộng đồng hoặc ngôn ngữ |

## Hồ sơ cơ sở dữ liệu: 26 tháng 9, 2026

Siêu dữ liệu của collection được đọc lúc 2026-09-26T15:28:18.227Z; các mẫu ngẫu nhiên được đọc lúc 2026-09-26T15:31:54.045Z. Cả hai số lượng đều lấy từ siêu dữ liệu MongoDB collStats của từng collection, không phải từ một lần đếm toàn bộ riêng. Collection chung chứa các bản ghi tên đã lưu; collection theo quốc gia chứa các bản ghi tên kèm quốc gia đã lưu. Không được cộng hai số lượng này thành tổng số tên duy nhất hay số người duy nhất.

Với mỗi collection, MongoDB lấy ngẫu nhiên 5.000 bản ghi và tính các phép kiểm tra tổng hợp dưới đây trên máy chủ cơ sở dữ liệu. Báo cáo công khai không chứa tên hay bản ghi gốc nào. Đây là quan sát do chính GenderAPI.io thực hiện trên cơ sở dữ liệu đang hoạt động, không phải kiểm toán độc lập hay tập dữ liệu đánh giá cố định. Các phép kiểm tra này xem xét tính nhất quán của số lượng, không cho biết độ chính xác dự đoán, số người hay số tên duy nhất, hoặc độ bao phủ của API.

| Quan sát | Bản ghi chung | Bản ghi theo quốc gia |
| --- | --- | --- |
| Collection | general | country-specific |
| Số bản ghi theo siêu dữ liệu | 2.483.220 | 4.080.692 |
| Khóa duy nhất đã lưu | name | name + country |
| Số bản ghi được lấy mẫu ngẫu nhiên | 5.000 | 5.000 |
| Số lỗi quy tắc số học trong mẫu | 0 | 0 |
| Số trường hợp male + female khác total trong mẫu | 0 | 0 |
| Số trường hợp male và female bằng nhau trong mẫu | 124 | 94 |
| Số bản ghi có trường updated_at trong mẫu | 667 / 5.000 | 741 / 5.000 |

- [Tải xuống hồ sơ tổng hợp có ghi ngày (JSON)](https://www.genderapi.io/data-evidence/v2-dataset-profile.json)

## Những gì các phép kiểm tra cơ sở dữ liệu xác lập

Phép kiểm tra số học yêu cầu total là số nguyên an toàn dương, còn số lượng male và female là số hữu hạn nằm trong khoảng từ 0 đến total. Một phép kiểm tra riêng so sánh male + female với total. Mọi bộ đếm trong mẫu đều vượt qua các phép kiểm tra này; điều đó không có nghĩa là mọi bản ghi trong các collection đều nhất quán hay bất kỳ dự đoán nào là đúng.

Số lượng male và female bằng nhau xuất hiện ở 124 dòng trong mẫu của collection chung và 94 dòng trong mẫu của collection theo quốc gia. Đây là các trường hợp số lượng đã lưu bằng nhau, không phải bản dạng giới mơ hồ đã được kiểm chứng độc lập hay tỷ lệ không xác định của API. Kết quả API thực tế phụ thuộc vào đầu vào, tính sẵn sàng của Redis, việc chọn ứng viên và thiết lập AI.

Một lần thống kê riêng trường country của collection chung lúc 2026-09-26T15:33:13.811Z tìm thấy 244 giá trị đã lưu khác nhau: 239 giá trị có định dạng hai chữ cái viết hoa và 5 giá trị thì không. Việc tuân thủ ISO, phân bố bản ghi theo quốc gia và độ bao phủ các quốc gia được hỗ trợ chưa được đo. Các con số này không phải là số quốc gia được hỗ trợ.

Không có trường nguồn hay giấy phép nào xuất hiện trong hai mẫu. Điều này không chứng minh rằng mọi bản ghi hoặc hệ thống bên ngoài đều không có thông tin nguồn gốc. Việc có hay không có trường này cũng không chứng minh tình trạng giấy phép của nguồn. updated_at xuất hiện dưới dạng trường số trong một số bản ghi, nhưng giá trị và ý nghĩa của trường này chưa được kiểm tra; trường này không chứng minh độ mới của dữ liệu hay lịch cập nhật.

V2 phục vụ tra cứu tập dữ liệu từ Redis. Ngày 26 tháng 9, 2026, GenderAPI.io, với tư cách là bên quản trị hệ thống, đã xác nhận rằng MongoDB và Redis chứa cùng một tập dữ liệu. Sự trùng khớp này dựa trên xác nhận đó, không phải một phép so sánh độc lập giữa hai cơ sở dữ liệu, và việc kiểm chứng như vậy vẫn chưa hoàn tất. Thống kê ở trên mô tả các bản ghi đã lưu; độ bao phủ câu trả lời của API còn phụ thuộc vào đầu vào được gửi, việc so khớp ứng viên và thiết lập AI. Các mẫu được lấy không dùng seed cố định, được đọc mà không có snapshot cố định và không có nhãn tham chiếu độc lập; vì vậy chúng không thể đo độ chính xác dự đoán, mức hiệu chỉnh hay độ bao phủ câu trả lời.

- [Cách đo độ chính xác và độ bao phủ](https://www.genderapi.io/vi/accuracy-methodology)

## Theo dõi bằng chứng trong phản hồi

| Trường | Ý nghĩa | Giới hạn |
| --- | --- | --- |
| `input` | Trả lại loại đầu vào, giá trị và ngữ cảnh quốc gia đã gửi | Giá trị đầu vào không phải thông tin danh tính đã được xác minh độc lập |
| `match.name / match.method` | Cho biết ứng viên tra cứu được chọn và ứng viên đó có được chuẩn hóa, tách token, trích xuất dưới dạng chuỗi con hay do mô hình suy luận | Kết quả khớp theo token không bảo đảm rằng tên riêng thật đã được tách ra từ họ tên đầy đủ hoặc tên tài khoản |
| `match.scope / match.country` | Cho biết dòng đã lưu được chọn đến từ tra cứu theo quốc gia hay tra cứu toàn cầu | Việc gửi quốc gia không bảo đảm có dòng theo quốc gia |
| `sample_count` | Tổng số đã lưu của dòng được chọn; null với suy luận AI | Không nhất thiết là số người duy nhất, các quan sát được lấy mẫu độc lập hay cỡ mẫu của một đánh giá độ chính xác |
| `confidence / confidence_kind` | Phân biệt tỷ lệ tính từ số lượng đã lưu với điểm do mô hình báo cáo | Không giá trị nào là xác suất đã hiệu chỉnh về bản dạng giới của một cá nhân |
| `country / country_source` | Siêu dữ liệu quốc gia của bản ghi được trả về hoặc mối liên hệ giữa tên và quốc gia do AI đưa ra, nếu có | Không phải quốc tịch, nơi cư trú, nguồn gốc đã xác minh hay bằng chứng rằng quốc gia đầu vào đã được khớp |

- [Tài liệu tham khảo đầy đủ về phản hồi V2](https://www.genderapi.io/vi/docs/v2/responses)

## Cách so khớp đầu vào ảnh hưởng đến kết quả

Khi tra cứu tập dữ liệu, API chuẩn hóa văn bản và tạo ra các token ứng viên. Với đầu vào email, ứng viên được lấy từ phần cục bộ; với tên người dùng, ký tự @ tùy chọn ở đầu sẽ bị loại bỏ. Tra cứu email và tên người dùng thông thường cũng có thể thử các ứng viên chuỗi con trong phạm vi giới hạn. Nếu có nhiều bản ghi ứng viên, bản ghi có tổng số lượng đã lưu lớn nhất sẽ được chọn. Vì vậy, token được chọn có thể không phải là tên riêng như dự định.

Khi có ngữ cảnh quốc gia, API thử dòng theo quốc gia cho từng ứng viên và dùng dòng toàn cầu khi không có dòng theo quốc gia. Kết quả cuối cùng cho biết kết quả khớp đã được chọn. Một dòng theo quốc gia có số lượng bằng nhau sẽ không tự động bị thay bằng dòng toàn cầu của ứng viên đó.

Prompt AI thông thường yêu cầu một tên riêng có thể nhận biết được. forceToGenderize còn cho phép mối liên hệ với biệt danh hoặc bí danh cá nhân, nên ở chế độ này, giới tính khác null đi kèm name: null là hợp lệ. Đây là những tác vụ suy luận khác nhau và cần được đánh giá riêng.

- [Tra cứu theo tên](https://www.genderapi.io/vi/docs/v2/gender-from-name)
- [Tra cứu theo email](https://www.genderapi.io/vi/docs/v2/gender-from-email)
- [Tra cứu theo tên người dùng](https://www.genderapi.io/vi/docs/v2/gender-from-username)
- [Tùy chọn AI](https://www.genderapi.io/vi/docs/v2/ai-options)

## Tra cứu tập dữ liệu và xử lý bằng AI

Khi AI được gọi, V2 gửi type, value và ngữ cảnh quốc gia đã gửi đến dịch vụ suy luận AI đã được cấu hình. Với đầu vào email, prompt yêu cầu mô hình bỏ qua tên miền và hậu tố sau dấu cộng; đây không phải cam kết rằng các ký tự đó được loại khỏi giá trị trước khi AI xử lý. Hãy dùng ai_mode: off mà không có forceToGenderize khi quy trình của bạn yêu cầu chỉ dự đoán bằng tập dữ liệu.

Bộ kiểm tra phản hồi AI xác minh các trường JSON, kiểu dữ liệu và tính nhất quán giữa các trường. Việc này không chứng minh rằng tên, mối liên hệ giới tính hay mối liên hệ quốc gia được trả về là đúng trên thực tế. Kết quả công khai không bao gồm mã định danh mô hình, phiên bản mô hình hay trích dẫn cho suy luận.

| Tùy chọn | Đường suy luận | Bằng chứng được trả về |
| --- | --- | --- |
| ai_mode: off | Chỉ dùng tra cứu tập dữ liệu | Siêu dữ liệu của tập dữ liệu đã chọn, hoặc kết quả không xác định khi không có bản ghi nào được chọn |
| ai_mode: fallback | Thử tập dữ liệu trước; gọi AI nếu không có giới tính được trả về | Bằng chứng của đường xử lý cuối cùng, không phải một mẫu gộp giữa tập dữ liệu và AI |
| ai_mode: always | Dùng trực tiếp đường suy luận AI đã được cấu hình | Điểm do mô hình báo cáo hoặc kết quả không xác định với độ tin cậy null; sample_count luôn là null |
| forceToGenderize: true | Thử tập dữ liệu, sau đó dùng AI có thể phân tích biệt danh khi chưa xác định được | Bằng chứng từ tập dữ liệu hoặc mối liên hệ bí danh do mô hình báo cáo; name có thể là null |

- [Tùy chọn AI và khả năng kết hợp tham số](https://www.genderapi.io/vi/docs/v2/ai-options)
- [Chính sách quyền riêng tư](https://www.genderapi.io/vi/privacy-policy)

## Tài liệu về nguồn dữ liệu chưa được công bố

Trang này không công bố danh mục nguồn đã được xem xét. Chỉ riêng hợp đồng phản hồi và hành vi triển khai không thể xác minh nguồn gốc dữ liệu, quyền sử dụng một nguồn, tính đại diện hay chất lượng nhãn. Trước khi đưa ra tuyên bố về từng nguồn cụ thể, cần ghi lại và xem xét các bằng chứng sau.

Đợt xem xét tài liệu này không xác định việc các nguồn gốc có được cấp phép hay không, đầy đủ hay chưa đầy đủ. Nó chỉ nêu giới hạn của bằng chứng công khai. Hãy liên hệ GenderAPI.io khi mục đích sử dụng của bạn cần đánh giá theo từng nguồn.

| Bằng chứng | Hồ sơ cần có | Tình trạng công khai |
| --- | --- | --- |
| Nguồn gốc và quyền sử dụng | Tên nguồn hoặc nhà phát hành, thời gian thu thập, giấy phép hoặc cơ sở sử dụng khác đã được ghi lại | Trang này không công bố danh mục đã được xem xét |
| Quá trình xử lý | Chuyển đổi, chuẩn hóa, loại bỏ trùng lặp, tổng hợp và mọi phần đóng góp từ dữ liệu tổng hợp nhân tạo hoặc do mô hình tạo ra | Nhãn source: dataset không thể hiện thông tin này |
| Độ bao phủ cộng đồng | Độ bao phủ theo quốc gia và hệ chữ, quy trình chọn lọc, định nghĩa nhãn và thiên lệch đã được ghi nhận | Trang này không công bố số liệu độ bao phủ được đánh giá độc lập |
| Độ mới | Mã định danh snapshot, ngày cập nhật theo từng nguồn và lịch cập nhật được hỗ trợ | Phản hồi V2 không có thông tin về độ mới theo từng bản ghi hay mã định danh snapshot |
| Chất lượng và chỉnh sửa | Kết quả xác thực, kiểm tra trùng lặp, cách xử lý chỉnh sửa hoặc xóa và trách nhiệm xem xét | Trang này không công bố kết quả kiểm toán theo từng nguồn |

## Quyền riêng tư, xử lý dữ liệu và sử dụng có trách nhiệm

Nguồn gốc dữ liệu, việc xử lý dữ liệu cá nhân và điều khoản pháp lý là những câu hỏi khác nhau. Hãy tham khảo các chính sách hiện đang được công bố để biết vai trò xử lý, thời gian lưu giữ, nhà cung cấp và điều khoản hợp đồng. Hướng dẫn kỹ thuật này không bổ sung cam kết lưu giữ mới và không chứng nhận việc tuân thủ pháp luật.

Chỉ gửi thông tin cần thiết cho quy trình của bạn. Hãy giữ nguyên loại độ tin cậy và kết quả không xác định, và đừng mô tả một suy luận là danh tính do chính người đó tự công bố. Không dùng giới tính được suy luận làm cơ sở cho các quyết định có ảnh hưởng quan trọng đến một cá nhân.

- [Chính sách quyền riêng tư](https://www.genderapi.io/vi/privacy-policy)
- [Thỏa thuận xử lý dữ liệu](https://www.genderapi.io/vi/data-processing-agreement)
- [Danh sách bên xử lý dữ liệu phụ](https://www.genderapi.io/vi/subprocessors)
- [Thông tin về GDPR](https://www.genderapi.io/vi/gdpr-compliance)
- [Điều khoản](https://www.genderapi.io/vi/terms)
- [Liên hệ GenderAPI.io](https://www.genderapi.io/vi/contact)

## Bằng chứng độ chính xác và lịch sử xem xét

Nhãn source giải thích đường suy luận, không phải chất lượng đã đo của đường đó. Hãy dùng hướng dẫn về độ chính xác để phân biệt điểm trong phản hồi, độ bao phủ câu trả lời, lỗi và thông tin cần cho một đánh giá có thể tái lập.

| Ngày | Phiên bản tài liệu | Thay đổi |
| --- | --- | --- |
| 2026-09-29 | 1.0.0 | Bản tiếng Việt về thống kê MongoDB có ghi ngày, các phép kiểm tra tính nhất quán trên mẫu, các trường source và match của V2, phạm vi xử lý bằng AI và những thiếu sót còn lại của danh mục nguồn. Sự trùng khớp giữa MongoDB và Redis dựa trên xác nhận của GenderAPI.io ngày 26 tháng 9, 2026; phép so sánh độc lập vẫn chưa hoàn tất. Không bổ sung tỷ lệ phần trăm độ chính xác hay tuyên bố về giấy phép của nguồn. |

- [Giải thích về độ chính xác và độ tin cậy](https://www.genderapi.io/vi/accuracy-methodology)