跳到主要内容

身份验证

GVR 开发者 API 端点通过 API 密钥进行保护。

基础 URL​

https://api.genderrecognition.com

请求标头​

在 apiKey 标头中发送密钥：

apiKey: YOUR_API_KEY

后端会将此标头读取为 apikey，因此在常规 HTTP 客户端中，标头大小写并不重要。

示例​

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"
}'

身份验证失败时​

缺少 API 密钥​

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

API 密钥无效​

{
  "error": "Invalid API key"
}

身份验证服务内部错误​

{
  "error": "Internal server error"
}

以下情况也可能导致请求失败：

  • 密钥的剩余配额为零
  • 请求正文未通过验证
  • 上传文件缺失、过大或格式不受支持

每个端点的文档都列出了该 API 特有的错误响应。

请妥善保管密钥；如果密钥泄露，请立即轮换。