สัญญาณชื่อกับความหมายของชื่อเล่นไม่เหมือนกัน
ใช้ type: username สำหรับชื่อบัญชีหรือชื่อเล่น เครื่องหมาย @ นำหน้าเป็นส่วนที่ไม่บังคับและจะถูกตัดออกเมื่อจับคู่กับชุดข้อมูล การดึงชื่อตัวเลือกจัดการตัวคั่นและตัวเลข และอาจลองใช้สตริงย่อยในขอบเขตที่จำกัด โหมดชื่อเล่นยังจับคู่โทเค็นอยู่ แต่จะไม่เพิ่มชื่อตัวเลือกจากสตริงย่อยเหล่านั้น เรคคอร์ดที่ถูกเลือกคือเรคคอร์ดที่มีจำนวนรวมมากที่สุดในบรรดาชื่อตัวเลือกที่มีอยู่ และไม่ได้พิสูจน์ชื่อจริงของเจ้าของบัญชี
AI สำรองแบบปกติจะค้นหาชื่อจริงที่จดจำได้ ส่วน forceToGenderize อนุญาตให้คาดการณ์ความเชื่อมโยงจากชื่อเล่นส่วนบุคคลได้ด้วยเมื่อดึงชื่อจริงออกมาไม่ได้ ทั้งสองแนวทางอาจส่งคืน unknown และแบรนด์ ตัวละคร หรือบัญชีที่ใช้ร่วมกันอาจไม่ได้แทนบุคคลเพียงคนเดียว
| ตัวอย่างข้อมูลนำเข้า | แนวทาง | สิ่งที่ต้องตรวจสอบ |
|---|---|---|
@alice.smith | เริ่มด้วย fallback แบบปกติที่ค้นหาในชุดข้อมูลก่อน | ตรวจสอบชื่อที่ถูกเลือกและวิธีจับคู่ อย่าถือว่าโทเค็นแรกถูกเลือก |
robert89 | ตัวเลขอาจถูกตัดออกระหว่างการดึงชื่อตัวเลือก | ชื่อที่ตรงกันเป็นเพียงความเชื่อมโยง ไม่ใช่ตัวตนที่ได้รับการยืนยัน |
prenses | เปิด forceToGenderize เพื่ออนุญาตให้ AI ลองคาดการณ์จากชื่อเล่นเมื่อระบุเพศไม่ได้ | gender อาจไม่เป็น null แม้ name จะเป็น null และคะแนนของ AI เป็น model_reported |
team_support | ถือว่าบัญชีตามบทบาทหรือบัญชีที่ใช้ร่วมกันอาจไม่ใช่บัญชีส่วนบุคคล | คง unknown ไว้ และอย่ากำหนดตัวตนของบุคคลให้กับบัญชีที่ใช้ร่วมกัน |
ลองใช้การคาดการณ์จากชื่อเล่นในการเชื่อมต่อของคุณ
คำขอนี้เลือกใช้การคาดการณ์จากชื่อเล่น ระบบจะตรวจสอบชุดข้อมูลก่อน หากไม่ได้ผลเป็นเพศ AI จะใช้ความหมายของนามแฝงได้ ให้ละ forceToGenderize สำหรับการค้นหาแบบปกติ ซึ่งคำขอเดี่ยวยังคงใช้ fallback แบบปกติเป็นค่าเริ่มต้น
ตัวอย่างนี้ระบุบริบทประเทศ TR ให้ใช้บริบทที่เกี่ยวข้องจากแอปพลิเคชันของคุณ และตรวจสอบ data.match.scope ประเทศที่ส่งมาไม่ได้รับประกันว่าจะได้เรคคอร์ดตามประเทศ และไม่ได้บ่งบอกสัญชาติหรือถิ่นที่อยู่
เลือกภาษาโปรแกรม ตั้งค่าคีย์ API จากนั้นรันตัวอย่างบนเซิร์ฟเวอร์ของคุณ
คำขอคาดการณ์ทุกครั้งเป็นงานใหม่ที่มีการหักเครดิต รวมถึงคำขอที่ส่งซ้ำ ตัวอย่างเหล่านี้ไม่ส่งคำขอซ้ำโดยอัตโนมัติ ตรวจสอบสถานะการหักเครดิตก่อนส่งคำขออีกครั้ง
ก่อนรัน: การเข้าถึงและการจัดการข้อผิดพลาด
รันตัวอย่างเหล่านี้บนเซิร์ฟเวอร์ของคุณ ตั้งค่า GENDERAPI_API_KEY ในสภาพแวดล้อมของโปรเซสเป็นคีย์ API ที่มีอยู่ ตรวจสอบว่า meta.access.mode เป็น api_key เพราะคีย์ที่ระบบไม่รู้จักอาจทำให้ใช้การทดลองใช้ตาม IP แทน
การตอบกลับ JSON ที่มี HTTP 4xx และ 5xx จะคงเนื้อหาข้อผิดพลาดไว้และจบด้วยสถานะการออกที่ไม่ใช่ศูนย์ ตรวจสอบ code, action และ meta.usage.billing_status ก่อนส่งคำขอซ้ำ
คู่มือข้อผิดพลาดและการส่งคำขอซ้ำ →cURL 7.76+ ในเชลล์ POSIX รันในเทอร์มินัล เอกสารของรันไทม์
Node.js 22+ พร้อม fetch ในตัว บันทึกเป็น example.mjs แล้วรัน node example.mjs เอกสารของรันไทม์
Python 3.10+ พร้อมไลบรารีมาตรฐาน บันทึกเป็น example.py แล้วรัน python3 example.py เอกสารของรันไทม์
PHP 8+ พร้อมส่วนขยาย cURL บันทึกเป็น example.php แล้วรัน php example.php เอกสารของรันไทม์
Java 17+ พร้อมไคลเอนต์ HTTP มาตรฐาน บันทึกเป็น GenderApiExample.java แล้วรัน java GenderApiExample.java เอกสารของรันไทม์
แอปพลิเคชันคอนโซล .NET 8+ ใช้เป็น Program.cs ในโปรเจกต์คอนโซล แล้วรัน dotnet run เอกสารของรันไทม์
Go 1.22+ พร้อมไลบรารีมาตรฐาน บันทึกเป็น main.go แล้วรัน go run main.go เอกสารของรันไทม์
เก็บผลลัพธ์ไว้คู่กับหลักฐาน
ความเชื่อมโยงที่ได้จากการคาดการณ์ไม่ใช่เพศที่บุคคลระบุด้วยตนเอง เก็บข้อมูลนำเข้าต้นฉบับ หลักฐานที่ส่งคืน และข้อมูลที่บุคคลนั้นให้ไว้แยกจากกัน ผลลัพธ์ที่ไม่ทราบเป็นผลลัพธ์ที่ถูกต้อง จึงไม่ควรเปลี่ยนเป็นหมวดหมู่ที่เดาขึ้นในแอปพลิเคชันของคุณ
| ฟิลด์ | วิธีใช้ |
|---|---|
data.gender / data.result_status | ใช้ male หรือ female เฉพาะเมื่อเป็น identified เมื่อผลลัพธ์เป็น unknown ให้คงค่า JSON null ดั้งเดิมไว้ |
data.name / data.match | ตรวจสอบชื่อที่ส่งคืนและชื่อตัวเลือกที่ถูกเลือก การจับคู่บางส่วนของสตริงไม่ได้พิสูจน์ว่าข้อมูลนำเข้าเป็นของบุคคลที่มีชื่อจริงนั้น |
data.confidence / data.confidence_kind | ค่าความเชื่อมั่นอยู่บนสเกล 0–1 หรือเป็น null ค่า observed_frequency มาจากจำนวนที่จัดเก็บไว้ ส่วน model_reported เป็นคะแนนจาก AI ให้ประเมินเกณฑ์แยกตามแต่ละชนิด |
data.source / data.sample_count | แยก dataset, ai และ none ออกจากกัน ผลลัพธ์จาก AI ไม่มีจำนวนตัวอย่างที่จัดเก็บไว้ และจำนวนตัวอย่างไม่ใช่คะแนนความแม่นยำที่วัดได้ |
meta.access.mode | สำหรับการเชื่อมต่อด้วยบัญชี ให้ตรวจสอบว่าเป็น api_key หากไม่มีคีย์หรือระบบไม่รู้จักคีย์ อาจใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกันแทน |
meta.usage | อ่าน charged_credits และ billing_status ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จจะถูกหักเครดิต การไม่ได้รับการตอบกลับไม่ได้แปลว่าคำขอนั้นไม่มีค่าใช้จ่าย |
เลือกว่าจะใช้ AI เมื่อใด
forceToGenderize เป็นตัวเลือกที่ไม่บังคับสำหรับชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ เมื่อเปิดใช้ ให้ละ ai_mode หรือใช้ fallback เพราะ off และ always ขัดแย้งกับตัวเลือกนี้และจะส่งคืน 422 ยอดคงเหลือเริ่มต้นที่เป็นบวกก็เพียงพอสำหรับเริ่มคำขอ แม้การหักเครดิตครั้งสุดท้ายจะทำให้ยอดคงเหลือต่ำกว่าศูนย์
โหมดชื่อเล่นอาจส่งคืนเพศพร้อม name: null และอาจส่งคืนผลลัพธ์ที่ไม่ทราบได้เช่นกัน ทั้ง AI สำรองแบบปกติและการคาดการณ์จากชื่อเล่นไม่รับประกันคำตอบที่ถูกต้องหรือไม่เป็น null
| ตัวเลือกของคำขอ | การทำงาน | เครดิตสำหรับการค้นหาที่สำเร็จ |
|---|---|---|
| options.ai_mode: off | ใช้เฉพาะชุดข้อมูล | 1 รวมถึงผลลัพธ์ที่ไม่ทราบ |
| options.ai_mode: fallback | ค้นหาในชุดข้อมูลก่อน แล้วใช้ AI แบบปกติเมื่อไม่ได้ผลเป็นเพศ เป็นค่าเริ่มต้นของคำขอเดี่ยว | รวม 1 รวมถึง AI สำรอง |
| options.ai_mode: always | ใช้ AI โดยตรง | 2 |
| forceToGenderize: true | ค้นหาในชุดข้อมูลก่อน แล้วให้ AI ตีความชื่อเล่นหรือนามแฝงของบุคคลได้แม้ไม่มีชื่อจริง | 1 เมื่อชุดข้อมูลระบุเพศได้ หรือรวม 2 หากใช้ AI |
เก็บผลลัพธ์ของชื่อบัญชีแต่ละรายการเมื่อประมวลผลเป็นรายการ
ใช้ POST /api/v2/gender/batch สำหรับรายการชื่อผู้ใช้ หรือรายการที่ผสมชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ จำนวนสูงสุดคือ 50 รายการเมื่อใช้คีย์ API หรือ 10 รายการในการทดลองใช้ตาม IP แต่ละรายการมีประเทศและตัวเลือก AI ของตัวเอง และ id ที่ไม่บังคับต้องไม่ซ้ำกันภายในคำขอแบบกลุ่ม
ค่าเริ่มต้นของคำขอแบบกลุ่มคือเฉพาะชุดข้อมูล เปิด fallback ทีละรายการเมื่อต้องการ AI แบบปกติ หรือกำหนด forceToGenderize ทีละรายการสำหรับการคาดการณ์จากชื่อเล่น ตรวจสอบ data หรือ error ของทุกผลลัพธ์ และใช้ id หรือ index เพื่อจับคู่กับแถวต้นฉบับ รายการที่ไม่ทราบผลซึ่งดำเนินการสำเร็จจะถูกหักเครดิต
ทำความเข้าใจข้อมูลที่คุณส่ง
เดโมบนหน้านี้จะส่งค่าที่กรอกไปยัง GenderAPI.io เฉพาะเมื่อคุณกดส่งเท่านั้น หากมีการใช้ AI ระบบจะส่ง type, value และบริบทประเทศที่ส่งมาไปยังบริการคาดการณ์ที่กำหนดค่าไว้ หากต้องการคาดการณ์จากชุดข้อมูลเท่านั้น ให้ใช้ options.ai_mode: off โดยไม่ใช้ forceToGenderize ในการเชื่อมต่อของคุณ
นโยบายความเป็นส่วนตัว ข้อตกลงการประมวลผลข้อมูล และรายชื่อผู้ประมวลผลข้อมูลช่วงอธิบายเงื่อนไขการจัดการข้อมูลที่เผยแพร่ไว้ ผลลัพธ์เป็นความเชื่อมโยงที่ได้จากการคาดการณ์ ให้ข้อมูลที่บุคคลนั้นให้ไว้มีความสำคัญกว่า และอย่าใช้ผลลัพธ์เป็นพื้นฐานของการตัดสินใจที่มีผลกระทบสำคัญต่อบุคคล
คำถามที่พบบ่อย
ชื่อผู้ใช้ต้องมีชื่อจริงหรือไม่?
การคาดการณ์ด้วย AI แบบปกติต้องมีชื่อจริงที่ใช้ได้ หากใช้ forceToGenderize API จะลองหาความเชื่อมโยงจากชื่อเล่นได้ด้วยเมื่อการค้นหาในชุดข้อมูลระบุเพศไม่ได้ โหมดนี้ไม่ต้องมีชื่อจริงและอาจส่งคืน name: null
forceToGenderize รับประกันว่าจะได้เพศหรือไม่?
ไม่ ตัวเลือกนี้อนุญาตให้คาดการณ์จากชื่อเล่น แต่ผลลัพธ์สุดท้ายยังอาจเป็นผลลัพธ์ที่ไม่ทราบ คงค่า JSON null ดั้งเดิมไว้ และตรวจสอบ result_status และ reason
API ตรวจสอบโปรไฟล์โซเชียลมีเดียหรือไม่?
endpoint นี้วิเคราะห์ค่าที่ส่งมาเท่านั้น และไม่ได้ดึงโปรไฟล์ โพสต์ หรือรูปภาพของบัญชีเพื่อยืนยันว่าใครเป็นเจ้าของ
ใช้ forceToGenderize กับชื่อหรืออีเมลได้ด้วยหรือไม่?
ได้ ตัวเลือกนี้ใช้ได้ตามต้องการกับข้อมูลนำเข้าประเภท name, email และ username ระบบจะใช้ชุดข้อมูลก่อน แล้วใช้ AI ที่ตีความชื่อเล่นหากยังระบุเพศไม่ได้ โดยใช้ 1 เครดิตเมื่อชุดข้อมูลระบุเพศได้ หรือรวม 2 เครดิตเมื่อใช้ AI