Lấy Giới Tính từ Tên - Yêu Cầu Đơn

Endpoint Lấy Giới Tính từ Tên cho phép bạn xác định giới tính từ một tên riêng lẻ. Tất cả các tham số được gửi qua yêu cầu POST dưới dạng JSON. Bạn phải xác thực bằng phương thức Bearer token trong header Authorization.

URL Yêu Cầu

POST https://api.genderapi.io/api

HTTP Header Bắt Buộc

  • Content-Type: application/json
  • Authorization: Bearer YOUR_API_KEY

Tham Số Trong Body Yêu Cầu

Tham Số Kiểu Dữ Liệu Bắt Buộc Mô Tả
name String Tên mà bạn muốn phân tích. Phải là một từ duy nhất, không chứa danh xưng hoặc tiền tố.
country String Không Mã quốc gia gồm hai chữ cái (ISO 3166-1 alpha-2) để tăng độ chính xác của dự đoán. Ví dụ: TR cho Thổ Nhĩ Kỳ.
askToAI Boolean Không Nếu đặt là true, API sẽ hỏi mô hình AI để xác định giới tính nếu không tìm thấy tên trong cơ sở dữ liệu.
forceToGenderize Boolean Không Nếu đặt là true, API sẽ cố gắng đoán giới tính ngay cả với các giá trị không phải tên người thật, như biệt danh hoặc các cụm từ tưởng tượng (ví dụ: sparkling unicorn).

Ví Dụ Yêu Cầu


Ví Dụ cURL

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

Ví Dụ PHP cURL

<?php
$url = "https://api.genderapi.io/api";

$data = array(
    "name" => "Alice",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => true
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Ví Dụ JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "Alice",
    country: "US",
    askToAI: true,
    forceToGenderize: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Ví Dụ Python requests


import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": True
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Ví Dụ JSON Phản Hồi

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "Alice",
  "name": "Alice",
  "gender": "female",
  "country": "US",
  "total_names": 10234,
  "probability": 98,
  "duration": "4ms"
}

Các Trường Trong Phản Hồi

Trường Kiểu Dữ Liệu Mô Tả
status Boolean Cho biết yêu cầu có thành công hay không.
used_credits Integer Số credit đã sử dụng cho yêu cầu này.
remaining_credits Integer Số credit còn lại trong tài khoản sau yêu cầu này.
expires Integer (timestamp) Ngày hết hạn gói dịch vụ dưới dạng UNIX timestamp.
q String Truy vấn bạn gửi (tên bạn nhập vào).
name String Tên được phân tích hoặc trích xuất.
gender Enum[String] Giới tính được dự đoán. Giá trị có thể: male, female, hoặc null.
country String Mã quốc gia được xem xét trong quá trình dự đoán.
total_names Integer Số lượng mẫu tên được sử dụng cho dự đoán này.
probability Integer Tỷ lệ phần trăm độ tin cậy cho dự đoán giới tính.
duration String Thời gian xử lý yêu cầu (ví dụ: 4ms).
Cảnh báo: Luôn đảm bảo rằng các giá trị đầu vào như tên không chứa ký tự không mong muốn. Nếu bạn định sử dụng các ký tự đặc biệt hoặc khoảng trắng, hãy chắc chắn mã hóa JSON đúng cách để tránh lỗi.