source ใน V2 หมายถึงอะไร?
ฟิลด์ source แสดงเส้นทางที่สร้างผลลัพธ์สุดท้าย ได้แก่ การค้นหาในชุดข้อมูลที่จัดเก็บไว้ การคาดการณ์ด้วย AI หรือไม่มีแหล่งที่ถูกเลือก ฟิลด์นี้ไม่ใช่การอ้างอิงถึงผู้เผยแพร่ต้นทางของชุดข้อมูล ไม่ใช่หลักฐานการอนุญาตใช้สิทธิ์ และไม่ใช่การรับรองว่าการคาดการณ์ถูกต้อง
คู่มือนี้อธิบายข้อกำหนดการตอบกลับของ V2 ในปัจจุบันและโปรไฟล์ฐานข้อมูลที่ GenderAPI.io จัดทำเอง ข้อสังเกตด้านล่างเป็นการนับจำนวนที่วัดได้และการตรวจสอบความสอดคล้อง ยังไม่มีการเผยแพร่แคตตาล็อกแหล่งข้อมูลต้นทางที่ผ่านการตรวจทานและการวัดความแม่นยำที่เป็นอิสระ
| source | สิ่งที่บอก | สิ่งที่ไม่ได้ยืนยัน |
|---|---|---|
dataset | มีการเลือกแถวที่จัดเก็บไว้ หากจำนวนเท่ากันพอดี เพศอาจถูกส่งคืนเป็นไม่ทราบ | ผู้เผยแพร่ต้นทาง วิธีรวบรวม สิทธิ์การใช้งาน เวลาที่สร้างแถว และความเป็นอิสระของการสังเกต |
ai | การตอบกลับสุดท้ายมาจากเส้นทางการคาดการณ์ด้วย AI ที่กำหนดค่าไว้ เพศยังอาจเป็น null | ตัวอย่างที่นับไว้ การอ้างอิงชุดข้อมูล และความแม่นยำของการคาดการณ์ที่ปรับเทียบแล้ว |
none | ผลลัพธ์สุดท้ายในโหมดเฉพาะชุดข้อมูลไม่มีแถวที่จัดเก็บไว้ซึ่งถูกเลือก | ข้อเท็จจริงว่าข้อมูลนำเข้าไม่อาจเชื่อมโยงกับชื่อในประชากรหรือภาษาใดเลย |
โปรไฟล์ฐานข้อมูล: 26 กันยายน 2026
อ่านเมตาดาทาของคอลเลกชันเมื่อ 2026-09-26T15:28:18.227Z และอ่านตัวอย่างสุ่มเมื่อ 2026-09-26T15:31:54.045Z จำนวนทั้งสองมาจากเมตาดาทา collStats ของ MongoDB ในแต่ละคอลเลกชัน ไม่ใช่การนับทั้งหมดแยกต่างหาก คอลเลกชันทั่วไปเก็บแถวชื่อ ส่วนคอลเลกชันตามประเทศเก็บแถวชื่อและประเทศ อย่านำจำนวนทั้งสองมารวมกันเพื่อใช้เป็นจำนวนชื่อที่ไม่ซ้ำหรือจำนวนบุคคลที่ไม่ซ้ำ
MongoDB สุ่มเอกสาร 5,000 รายการจากแต่ละคอลเลกชัน และคำนวณการตรวจสอบแบบรวมด้านล่างบนเซิร์ฟเวอร์ฐานข้อมูล รายงานสาธารณะไม่มีชื่อหรือเรคคอร์ดดิบ นี่เป็นผลการสังเกตฐานข้อมูลที่ใช้งานจริงโดย GenderAPI.io เอง ไม่ใช่การตรวจสอบอิสระหรือชุดข้อมูลการประเมินที่ตรึงไว้ การตรวจสอบนี้ครอบคลุมความสอดคล้องของจำนวน ไม่ได้ครอบคลุมความแม่นยำของการคาดการณ์ จำนวนบุคคลหรือชื่อที่ไม่ซ้ำ หรือความครอบคลุมของ API
| สิ่งที่สังเกต | แถวทั่วไป | แถวตามประเทศ |
|---|---|---|
| คอลเลกชัน | general | country-specific |
| จำนวนเอกสารตามเมตาดาทา | 2,483,220 | 4,080,692 |
| คีย์ที่ไม่ซ้ำที่จัดเก็บไว้ | name | name + country |
| เอกสารที่สุ่มมา | 5,000 | 5,000 |
| การละเมิดกฎเชิงตัวเลขในตัวอย่าง | 0 | 0 |
| กรณีในตัวอย่างที่ male + female ไม่เท่ากับ total | 0 | 0 |
| กรณีในตัวอย่างที่จำนวน male และ female เท่ากัน | 124 | 94 |
| กรณีในตัวอย่างที่มีฟิลด์ updated_at | 667 / 5,000 | 741 / 5,000 |
สิ่งที่การตรวจสอบฐานข้อมูลบอกได้
การตรวจสอบเชิงตัวเลขกำหนดให้ total เป็นจำนวนเต็มบวกที่ปลอดภัย และจำนวน male และ female ต้องเป็นค่าจำกัดที่อยู่ระหว่าง 0 ถึง total การตรวจสอบอีกรายการหนึ่งเปรียบเทียบ male + female กับ total ตัวนับทั้งหมดในตัวอย่างผ่านการตรวจสอบนี้ นี่ไม่ใช่ข้อกล่าวอ้างว่าทุกแถวในคอลเลกชันสอดคล้องกัน หรือว่าการคาดการณ์ใดถูกต้อง
กรณีที่จำนวน male และ female เท่ากันมี 124 แถวในตัวอย่างของคอลเลกชันทั่วไป และ 94 แถวในตัวอย่างของคอลเลกชันตามประเทศ ข้อนี้หมายความเพียงว่าจำนวนที่จัดเก็บไว้เท่ากัน ไม่ใช่อัตลักษณ์ที่กำกวมซึ่งยืนยันอย่างเป็นอิสระ หรืออัตราผลลัพธ์ที่ไม่ทราบของ API ผลลัพธ์จริงของ API ขึ้นอยู่กับข้อมูลนำเข้า ความพร้อมใช้งานของ Redis การเลือกชื่อตัวเลือก และการตั้งค่า AI
การนับฟิลด์ country ของคอลเลกชันทั่วไปแยกต่างหากเมื่อ 2026-09-26T15:33:13.811Z พบค่าที่จัดเก็บไว้ที่แตกต่างกัน 244 ค่า ในจำนวนนี้ 239 ค่าอยู่ในรูปแบบตัวพิมพ์ใหญ่สองตัวอักษร และ 5 ค่าไม่ได้อยู่ในรูปแบบนั้น ไม่ได้วัดว่าค่าเหล่านี้เป็นรหัส ISO ที่ถูกต้องหรือไม่ การกระจายของแถวตามประเทศ หรือความครอบคลุมของประเทศที่รองรับ ตัวเลขนี้ไม่ใช่จำนวนประเทศที่รองรับ
ตัวอย่างทั้งสองชุดไม่มีฟิลด์แหล่งที่มาหรือสิทธิ์การใช้งาน แต่ไม่ได้หมายความว่าทุกแถวหรือระบบภายนอกไม่มีข้อมูลแหล่งที่มา updated_at มีอยู่เป็นฟิลด์ตัวเลขในบางแถว แต่ไม่ได้ตรวจสอบค่าและความหมายของฟิลด์นี้ จึงไม่ได้ยืนยันว่าข้อมูลเป็นปัจจุบันหรือมีกำหนดการอัปเดต
V2 ประมวลผลการค้นหาในชุดข้อมูลจาก Redis เมื่อวันที่ 26 กันยายน 2026 GenderAPI.io ในฐานะผู้ดูแลระบบยืนยันว่า MongoDB และ Redis มีชุดข้อมูลเดียวกัน การพิจารณาว่าฐานข้อมูลทั้งสองเหมือนกันอิงจากการยืนยันนี้ ยังไม่มีการเปรียบเทียบที่เป็นอิสระ และการตรวจสอบนั้นยังค้างอยู่ จำนวนข้างต้นอธิบายแถวที่จัดเก็บไว้ ความครอบคลุมของคำตอบจาก API ยังขึ้นอยู่กับข้อมูลนำเข้าที่ส่งมา การจับคู่ชื่อตัวเลือก และการตั้งค่า AI ตัวอย่างถูกอ่านโดยไม่มี seed ที่กำหนดไว้ ไม่มีสแนปช็อตที่ตรึงไว้ และไม่มีป้ายกำกับอ้างอิงที่เป็นอิสระ จึงวัดความแม่นยำของการคาดการณ์ การปรับเทียบ หรือความครอบคลุมของคำตอบไม่ได้
ติดตามหลักฐานในการตอบกลับ
| ฟิลด์ | ความหมาย | ข้อจำกัด |
|---|---|---|
input | ส่งคืนประเภทข้อมูลนำเข้า ค่า และบริบทประเทศที่ส่งมาตามเดิม | ค่าที่ส่งมาไม่ใช่ข้อมูลตัวตนที่ยืนยันอย่างเป็นอิสระ |
match.name / match.method | แสดงชื่อตัวเลือกที่ถูกเลือกสำหรับการค้นหา และแสดงว่าชื่อนั้นผ่านการทำให้เป็นมาตรฐาน แยกเป็นโทเค็น ดึงเป็นสตริงย่อย หรือโมเดลอนุมาน | การที่โทเค็นตรงกันไม่ได้รับประกันว่าแยกชื่อจริงออกจากชื่อเต็มหรือชื่อผู้ใช้ได้ถูกต้อง |
match.scope / match.country | แสดงว่าแถวที่จัดเก็บไว้ซึ่งถูกเลือกมาจากการค้นหาตามประเทศหรือการค้นหาส่วนกลาง | การส่งประเทศไม่ได้รับประกันว่ามีแถวตามประเทศ |
sample_count | จำนวนรวมที่จัดเก็บไว้ในแถวที่ถูกเลือก และเป็น null สำหรับการคาดการณ์ด้วย AI | ไม่จำเป็นต้องหมายถึงจำนวนบุคคลที่ไม่ซ้ำ การสังเกตที่สุ่มอย่างเป็นอิสระ หรือขนาดของการประเมินความแม่นยำ |
confidence / confidence_kind | แยกอัตราส่วนที่มาจากจำนวนที่จัดเก็บไว้ออกจากคะแนนที่โมเดลรายงาน | ไม่มีค่าใดเป็นความน่าจะเป็นที่ผ่านการตรวจสอบแล้วสำหรับอัตลักษณ์ทางเพศของบุคคล |
country / country_source | เมตาดาทาประเทศของแถวที่ส่งคืน หรือความเชื่อมโยงระหว่างชื่อกับประเทศที่ AI คาดการณ์ ส่งคืนเฉพาะเมื่อมี | ไม่ใช่สัญชาติ ถิ่นที่อยู่ หรือถิ่นกำเนิดที่ยืนยันแล้ว และไม่ใช่หลักฐานว่าประเทศที่ขอตรงกัน |
การจับคู่ข้อมูลนำเข้าส่งผลต่อผลลัพธ์อย่างไร
การค้นหาในชุดข้อมูลทำให้ข้อความเป็นมาตรฐานและสร้างโทเค็นตัวเลือก สำหรับที่อยู่อีเมล ระบบสร้างชื่อตัวเลือกจากส่วนหน้า @ และสำหรับชื่อผู้ใช้ ระบบตัดเครื่องหมาย @ นำหน้าที่ไม่บังคับออก การค้นหาอีเมลและชื่อผู้ใช้แบบปกติอาจลองใช้ชื่อตัวเลือกที่เป็นสตริงย่อยในขอบเขตความยาวที่จำกัดด้วย หากมีแถวตัวเลือกหลายแถว ระบบจะเลือกแถวที่มีจำนวนรวมที่จัดเก็บไว้มากที่สุด จึงอาจเลือกโทเค็นอื่นที่ไม่ใช่ชื่อที่ตั้งใจไว้
เมื่อมีการส่งบริบทประเทศ การค้นหาจะลองแถวตามประเทศของชื่อตัวเลือกแต่ละรายการ และใช้แถวส่วนกลางเมื่อไม่มีแถวตามประเทศ ผลลัพธ์สุดท้ายแสดงการจับคู่ที่ถูกเลือก แถวตามประเทศที่กำกวมจะไม่ถูกแทนที่ด้วยแถวส่วนกลางของชื่อตัวเลือกเดียวกันโดยอัตโนมัติ
พรอมต์ AI แบบปกติต้องการชื่อที่จดจำได้ forceToGenderize อนุญาตความเชื่อมโยงผ่านชื่อเล่นหรือนามแฝงของบุคคลด้วย ในโหมดนี้การส่งคืนเพศที่ไม่เป็น null พร้อม name: null จึงถือว่าถูกต้อง ทั้งสองเป็นงานคาดการณ์คนละแบบและต้องประเมินแยกกัน
การค้นหาในชุดข้อมูลและการประมวลผลด้วย AI
เมื่อใช้ AI ระบบ V2 จะส่ง type, value และบริบทประเทศที่ส่งมาไปยังบริการที่กำหนดค่าไว้สำหรับการคาดการณ์ด้วย AI สำหรับข้อมูลนำเข้าที่เป็นที่อยู่อีเมล พรอมต์จะสั่งให้โมเดลละเว้นโดเมนและส่วนต่อท้ายหลังเครื่องหมายบวก ข้อนี้ไม่ได้เป็นการสัญญาว่าอักขระเหล่านั้นจะถูกลบออกจากค่าก่อนที่ AI จะประมวลผล หากขั้นตอนงานของคุณต้องการการคาดการณ์จากชุดข้อมูลเท่านั้น ให้ใช้ ai_mode: off โดยไม่ใช้ forceToGenderize
การตรวจสอบการตอบกลับจาก AI ตรวจสอบฟิลด์ JSON ชนิดข้อมูล และความสอดคล้องระหว่างฟิลด์ แต่ไม่ได้พิสูจน์ว่าชื่อ ความเชื่อมโยงกับเพศ และความเชื่อมโยงกับประเทศที่ส่งคืนตรงกับข้อเท็จจริง ผลลัพธ์สาธารณะไม่มีตัวระบุโมเดล เวอร์ชันของโมเดล หรือการอ้างอิงหลักฐานของการคาดการณ์
| ตัวเลือก | เส้นทางการคาดการณ์ | หลักฐานที่ส่งคืน |
|---|---|---|
| ai_mode: off | ใช้เฉพาะการค้นหาในชุดข้อมูล | เมตาดาทาของชุดข้อมูลที่ถูกเลือก หรือผลลัพธ์ที่ไม่ทราบซึ่งไม่มีแถวที่ถูกเลือก |
| ai_mode: fallback | ลองชุดข้อมูลก่อน และใช้ AI เมื่อไม่ได้ผลเป็นเพศ | หลักฐานของเส้นทางสุดท้าย ไม่ใช่ตัวอย่างที่รวมชุดข้อมูลกับ AI |
| ai_mode: always | ใช้เส้นทางการคาดการณ์ด้วย AI ที่กำหนดค่าไว้โดยตรง | คะแนนที่โมเดลรายงาน หรือผลลัพธ์ที่ไม่ทราบซึ่ง confidence เป็น null และ sample_count เป็น null เสมอ |
| forceToGenderize: true | ลองชุดข้อมูลก่อน หากไม่ได้ผลจะใช้ AI ที่ตีความชื่อเล่นได้ | หลักฐานจากชุดข้อมูล หรือความเชื่อมโยงของนามแฝงที่โมเดลรายงาน และ name อาจเป็น null |
เอกสารแหล่งที่มาที่ยังไม่ได้เผยแพร่
ไม่มีแคตตาล็อกแหล่งข้อมูลที่ผ่านการตรวจทานเผยแพร่ไว้ที่นี่ ข้อกำหนดการตอบกลับและการทำงานของระบบเพียงอย่างเดียวไม่สามารถยืนยันแหล่งที่มาของข้อมูล สิทธิ์ในการใช้แหล่งที่มา ความเป็นตัวแทน หรือคุณภาพของป้ายกำกับได้ ก่อนกล่าวอ้างเกี่ยวกับแหล่งที่มาใดโดยเฉพาะ ต้องบันทึกและตรวจทานหลักฐานต่อไปนี้ก่อน
การตรวจทานเอกสารนี้ไม่ได้ยืนยันไม่ว่าทางใดว่าแหล่งข้อมูลต้นทางได้รับอนุญาตใช้สิทธิ์หรือมีความครบถ้วน เพียงอธิบายข้อจำกัดของหลักฐานที่เปิดเผย หากการใช้งานของคุณต้องการการประเมินแหล่งที่มาใดโดยเฉพาะ โปรดติดต่อ GenderAPI.io
| หลักฐาน | บันทึกที่ต้องมี | สถานะการเปิดเผย |
|---|---|---|
| แหล่งที่มาและสิทธิ์การใช้ | ชื่อแหล่งที่มาหรือผู้เผยแพร่ ช่วงเวลาที่รวบรวม สิทธิ์การใช้งาน หรือเหตุผลการใช้ที่บันทึกไว้อื่นๆ | ไม่มีแคตตาล็อกที่ผ่านการตรวจทานเผยแพร่ไว้ที่นี่ |
| ประวัติการประมวลผล | การแปลง การทำให้เป็นมาตรฐาน การขจัดข้อมูลซ้ำ การรวมยอด และการมีส่วนของข้อมูลสังเคราะห์หรือข้อมูลที่โมเดลสร้างขึ้น | ป้ายกำกับ source: dataset ไม่ได้แสดงข้อมูลนี้ |
| ความครอบคลุมของประชากร | ความครอบคลุมของประเทศและระบบการเขียน กระบวนการคัดเลือก นิยามของป้ายกำกับ และอคติที่บันทึกไว้ | ไม่มีตัวเลขความครอบคลุมที่ประเมินอย่างเป็นอิสระเผยแพร่ไว้ที่นี่ |
| ความเป็นปัจจุบัน | ตัวระบุสแนปช็อต วันที่อัปเดตของแต่ละแหล่งที่มา และกำหนดการอัปเดตที่รองรับ | การตอบกลับ V2 ไม่มีข้อมูลความเป็นปัจจุบันของแต่ละแถวหรือตัวระบุสแนปช็อต |
| คุณภาพและการแก้ไข | ผลการตรวจสอบ การตรวจสอบข้อมูลซ้ำ การจัดการการแก้ไขและการลบ และผู้รับผิดชอบการตรวจทาน | ไม่มีผลการตรวจสอบของแต่ละแหล่งที่มาเผยแพร่ไว้ที่นี่ |
ความเป็นส่วนตัว การประมวลผล และการใช้งานอย่างรับผิดชอบ
ประวัติแหล่งที่มา การประมวลผลข้อมูลส่วนบุคคล และเงื่อนไขทางกฎหมายเป็นคนละเรื่องกัน ตรวจสอบบทบาทในการประมวลผล ระยะเวลาการเก็บรักษา ผู้ให้บริการ และเงื่อนไขสัญญาในนโยบายที่เผยแพร่อยู่ในปัจจุบัน คู่มือทางเทคนิคนี้ไม่ได้เพิ่มคำมั่นเรื่องการเก็บรักษาใหม่ และไม่ได้รับรองการปฏิบัติตามกฎหมาย
ส่งเฉพาะข้อมูลที่ขั้นตอนงานของคุณต้องใช้ คงชนิดของค่าความเชื่อมั่นและผลลัพธ์ที่ไม่ทราบไว้ และอย่าอธิบายการคาดการณ์ราวกับเป็นอัตลักษณ์ที่บุคคลระบุด้วยตนเอง อย่าใช้เพศที่คาดการณ์เป็นพื้นฐานของการตัดสินใจที่มีผลกระทบสำคัญต่อบุคคล
หลักฐานความแม่นยำและประวัติการเปลี่ยนแปลง
ป้ายกำกับแหล่งที่มาอธิบายเพียงเส้นทางการคาดการณ์ ไม่ได้อธิบายคุณภาพที่วัดได้ ดูคู่มือความแม่นยำเพื่อแยกคะแนนในการตอบกลับ ความครอบคลุมของคำตอบ ข้อผิดพลาด และข้อมูลที่การประเมินที่ทำซ้ำได้ต้องมี
| วันที่ | เวอร์ชันเอกสาร | การเปลี่ยนแปลง |
|---|---|---|
| 2026-09-30 | 1.0.0 | ฉบับภาษาไทยที่ครอบคลุมจำนวนจาก MongoDB ที่ระบุวันที่ การตรวจสอบความสอดคล้องของตัวอย่างในขอบเขตจำกัด ฟิลด์ source และ match ของ V2 ขอบเขตของการประมวลผลด้วย AI และช่องว่างที่ยังเหลือในแคตตาล็อกแหล่งที่มา การพิจารณาว่า MongoDB และ Redis เหมือนกันอิงจากการยืนยันของ GenderAPI.io เมื่อวันที่ 26 กันยายน 2026 และการเปรียบเทียบที่เป็นอิสระยังค้างอยู่ ไม่ได้เพิ่มข้อกล่าวอ้างใหม่เรื่องค่าร้อยละของความแม่นยำหรือสิทธิ์การใช้งานของแหล่งที่มา |