跳到主要内容

姓名性别推断 API

根据名和姓推断可能的性别。

基础 URL​

https://api.genderrecognition.com

端点​

POST /v1/voice-gender-recognition/api/name

请求标头​

apiKey: YOUR_API_KEY
Content-Type: application/json

请求正文​

{
  "firstName": "Alex",
  "lastName": "Morgan"
}

示例​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/name" \
  -H "Content-Type: application/json" \
  -H "apiKey: YOUR_API_KEY" \
  -d '{
  "firstName": "Alex",
  "lastName": "Morgan"
}'

响应​

{
  "success": true,
  "name": "Alex Morgan",
  "gender": "male",
  "confidence": 0.86,
  "remainingRequests": 2999
}

错误情况​

缺少 API 密钥​

{
  "error": "API key is required"
}

API 密钥无效​

{
  "error": "Invalid API key"
}

缺少名​

{
  "error": "First name is required"
}

缺少姓​

{
  "error": "Last name is required"
}

姓名过长​

{
  "error": "First name must not exceed 50 characters"
}

缺少 JSON 内容类型​

{
  "error": "Content-Type header is required. Please set Content-Type: application/json"
}

不支持的 JSON 内容类型​

{
  "error": "Content-Type must be application/json"
}

配额已用尽​

{
  "error": "Insufficient remaining requests"
}

处理失败​

{
  "error": "Internal server error"
}