Skip to main content

Authentication

GVR developer endpoints are protected with API key authentication.

Base URL​

https://api.genderrecognition.com

Send your key in the apiKey header:

apiKey: YOUR_API_KEY

The backend reads this header as apikey, so header casing is not important in normal HTTP clients.

Example​

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

When authentication fails​

Missing API key​

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

Invalid API key​

{
  "error": "Invalid API key"
}

Internal authentication error​

{
  "error": "Internal server error"
}

Requests can also fail when:

  • the key has no remaining quota
  • the request body fails validation
  • an uploaded file is missing, too large, or unsupported

Each endpoint page lists the request-specific error responses for that API.

Keep keys private and rotate them if they are exposed.