API ทำนายเพศจากชื่อผู้ใช้

ภาพรวมคำขอ

แยกสัญญาณชื่อจากชื่อผู้ใช้

GenderAPI ค้นหาสัญญาณชื่อจากแฮนเดิลที่ป้อน แล้วทำนายเพศด้วยข้อมูลฐานข้อมูลและบริบทประเทศ สามารถใช้ AI เสริมได้เมื่อร้องขอ

อินพุตsparkling_unicorn

ชื่อที่แยกได้Sparkling

การทำนายfemale · 92%

วิธีPOST

ชนิดเนื้อหาapplication/json

การยืนยันตัวตนBearer token

ตัวเลือก AIใช้ได้

HDR

HTTP header ที่จำเป็น

ยืนยันตัวตนของคำขอ

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

เนื้อหาคำขอ JSON

พารามิเตอร์

พารามิเตอร์	ชนิด	ข้อกำหนด	คำอธิบาย
`username`	string	จำเป็น	ชื่อผู้ใช้ แฮนเดิลโซเชียล ชื่อที่แสดง หรือนามแฝงที่ต้องการวิเคราะห์
`country`	string	ไม่บังคับ	รหัสประเทศ ISO 3166-1 alpha-2 เช่น TH หรือ US สำหรับบริบทภูมิภาค
`askToAI`	boolean	ไม่บังคับ	เมื่อเป็น true ระบบจะใช้ AI เสริมหากไม่พบชื่อที่แยกได้ในฐานข้อมูล
`forceToGenderize`	boolean	ไม่บังคับ	เมื่อเป็น true ระบบจะพยายามทำนายแม้นามแฝงหรืออินพุตดูไม่เหมือนชื่อบุคคลทั่วไป

askToAI

ใช้ AI เสริมเฉพาะเมื่อไม่พบชื่อที่แยกได้ในฐานข้อมูล

forceToGenderize

พยายามทำนายคำแฟนตาซี นามแฝงแบบแบรนด์ และชื่อเล่นที่ไม่ทั่วไป

ตรวจสอบความเชื่อมั่น: การบังคับทำนายสัญญาณที่อ่อนหรือไม่ใช่ชื่อบุคคลอาจมีความเชื่อมั่นต่ำ ตรวจสอบprobability ก่อนใช้ผลลัพธ์

ตัวอย่างโค้ด

ส่งคำขอชื่อผู้ใช้

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"TH","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "TH", askToAI: true, forceToGenderize: true })
});

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/username",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"username": "sparkling_unicorn", "country": "TH", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

ผลลัพธ์ 200

สัญญาณชื่อที่แยกได้และผลการทำนาย

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "TH",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

ฟิลด์ผลลัพธ์

ฟิลด์	ชนิด	คำอธิบาย
`status`	boolean	ระบุว่าคำขอเสร็จสมบูรณ์หรือไม่
`used_credits`	integer	เครดิตที่ใช้กับคำขอนี้
`remaining_credits`	integer	เครดิตคงเหลือหลังคำขอ
`expires`	integer	UNIX timestamp ที่แพ็กเกจหมดอายุ
`q`	string	ชื่อผู้ใช้เดิมที่ส่ง
`name`	string	ชื่อที่คาดว่าแยกจากชื่อผู้ใช้
`gender`	string \| null	ผลการทำนายเป็น male, female หรือ null
`country`	string	รหัสประเทศที่ใช้ในการทำนาย
`total_names`	integer	จำนวนระเบียนชื่อที่เป็นพื้นฐานในการทำนาย
`probability`	integer	เปอร์เซ็นต์ความเชื่อมั่น
`duration`	string	เวลาประมวลผลของเซิร์ฟเวอร์

ใช้ชื่อผู้ใช้เป็นสัญญาณทางอ้อม

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

คู่มือถัดไป

วิเคราะห์หลายชื่อผู้ใช้

คำขอหลายชื่อผู้ใช้ประมวลผลหลายแฮนเดิลพร้อมกัน →คำขออีเมลเดียวแยกชื่อจากอีเมล →