Xác định giới tính từ một tên người dùng hoặc biệt danh

Tổng quan yêu cầu

Từ tên người dùng đến tên có khả năng

GenderAPI tìm kiếm các tín hiệu tên trong handle được gửi, sau đó dự đoán giới tính bằng chứng cứ từ cơ sở dữ liệu, bối cảnh quốc gia và—khi được yêu cầu—sử dụng fallback dựa trên AI.

Inputsparkling_unicorn

Tín hiệu đã trích xuấtSparkling

Predictionnữ · 92%

MethodPOST

Loại nội dungapplication/json

AuthenticationToken Bearer

Các lựa chọn AIAvailable

HDR

Các tiêu đề HTTP bắt buộc

Xác thực yêu cầu

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Thân bản yêu cầu JSON

Tham số

Parameter	Type	Requirement	Description
`username`	string	Bắt buộc	Tên người dùng, tài khoản xã hội, tên hiển thị hoặc biệt danh cần phân tích.
`country`	string	Tùy chọn	Mã quốc gia ISO 3166-1 alpha-2, ví dụ như US hoặc TR, để cung cấp bối cảnh khu vực.
`askToAI`	boolean	Tùy chọn	Khi là đúng, sử dụng phương án AI nếu tên được trích xuất không có kết quả trong cơ sở dữ liệu.
`forceToGenderize`	boolean	Tùy chọn	Khi là đúng, cố gắng dự đoán cho các tên gọi thay thế hoặc đầu vào không tương tự với các tên thông thường.

askToAI

Sử dụng chỉ khi tên được trích xuất không có kết quả trong cơ sở dữ liệu.

forceToGenderize

Cho phép thử nghiệm với các thuật ngữ hư cấu, các tên gọi giống thương hiệu và những biệt danh không thường thấy.

Tính chính xác có ý nghĩa:Các kết quả được ép buộc với các tín hiệu tên yếu hoặc không phải con người có thể ít đáng tin cậy. Đánh giáprobabilitytrước khi hành động dựa trên dự đoán.

Ví dụ về mã hóa

Gửi yêu cầu tên người dùng

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":"US","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: "US", 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": "US", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

Trả về mã 200

Tín hiệu đã trích xuất and prediction

JSON

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

Các trường trong phản hồi

Field	Type	Description
`status`	boolean	Tình trạng yêu cầu đã hoàn thành thành công hay không.
`used_credits`	integer	Số lượng điểm được sử dụng cho yêu cầu này.
`remaining_credits`	integer	Số lượng điểm còn lại sau khi thực hiện yêu cầu.
`expires`	integer	Thời gian hết hạn gói được biểu diễn dưới dạng thời gian UNIX.
`q`	string	Tên người dùng ban đầu được gửi trong yêu cầu.
`name`	string	Tên có khả năng được trích xuất từ tên người dùng.
`gender`	string \| null	Giá trị dự đoán: nam, nữ hoặc null.
`country`	string	Mã quốc gia được xem xét để thực hiện dự đoán.
`total_names`	integer	Số lượng mẫu hỗ trợ dự đoán.
`probability`	integer	Độ tin cậy của dự đoán dưới dạng phần trăm.
`duration`	string	Thời gian xử lý trên máy chủ.

Xem tên người dùng như các tín hiệu gián tiếp

Một tên người dùng có thể mô tả một thương hiệu, nhân vật hoặc khái niệm thay vì một cá nhân. Xác nhận rằng tín hiệu đã trích xuất là có ý nghĩa và thiết lập ngưỡng xác suất chấp nhận được cho trường hợp sử dụng của bạn.nameLàm rõ tính hợp lệ và thiết lập ngưỡng xác suất chấp nhận được cho trường hợp sử dụng của bạn.

Hướng dẫn tiếp theo

Phân tích nhiều tên người dùng

Yêu cầu nhiều tên người dùngXử lý nhiều tài khoản trong một yêu cầu →Yêu cầu email đơn lẻTrích xuất tên từ địa chỉ email →