# คำถามที่พบบ่อย

> คำตอบเกี่ยวกับคำขอ V2 ค่าความเชื่อมั่น ผลลัพธ์ที่ไม่ทราบ เครดิต ความเป็นส่วนตัว และบัญชี หากคุณดูแลการเชื่อมต่อที่สร้างด้วยเวอร์ชันก่อนหน้า ให้ดูเอกสาร V1

Canonical HTML: https://www.genderapi.io/th/frequently-asked-questions

Last reviewed: 2026-09-30

## ภาพรวม

คำตอบเกี่ยวกับคำขอ V2 ค่าความเชื่อมั่น ผลลัพธ์ที่ไม่ทราบ เครดิต ความเป็นส่วนตัว และบัญชี หากคุณดูแลการเชื่อมต่อที่สร้างด้วยเวอร์ชันก่อนหน้า ให้ดูเอกสาร V1

## ทำความเข้าใจผลการคาดการณ์และข้อจำกัด

บริบทประเทศ ค่าความเชื่อมั่น และผลลัพธ์ที่ไม่ทราบใน API V2

### ผลลัพธ์จาก GenderAPI ยืนยันเพศของบุคคลหรือไม่?

ไม่ GenderAPI คาดการณ์เพศจากสัญญาณที่เกี่ยวกับชื่อ หรือจากสัญญาณของชื่อเล่นเมื่อเปิดตัวเลือกนั้น ผลการคาดการณ์ไม่ใช่ข้อเท็จจริงส่วนบุคคลที่ผ่านการยืนยัน ควรเก็บความไม่แน่นอนไว้ เคารพอัตลักษณ์ที่บุคคลระบุด้วยตนเอง และอย่าใช้การคาดการณ์นี้เพียงอย่างเดียวในการตัดสินใจที่มีผลกระทบสูง

### บริบทประเทศมีผลต่อผลลัพธ์อย่างไร?

รหัสประเทศ ISO ตัวพิมพ์ใหญ่ที่ส่งเพิ่มได้ตามต้องการจะให้บริบทของภูมิภาคแก่คำขอ ส่งเฉพาะเมื่อประเทศเกี่ยวข้องและทราบแน่ชัด ชื่อเดียวกันอาจใช้ต่างกันในแต่ละภูมิภาค ประเทศที่ส่งคืนแสดงความเชื่อมโยงกับชื่อเท่านั้น ไม่ใช่หลักฐานของสัญชาติหรือถิ่นที่อยู่

[ประเทศและพารามิเตอร์ของคำขอ →](https://www.genderapi.io/th/docs/v2/request-parameters)

### ค่าความเชื่อมั่นใน V2 หมายถึงอะไร?

confidence เป็นค่าตั้งแต่ 0 ถึง 1 หรือเป็น null เมื่อไม่มีค่า ให้อ่านคู่กับ confidence_kind โดย observed_frequency คือจำนวนของกลุ่มที่พบมากที่สุดในชุดข้อมูลหารด้วยจำนวนทั้งหมด ส่วน model_reported คือคะแนนที่ AI รายงาน ค่าเหล่านี้ไม่ใช่ความน่าจะเป็นที่ปรับเทียบแล้วเกี่ยวกับบุคคล และไม่ใช่ความแม่นยำของผลิตภัณฑ์ที่วัดได้ ควรกำหนดเกณฑ์การตรวจสอบด้วยข้อมูลที่เป็นตัวแทน

[ฟิลด์ในผลลัพธ์และหลักฐาน →](https://www.genderapi.io/th/docs/v2/responses)

### gender: null หมายถึงอะไร และถูกหักเครดิตหรือไม่?

ผลลัพธ์ V2 ที่ดำเนินการสำเร็จและมี gender: null หมายความว่าสัญญาณที่มีอยู่ไม่เพียงพอที่จะระบุเพศ ค่านี้เป็นค่า null ดั้งเดิมของ JSON ไม่ใช่สตริง "null" ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จจะถูกหักเครดิตตามอัตราของโหมดที่เลือก ให้เก็บไว้เป็นผลลัพธ์ที่ไม่ทราบ ส่วนความล้มเหลวของผู้ให้บริการหรือคำขอเป็นข้อผิดพลาดแยกต่างหาก

[ผลลัพธ์ที่ไม่ทราบ →](https://www.genderapi.io/th/docs/v2/responses)[หลักการหักเครดิต →](https://www.genderapi.io/th/docs/v2/credits-and-usage)

### ส่งชื่อในระบบอักษรต่าง ๆ ได้หรือไม่?

ได้ ส่งชื่อเป็น Unicode โดยคงตัวอักษรเดิมและเครื่องหมายกำกับเสียงที่มีความหมายไว้ ชื่อภาษาไทยส่งเป็นอักษรไทยได้โดยตรง ความครอบคลุมและค่าความเชื่อมั่นขึ้นอยู่กับชื่อ ภูมิภาค และสัญญาณที่มี จึงควรทดสอบด้วยตัวอย่างที่เป็นตัวแทนของระบบอักษรและประเทศที่แอปพลิเคชันของคุณรองรับ

[ตัวอย่างคำขอสำหรับชื่อ →](https://www.genderapi.io/th/docs/v2/gender-from-name)

## เลือกประเภทคำขอและตัวเลือก AI

ประเภทคำขอ V2 คำขอแบบกลุ่ม การทำงานของ AI และขีดจำกัดการใช้งาน

### วิเคราะห์ชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ในคำขอแบบกลุ่มเดียวได้หรือไม่?

ได้ POST /api/v2/gender/batch รับได้สูงสุด 50 รายการเมื่อใช้คีย์ API และสูงสุด 10 รายการเมื่อใช้การทดลองใช้ตาม IP แต่ละรายการกำหนด type, value, country (ไม่บังคับ) และการตั้งค่า AI ของตัวเองได้ รายการในคำขอแบบกลุ่มปิด AI ไว้ตามค่าเริ่มต้น ควรตรวจสอบผลลัพธ์ทีละรายการ เพราะคำขอแบบกลุ่มอาจส่งคืน HTTP 200 แม้บางรายการล้มเหลว เครดิตจะถูกหักตามรายการที่ดำเนินการสำเร็จ รวมถึงผลลัพธ์ที่ไม่ทราบ

[คำขอแบบกลุ่มและความล้มเหลวบางส่วน →](https://www.genderapi.io/th/docs/v2/batch)

### คำขอด้วยที่อยู่อีเมลทำงานอย่างไร?

ใช้ type: email กับที่อยู่ที่ถูกต้อง API จะค้นหาสัญญาณชื่อที่ใช้ได้ในส่วนหน้าเครื่องหมาย @ โดเมนไม่ได้บ่งบอกตัวตนหรือประเทศของบุคคล กล่องจดหมายที่ใช้ร่วมกันหรือที่อยู่ที่ไม่มีสัญญาณชื่ออาจได้ผลลัพธ์ที่ไม่ทราบ คำขอเดี่ยวจะใช้ AI สำรองตามค่าเริ่มต้นเมื่อชุดข้อมูลระบุเพศไม่ได้

[ตัวอย่างคำขอสำหรับที่อยู่อีเมล →](https://www.genderapi.io/th/docs/v2/gender-from-email)

### คำขอด้วยชื่อผู้ใช้ทำงานอย่างไร?

ใช้ type: username การค้นหาปกติจะหาชื่อที่จดจำได้ในชื่อผู้ใช้หรือชื่อที่แสดง นามแฝงที่เป็นนามธรรมอาจได้ผลลัพธ์ที่ไม่ทราบ หากต้องการให้ AI ที่ตีความชื่อเล่นทำงานหลังจากชุดข้อมูลระบุเพศไม่ได้ ให้เปิด forceToGenderize ซึ่งอาจได้ผลเป็นเพศแม้จะดึงชื่อจริงออกมาไม่ได้

[ตัวอย่างชื่อผู้ใช้และชื่อเล่น →](https://www.genderapi.io/th/docs/v2/gender-from-username)

### V2 ใช้ AI เมื่อใด?

คำขอเดี่ยวใช้ options.ai_mode: fallback เป็นค่าเริ่มต้น ระบบจะค้นหาในชุดข้อมูลก่อน แล้วใช้ AI หากยังระบุเพศไม่ได้ โดยรวมเป็น 1 เครดิต off ใช้เฉพาะชุดข้อมูลในราคา 1 เครดิต ส่วน always ข้ามชุดข้อมูลและใช้ AI ในราคา 2 เครดิต รายการในคำขอแบบกลุ่มใช้ off เป็นค่าเริ่มต้นและเปิด AI ได้ทีละรายการ ไม่มีโหมดใดรับประกันว่าผลลัพธ์จะไม่เป็น null

[ตัวเลือก AI และค่าใช้จ่าย →](https://www.genderapi.io/th/docs/v2/ai-options)

### forceToGenderize ทำอะไร?

แฟล็กที่ใช้ได้ตามต้องการนี้ทำงานกับข้อมูลนำเข้าประเภทชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ รวมถึงรายการแต่ละรายการในคำขอแบบกลุ่ม ผลที่ชุดข้อมูลระบุเพศได้ใช้ 1 เครดิต หากระบุไม่ได้ ระบบจะใช้ AI ที่ตีความชื่อเล่นและรวมเป็น 2 เครดิต แม้ผลลัพธ์ที่ดำเนินการสำเร็จจะยังเป็นผลลัพธ์ที่ไม่ทราบก็ตาม ไม่จำเป็นต้องมีชื่อจริง ให้ละ ai_mode หรือใช้ fallback หากใช้แฟล็กนี้ร่วมกับ off หรือ always ระบบจะส่งคืน 422

[การคาดการณ์จากชื่อเล่น →](https://www.genderapi.io/th/docs/v2/ai-options)

### V2 หักเครดิตอย่างไร?

ดูเครดิตที่ถูกหักจริงของงานได้ที่ meta.usage.charged_credits และดูว่าการหักเครดิตได้รับการยืนยันแล้วหรือไม่ที่ billing_status การคาดการณ์ปกติจากชุดข้อมูลและการคาดการณ์ในโหมด fallback ใช้ 1 เครดิตต่อรายการที่สำเร็จ ส่วน always และ AI ที่ตีความชื่อเล่นใช้ 2 เครดิต การตรวจสอบหมายเลขโทรศัพท์ที่เสร็จสมบูรณ์ใช้ 1 เครดิตแม้ผลจะไม่ถูกต้อง ยอดคงเหลือเริ่มต้นที่เป็นบวกก็เพียงพอ ยอดคงเหลือจึงอาจติดลบหลังการหักเครดิตครั้งสุดท้าย การคาดการณ์ที่ล้มเหลวจะได้รับเครดิตคืน และการหักเครดิตที่ยังไม่ยืนยันต้องให้ทีมช่วยเหลือตรวจสอบ

[เครดิตและการใช้งาน →](https://www.genderapi.io/th/docs/v2/credits-and-usage)[ดูแพ็กเกจและราคา →](https://www.genderapi.io/th/price)

### V2 มีขีดจำกัดคำขอหรือไม่?

มี ค่าเริ่มต้นปัจจุบันคือ 120 คำขอต่อนาทีต่อบัญชี 600 คำขอต่อนาทีต่อ IP และงานพร้อมกัน 2 งานต่อบัญชี ความจุที่ใช้ร่วมกันของบริการก็มีผลด้วย เนื้อหาคำขอ POST จำกัดที่ 64 KiB และคำขอแบบกลุ่มรับได้ 50 รายการเมื่อใช้คีย์ หรือ 10 รายการเมื่อใช้การทดลองใช้ตาม IP อย่าคาดว่าคำขอที่อยู่ในขีดจำกัดเหล่านี้จะได้รับการยอมรับเสมอ ให้รองรับ HTTP 429 และ Retry-After

[ขีดจำกัดและการส่งคำขอซ้ำ →](https://www.genderapi.io/th/docs/v2/errors-and-retries)

### ส่งคำขอที่ล้มเหลวหรือหมดเวลาซ้ำได้หรือไม่?

คำขอคาดการณ์ทุกครั้งเป็นงานใหม่และคิดค่าใช้จ่ายตามปกติ การหมดเวลาหรือผลลัพธ์ที่สูญหายไม่ได้พิสูจน์ว่าไม่มีการหักเครดิต ให้ตรวจสอบ billing_status ก่อนส่งซ้ำ หากการหักเครดิตยังไม่ได้รับการยืนยัน ให้ติดต่อทีมช่วยเหลือพร้อม request_id สำหรับคำขอแบบกลุ่มที่ล้มเหลวบางส่วน ให้ส่งซ้ำเฉพาะรายการที่ล้มเหลวหลังจากยืนยันการหักเครดิตแล้ว สำหรับผลลัพธ์ 429 ให้ปฏิบัติตาม Retry-After

[ข้อผิดพลาดและการส่งคำขอซ้ำอย่างปลอดภัย →](https://www.genderapi.io/th/docs/v2/errors-and-retries)

### ตัวอย่างโค้ดและเครื่องมือของ V2 อยู่ที่ไหน?

คู่มือ V2 มีตัวอย่างใน cURL, JavaScript, Python, PHP, Java, C# และ Go ส่วน Swagger และ Postman ใช้สัญญา V2 เดียวกัน เลือกประเภทข้อมูลนำเข้า และเก็บคีย์ API ไว้ในการตั้งค่าฝั่งเซิร์ฟเวอร์

[เอกสาร V2 →](https://www.genderapi.io/th/api-documentation)[V2 Swagger →](https://www.genderapi.io/swagger/v2/)

### ยังใช้ V1 ต่อได้หรือไม่?

ได้ การเชื่อมต่อ V1 ที่มีอยู่ยังคงใช้ endpoint และรูปแบบผลลัพธ์เดิม V1 และ V2 ใช้คีย์ API และยอดคงเหลือเดียวกัน แต่ฟิลด์ของคำขอ ผลลัพธ์ และข้อผิดพลาดแตกต่างกัน ใช้เอกสาร V1 แยกต่างหากเพื่อดูแลไคลเอนต์เดิม และใช้คู่มือการย้ายระบบเมื่อพร้อมเปลี่ยนไปใช้ V2

[เอกสาร V1 →](https://www.genderapi.io/th/api-documentation/v1)[ย้ายจาก V1 ไป V2 →](https://www.genderapi.io/th/docs/v2/migration)

## ทำความเข้าใจการจัดการข้อมูล

แหล่งข้อมูลล่าสุดเกี่ยวกับการประมวลผล การเก็บรักษา และการลบข้อมูล

### GenderAPI จัดเก็บคำขอที่ดำเนินการสำเร็จหรือไม่?

นโยบายความเป็นส่วนตัวอธิบายว่าข้อมูลคำขอ บันทึกการดำเนินงาน และบันทึกด้านความปลอดภัยใดบ้างที่อาจถูกเก็บรักษา ประมวลผลเพื่อวัตถุประสงค์ใด และลบอย่างไร ตรวจสอบรายละเอียดเหล่านี้ให้เหมาะกับการเชื่อมต่อของคุณ และหลีกเลี่ยงการส่งข้อมูลส่วนบุคคลที่ไม่จำเป็น

[นโยบายความเป็นส่วนตัว →](https://www.genderapi.io/th/privacy-policy)

### ที่อยู่อีเมลในคำขอถูกจัดเก็บหรือไม่?

นโยบายความเป็นส่วนตัวอธิบายการจัดการที่อยู่อีเมลในคำขอและบันทึกทางเทคนิคที่เกี่ยวข้อง ที่อยู่อีเมลอาจเป็นข้อมูลส่วนบุคคล จึงควรส่งเฉพาะข้อมูลที่คำขอต้องใช้ และหลีกเลี่ยงการบันทึกที่อยู่แบบเต็มในบันทึกการวินิจฉัยของคุณเอง

[ที่อยู่อีเมลและความเป็นส่วนตัว →](https://www.genderapi.io/th/privacy-policy)

### ไฟล์ Excel หรือ CSV ที่อัปโหลดถูกเก็บไว้นานเท่าใด?

นโยบายความเป็นส่วนตัวกำหนดการเก็บรักษา การลบ และการสำรองข้อมูลของไฟล์ที่อัปโหลด ส่งออกผลลัพธ์ที่ต้องการ แล้วใช้ปุ่มลบในพื้นที่ทำงานเมื่อไม่ต้องการไฟล์นั้นแล้ว หากมีคำถามเกี่ยวกับข้อกำหนดการเก็บรักษาข้อมูลขององค์กร ให้ติดต่อทีมช่วยเหลือ

[การเก็บรักษาไฟล์ →](https://www.genderapi.io/th/privacy-policy)[ติดต่อทีมช่วยเหลือ →](https://www.genderapi.io/th/contact)

### ผู้ให้บริการภายนอกประมวลผลข้อมูลคำขอหรือไฟล์ที่อัปโหลดได้หรือไม่?

นโยบายความเป็นส่วนตัวและข้อมูลผู้ประมวลผลข้อมูลช่วงอธิบายการประมวลผลโดยผู้ให้บริการและมาตรการคุ้มครองที่ใช้ เมื่อประเมินว่าข้อมูลของคุณถูกประมวลผลที่ใด ให้ตรวจสอบเอกสารเหล่านี้และข้อตกลงที่ใช้กับบัญชีของคุณ

[นโยบายความเป็นส่วนตัว →](https://www.genderapi.io/th/privacy-policy)[ผู้ประมวลผลข้อมูลช่วง →](https://www.genderapi.io/th/subprocessors)[ข้อมูล GDPR →](https://www.genderapi.io/th/gdpr-compliance)

## เชื่อมต่อคีย์และจัดการบัญชี

การใช้งานฟรี การยืนยันตัวตน การตรวจสอบยอดคงเหลือ และการช่วยเหลือ

### ทดลองใช้ GenderAPI ฟรีได้หรือไม่?

ได้ บัญชีฟรีที่ลงทะเบียนแล้วได้รับ 200 เครดิตทุกวัน นอกจากนี้การทดลองใช้ตาม IP ของ V2 ที่ไม่ต้องใช้คีย์ให้ 10 เครดิตต่อที่อยู่ IP สาธารณะในแต่ละรอบ 24 ชั่วโมง โดยใช้ร่วมกับ V1 และผู้ใช้อื่นบน IP เดียวกัน ทั้งสองแบบคิดค่าใช้จ่ายตามอัตราเครดิตปกติ จำนวนเครดิตจึงไม่เท่ากับจำนวนคำขอ HTTP เสมอไป

[แพ็กเกจฟรีและราคา →](https://www.genderapi.io/th/price)[การทดลองใช้ตาม IP →](https://www.genderapi.io/th/docs/v2/authentication)

### ควรยืนยันตัวตนของคำขอและปกป้องคีย์ API อย่างไร?

ใช้ Authorization: Bearer YOUR_API_KEY จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอ POST ต้องมี Content-Type: application/json ด้วย อย่าใส่คีย์จริงในโค้ดฝั่งเบราว์เซอร์ ที่เก็บโค้ดสาธารณะ หรือบันทึก คีย์ที่ไม่มี ผิดรูปแบบ หรือระบบไม่รู้จักอาจทำให้ใช้การทดลองใช้ตาม IP จึงควรยืนยันว่า meta.access.mode เป็น api_key คีย์ที่ระบบรู้จักแต่ถูกปิดใช้งาน หมดอายุ หรือถูกจำกัดจะไม่เปลี่ยนไปใช้การทดลองใช้

[การยืนยันตัวตนของ V2 →](https://www.genderapi.io/th/docs/v2/authentication)

### ตรวจสอบเครดิตคงเหลือได้อย่างไร?

เรียก GET /api/v2/usage ด้วยคีย์แบบ Bearer การตรวจสอบยอดคงเหลือนี้ไม่มีค่าใช้จ่ายและส่งคืน data.remaining_credits หากเรียกโดยไม่มีคีย์ ระบบจะอ่านยอดของการทดลองใช้ตาม IP ที่ใช้ร่วมกัน V1 และ V2 ใช้ยอดคงเหลือเดียวกันของบัญชี ค่า remaining_credits ในผลการคาดการณ์คือยอดคงเหลือ ณ เวลาที่งานเสร็จ

[ยอดคงเหลือและการใช้งาน →](https://www.genderapi.io/th/docs/v2/credits-and-usage)

### จัดการหรือยกเลิกการสมัครสมาชิกได้ที่ไหน?

เข้าสู่ระบบแอป GenderAPI เพื่อจัดการการสมัครสมาชิกที่เชื่อมกับคีย์ API ของคุณ ดูแพ็กเกจและตัวเลือกการยกเลิกได้ในการตั้งค่าบัญชีปัจจุบัน

[เปิดบัญชี GenderAPI →](https://app.genderapi.io/)

### อัปเดตข้อมูลการเรียกเก็บเงินได้ที่ไหน?

จัดการการตั้งค่าการเรียกเก็บเงินและการชำระเงินของคีย์ API หรือการสมัครสมาชิกที่เกี่ยวข้องได้ในแอป GenderAPI หลังเข้าสู่ระบบ

[เปิดบัญชี GenderAPI →](https://app.genderapi.io/)

### จะแจ้งผลลัพธ์ที่ไม่ถูกต้องหรือขอความช่วยเหลือด้านการเชื่อมต่อได้อย่างไร?

ส่งเวอร์ชัน API, endpoint, request_id และตัวอย่างขนาดเล็กที่ทำซ้ำปัญหาได้ให้ทีมช่วยเหลือ แนบรหัสข้อผิดพลาดหากมี แต่ให้ลบคีย์ API และข้อมูลส่วนบุคคลที่ละเอียดอ่อนออก

[ส่งอีเมลถึงทีมช่วยเหลือ →](mailto:support@genderapi.io)

## คู่มือการใช้งานและการใช้อย่างรับผิดชอบ

คำตอบเกี่ยวกับผลลัพธ์ ความเป็นส่วนตัว และการใช้งาน V2 พร้อมลิงก์ไปยังคู่มือที่เกี่ยวข้องและเวอร์ชัน Markdown ของแต่ละคำตอบ

### ผลลัพธ์ ค่าความเชื่อมั่น และการใช้อย่างรับผิดชอบ

การคาดการณ์ของ V2 ที่ระบุเพศไม่ได้จะใช้ค่า null ดั้งเดิมของ JSON ใน gender ไม่ใช่สตริง "null" ชื่ออาจกำกวมหรือสัญญาณที่มีอยู่อาจไม่เพียงพอ หากมี result_status และ reason ให้ตรวจสอบค่าเหล่านั้น เก็บผลลัพธ์ที่ไม่ทราบไว้แทนการบังคับจัดเข้ากลุ่มใดกลุ่มหนึ่ง การคาดการณ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จจะถูกหักเครดิตตามอัตราของโหมดที่เลือก ข้อผิดพลาดของคำขอหรือผู้ให้บริการเป็นความล้มเหลวแยกต่างหาก และมีข้อมูลการหักเครดิตอยู่ใน meta.usage

การประเมินความแม่นยำที่มีประโยชน์ต้องรายงานกลุ่มประชากรที่ทดสอบ วันที่ วิธีการสุ่มตัวอย่าง สัดส่วนของผลลัพธ์ที่ไม่ทราบ และผลลัพธ์แยกตามภูมิภาคและระบบอักษร หน้าวิธีการประเมินในปัจจุบันอธิบายขั้นตอนการประเมิน ไม่ได้ระบุเปอร์เซ็นต์ความแม่นยำที่วัดได้ confidence และ confidence_kind ของ V2 อธิบายหลักฐานของผลลัพธ์แต่ละรายการ แต่ใช้แทนการทดสอบด้วยข้อมูลที่เป็นตัวแทนไม่ได้

- [ทำไมผลลัพธ์ของชื่อจึงไม่ชัดเจนหรือไม่ทราบ?การคาดการณ์ของ V2 ที่ระบุเพศไม่ได้จะใช้ค่า null ดั้งเดิมของ JSON ใน gender ไม่ใช่สตริง "null" ชื่ออาจกำกวมหรือสัญญาณที่มีอยู่อาจไม่เพียงพอ หากมี result_status และ reason ให้ตรวจสอบค่าเหล่านั้น เก็บผลลัพธ์ที่ไม่ทราบไว้แทนการบังคับจัดเข้ากลุ่มใดกลุ่มหนึ่ง การคาดการณ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จจะถูกหักเครดิตตามอัตราของโหมดที่เลือก ข้อผิดพลาดของคำขอหรือผู้ให้บริการเป็นความล้มเหลวแยกต่างหาก และมีข้อมูลการหักเครดิตอยู่ใน meta.usageอ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/ambiguous-and-unknown-name-results)
- [ความแม่นยำของ GenderAPI ประเมินอย่างไร?การประเมินความแม่นยำที่มีประโยชน์ต้องรายงานกลุ่มประชากรที่ทดสอบ วันที่ วิธีการสุ่มตัวอย่าง สัดส่วนของผลลัพธ์ที่ไม่ทราบ และผลลัพธ์แยกตามภูมิภาคและระบบอักษร หน้าวิธีการประเมินในปัจจุบันอธิบายขั้นตอนการประเมิน ไม่ได้ระบุเปอร์เซ็นต์ความแม่นยำที่วัดได้ confidence และ confidence_kind ของ V2 อธิบายหลักฐานของผลลัพธ์แต่ละรายการ แต่ใช้แทนการทดสอบด้วยข้อมูลที่เป็นตัวแทนไม่ได้อ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/how-accuracy-is-measured)

### แหล่งข้อมูล ความเป็นส่วนตัว และการปฏิบัติตามข้อกำหนด

หน้าแหล่งที่มาของข้อมูลอธิบายกรอบการบันทึกประเภทของแหล่งข้อมูล เกณฑ์การคัดเลือก สิทธิ์การใช้งาน และข้อจำกัดด้านภูมิศาสตร์หรือระบบอักษร ปัจจุบันยังไม่มีการเผยแพร่รายการแหล่งข้อมูลที่ผ่านการตรวจสอบแล้ว ดูหน้านั้นและติดต่อทีมช่วยเหลือหากการเชื่อมต่อของคุณมีข้อกำหนดเกี่ยวกับแหล่งข้อมูล อย่าคาดเดาแหล่งข้อมูล ขนาดชุดข้อมูล หรือตัวเลขความครอบคลุมที่ไม่ได้ระบุไว้ในเอกสาร

หน้าแหล่งที่มาของข้อมูลในปัจจุบันไม่ได้ระบุกำหนดการอัปเดตเดียวที่ใช้กับทุกระเบียนชื่อหรือกฎการประมวลผล หากความใหม่ของข้อมูลมีผลต่อกรณีการใช้งานของคุณ ให้สอบถามทีมช่วยเหลือเกี่ยวกับชุดข้อมูลหรือเวิร์กโฟลว์ที่เกี่ยวข้อง และทดสอบด้วยผลลัพธ์ที่เป็นตัวแทน วันที่ตรวจทานของหน้าเว็บไม่ได้เป็นหลักฐานว่าระเบียนพื้นฐานทั้งหมดได้รับการอัปเดตในวันนั้น

นโยบายความเป็นส่วนตัว ข้อมูล GDPR ข้อตกลงการประมวลผลข้อมูล และรายชื่อผู้ประมวลผลข้อมูลช่วงอธิบายเงื่อนไขการประมวลผลและมาตรการคุ้มครองที่เผยแพร่ไว้ ตรวจสอบเอกสารฉบับปัจจุบันและข้อตกลงที่ใช้กับบัญชีของคุณ หากมีคำถามเฉพาะองค์กรเกี่ยวกับบทบาทในการประมวลผล การโอนข้อมูล หรือคำขอของเจ้าของข้อมูล ให้ติดต่อ GenderAPI คำตอบในคำถามที่พบบ่อยทั่วไปใช้แทนข้อตกลงที่มีผลบังคับไม่ได้

- [แหล่งข้อมูลชื่อถูกเลือกอย่างไร?หน้าแหล่งที่มาของข้อมูลอธิบายกรอบการบันทึกประเภทของแหล่งข้อมูล เกณฑ์การคัดเลือก สิทธิ์การใช้งาน และข้อจำกัดด้านภูมิศาสตร์หรือระบบอักษร ปัจจุบันยังไม่มีการเผยแพร่รายการแหล่งข้อมูลที่ผ่านการตรวจสอบแล้ว ดูหน้านั้นและติดต่อทีมช่วยเหลือหากการเชื่อมต่อของคุณมีข้อกำหนดเกี่ยวกับแหล่งข้อมูล อย่าคาดเดาแหล่งข้อมูล ขนาดชุดข้อมูล หรือตัวเลขความครอบคลุมที่ไม่ได้ระบุไว้ในเอกสารอ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/how-name-data-sources-are-selected)
- [ข้อมูลชื่ออัปเดตบ่อยแค่ไหน?หน้าแหล่งที่มาของข้อมูลในปัจจุบันไม่ได้ระบุกำหนดการอัปเดตเดียวที่ใช้กับทุกระเบียนชื่อหรือกฎการประมวลผล หากความใหม่ของข้อมูลมีผลต่อกรณีการใช้งานของคุณ ให้สอบถามทีมช่วยเหลือเกี่ยวกับชุดข้อมูลหรือเวิร์กโฟลว์ที่เกี่ยวข้อง และทดสอบด้วยผลลัพธ์ที่เป็นตัวแทน วันที่ตรวจทานของหน้าเว็บไม่ได้เป็นหลักฐานว่าระเบียนพื้นฐานทั้งหมดได้รับการอัปเดตในวันนั้นอ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/how-often-name-data-is-updated)
- [ดูข้อมูล GDPR และข้อตกลงการประมวลผลข้อมูลได้ที่ไหน?นโยบายความเป็นส่วนตัว ข้อมูล GDPR ข้อตกลงการประมวลผลข้อมูล และรายชื่อผู้ประมวลผลข้อมูลช่วงอธิบายเงื่อนไขการประมวลผลและมาตรการคุ้มครองที่เผยแพร่ไว้ ตรวจสอบเอกสารฉบับปัจจุบันและข้อตกลงที่ใช้กับบัญชีของคุณ หากมีคำถามเฉพาะองค์กรเกี่ยวกับบทบาทในการประมวลผล การโอนข้อมูล หรือคำขอของเจ้าของข้อมูล ให้ติดต่อ GenderAPI คำตอบในคำถามที่พบบ่อยทั่วไปใช้แทนข้อตกลงที่มีผลบังคับไม่ได้อ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/genderapi-gdpr-and-dpa)

### การใช้งาน API ข้อผิดพลาด และการหักเครดิต

ใช้ Authorization: Bearer YOUR_API_KEY จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอ POST ของ V2 ต้องมี Content-Type: application/json ด้วย GET /api/v2/gender รับคีย์ในพารามิเตอร์ของ query ได้เช่นกัน แต่การใช้ header ช่วยไม่ให้ข้อมูลรับรองปรากฏใน URL ของเบราว์เซอร์ คีย์ที่ไม่มี ผิดรูปแบบ หรือระบบไม่รู้จักอาจทำให้ใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกัน สำหรับการเชื่อมต่อด้วยบัญชี ให้ตรวจสอบว่า meta.access.mode เป็น api_key คีย์ที่ระบบรู้จักแต่ถูกปิดใช้งาน หมดอายุ หรือถูกจำกัดจะไม่เปลี่ยนไปใช้การทดลองใช้

V2 ใช้ขีดจำกัดจำนวนคำขอและคำขอพร้อมกัน จึงต้องรองรับ HTTP 429 และ Retry-After การคาดการณ์ที่ส่งซ้ำแต่ละครั้งเป็นงานใหม่และคิดค่าใช้จ่ายตามปกติ อย่าส่งคำขอซ้ำโดยอัตโนมัติเมื่อหมดเวลา ผลลัพธ์สูญหาย หรือการหักเครดิตยังไม่ได้รับการยืนยัน ให้ตรวจสอบ code, action และ meta.usage.billing_status ก่อน หากเป็น billing_reconciliation_required ให้ติดต่อทีมช่วยเหลือพร้อม request_id ใช้ backoff แบบจำกัดจำนวนครั้งเฉพาะเมื่อยืนยันการหักเครดิตแล้วและ action ในเอกสารอนุญาตให้ส่งคำขอใหม่

ข้อผิดพลาดของ V2 API ใช้สถานะข้อผิดพลาด HTTP และ RFC 9457 Problem Details ที่มีฟิลด์ code และ action ซึ่งคงที่ ให้จัดการข้อผิดพลาดตามฟิลด์เหล่านี้แทนการเทียบข้อความใน detail และเก็บ request_id ไว้สำหรับติดต่อทีมช่วยเหลือ ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จไม่ใช่ข้อผิดพลาด ผลลัพธ์ของคำขอแบบกลุ่มอาจมีข้อผิดพลาดของรายการแม้จะเป็น HTTP 200 พร็อกซีอาจส่งคืนข้อผิดพลาดที่ไม่ใช่ JSON และผลลัพธ์ที่สูญหายหรืออ่านไม่ได้ไม่ได้ยืนยันว่าไม่มีการหักเครดิต

เรียก GET /api/v2/usage ด้วยคีย์ API แบบ Bearer จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอนี้ไม่มีค่าใช้จ่ายและส่งคืน data.remaining_credits หากไม่ส่งคีย์ ระบบจะอ่านยอดของการทดลองใช้ตาม IP ที่ใช้ร่วมกัน V1 และ V2 ใช้ยอดคงเหลือเดียวกันของบัญชี meta.usage ในผลการคาดการณ์แสดงเครดิตที่งานนั้นใช้และยอดคงเหลือ ณ เวลาที่งานเสร็จ ซึ่งอาจเปลี่ยนไปเมื่อมีคำขอพร้อมกัน อย่าบันทึกข้อมูลรับรองไว้ในบันทึก และอย่าถือว่าการอ่านยอดคงเหลือเป็นหลักฐานว่าคำขอที่ผลลัพธ์สูญหายไม่ได้ถูกหักเครดิต

ใช้ V2 สำหรับการเชื่อมต่อใหม่ และให้ไคลเอนต์ V1 ที่มีอยู่ใช้ endpoint ตามเอกสารต่อไปจนกว่าคุณจะตัดสินใจย้าย ทั้งสองเวอร์ชันใช้คีย์ API และเครดิตเดียวกัน แต่ฟิลด์ของคำขอ โครงสร้างผลลัพธ์ และรูปแบบข้อผิดพลาดแตกต่างกัน ทำตามคู่มือการย้ายระบบ ทดสอบผลลัพธ์ที่สำเร็จ ผลลัพธ์ที่ไม่ทราบ และข้อผิดพลาด แล้วอัปเดตโค้ดที่อ่านผลลัพธ์ก่อนเปลี่ยน endpoint เอกสาร V1 ยังคงให้บริการสำหรับการเชื่อมต่อเดิม

หากคำขอล้มเหลว ให้ใช้รหัสข้อผิดพลาดที่ส่งคืนเพื่อแยกความล้มเหลวของบริการออกจากข้อมูลนำเข้าที่ไม่ถูกต้อง ปัญหาการเข้าถึงบัญชี เครดิตไม่พอ หรือขีดจำกัดคำขอ ติดตามอัตราความสำเร็จของคำขอและเวลาตอบสนองในการเชื่อมต่อของคุณเอง หากมีความล้มเหลวที่ไม่ทราบสาเหตุหรือไม่แน่ใจเรื่องการหักเครดิต ให้ติดต่อทีมช่วยเหลือพร้อม request_id การกล่าวอ้างเรื่องความพร้อมใช้งานต้องอิงข้อมูลการติดตามที่วัดได้ คำตอบนี้ไม่ได้รับประกันเปอร์เซ็นต์ความพร้อมใช้งาน

- [ยืนยันตัวตนของคำขอ V2 อย่างไร?ใช้ Authorization: Bearer YOUR_API_KEY จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอ POST ของ V2 ต้องมี Content-Type: application/json ด้วย GET /api/v2/gender รับคีย์ในพารามิเตอร์ของ query ได้เช่นกัน แต่การใช้ header ช่วยไม่ให้ข้อมูลรับรองปรากฏใน URL ของเบราว์เซอร์ คีย์ที่ไม่มี ผิดรูปแบบ หรือระบบไม่รู้จักอาจทำให้ใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกัน สำหรับการเชื่อมต่อด้วยบัญชี ให้ตรวจสอบว่า meta.access.mode เป็น api_key คีย์ที่ระบบรู้จักแต่ถูกปิดใช้งาน หมดอายุ หรือถูกจำกัดจะไม่เปลี่ยนไปใช้การทดลองใช้อ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/how-to-authenticate-api-requests)
- [ควรจัดการขีดจำกัดคำขอและการส่งคำขอซ้ำอย่างไร?V2 ใช้ขีดจำกัดจำนวนคำขอและคำขอพร้อมกัน จึงต้องรองรับ HTTP 429 และ Retry-After การคาดการณ์ที่ส่งซ้ำแต่ละครั้งเป็นงานใหม่และคิดค่าใช้จ่ายตามปกติ อย่าส่งคำขอซ้ำโดยอัตโนมัติเมื่อหมดเวลา ผลลัพธ์สูญหาย หรือการหักเครดิตยังไม่ได้รับการยืนยัน ให้ตรวจสอบ code, action และ meta.usage.billing_status ก่อน หากเป็น billing_reconciliation_required ให้ติดต่อทีมช่วยเหลือพร้อม request_id ใช้ backoff แบบจำกัดจำนวนครั้งเฉพาะเมื่อยืนยันการหักเครดิตแล้วและ action ในเอกสารอนุญาตให้ส่งคำขอใหม่อ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/rate-limits-and-retries)
- [ควรตีความข้อผิดพลาดของ V2 อย่างไร?ข้อผิดพลาดของ V2 API ใช้สถานะข้อผิดพลาด HTTP และ RFC 9457 Problem Details ที่มีฟิลด์ code และ action ซึ่งคงที่ ให้จัดการข้อผิดพลาดตามฟิลด์เหล่านี้แทนการเทียบข้อความใน detail และเก็บ request_id ไว้สำหรับติดต่อทีมช่วยเหลือ ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จไม่ใช่ข้อผิดพลาด ผลลัพธ์ของคำขอแบบกลุ่มอาจมีข้อผิดพลาดของรายการแม้จะเป็น HTTP 200 พร็อกซีอาจส่งคืนข้อผิดพลาดที่ไม่ใช่ JSON และผลลัพธ์ที่สูญหายหรืออ่านไม่ได้ไม่ได้ยืนยันว่าไม่มีการหักเครดิตอ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/api-error-codes)
- [ตรวจสอบเครดิตคงเหลือได้อย่างไร?เรียก GET /api/v2/usage ด้วยคีย์ API แบบ Bearer จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอนี้ไม่มีค่าใช้จ่ายและส่งคืน data.remaining_credits หากไม่ส่งคีย์ ระบบจะอ่านยอดของการทดลองใช้ตาม IP ที่ใช้ร่วมกัน V1 และ V2 ใช้ยอดคงเหลือเดียวกันของบัญชี meta.usage ในผลการคาดการณ์แสดงเครดิตที่งานนั้นใช้และยอดคงเหลือ ณ เวลาที่งานเสร็จ ซึ่งอาจเปลี่ยนไปเมื่อมีคำขอพร้อมกัน อย่าบันทึกข้อมูลรับรองไว้ในบันทึก และอย่าถือว่าการอ่านยอดคงเหลือเป็นหลักฐานว่าคำขอที่ผลลัพธ์สูญหายไม่ได้ถูกหักเครดิตอ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/check-credits-and-quota)
- [ย้ายจาก V1 ไป V2 อย่างปลอดภัยได้อย่างไร?ใช้ V2 สำหรับการเชื่อมต่อใหม่ และให้ไคลเอนต์ V1 ที่มีอยู่ใช้ endpoint ตามเอกสารต่อไปจนกว่าคุณจะตัดสินใจย้าย ทั้งสองเวอร์ชันใช้คีย์ API และเครดิตเดียวกัน แต่ฟิลด์ของคำขอ โครงสร้างผลลัพธ์ และรูปแบบข้อผิดพลาดแตกต่างกัน ทำตามคู่มือการย้ายระบบ ทดสอบผลลัพธ์ที่สำเร็จ ผลลัพธ์ที่ไม่ทราบ และข้อผิดพลาด แล้วอัปเดตโค้ดที่อ่านผลลัพธ์ก่อนเปลี่ยน endpoint เอกสาร V1 ยังคงให้บริการสำหรับการเชื่อมต่อเดิมอ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/api-versioning-and-breaking-changes)
- [ตรวจสอบข้อผิดพลาดและติดตามความพร้อมใช้งานของบริการได้อย่างไร?หากคำขอล้มเหลว ให้ใช้รหัสข้อผิดพลาดที่ส่งคืนเพื่อแยกความล้มเหลวของบริการออกจากข้อมูลนำเข้าที่ไม่ถูกต้อง ปัญหาการเข้าถึงบัญชี เครดิตไม่พอ หรือขีดจำกัดคำขอ ติดตามอัตราความสำเร็จของคำขอและเวลาตอบสนองในการเชื่อมต่อของคุณเอง หากมีความล้มเหลวที่ไม่ทราบสาเหตุหรือไม่แน่ใจเรื่องการหักเครดิต ให้ติดต่อทีมช่วยเหลือพร้อม request_id การกล่าวอ้างเรื่องความพร้อมใช้งานต้องอิงข้อมูลการติดตามที่วัดได้ คำตอบนี้ไม่ได้รับประกันเปอร์เซ็นต์ความพร้อมใช้งานอ่านคำตอบเต็ม →](https://www.genderapi.io/th/frequently-asked-questions/service-status-and-uptime)

## ส่งตัวอย่างที่ทำซ้ำปัญหาได้

ระบุเวอร์ชัน API, endpoint, request_id และข้อผิดพลาดที่ได้รับ โดยไม่ส่งคีย์ API หรือข้อมูลส่วนบุคคลที่ละเอียดอ่อน

- [ส่งอีเมลถึงทีมช่วยเหลือ](mailto:support@genderapi.io)
- [ดูข้อผิดพลาดของ V2](https://www.genderapi.io/th/docs/v2/errors-and-retries)