V2 · Análisis del clip completo
1 solicitud API por llamadaV2 comprueba primero que haya voz humana y luego usa el modelo de voz ECAPA-TDNN para clasificar la grabación completa. Está pensado para grabaciones con una sola persona. Envía un archivo de audio en el campo file mediante multipart/form-data.
¿Por qué elegir V2 en lugar de V1? El modelo anterior de V1 siempre predice male o female, incluso con silencio, música o ruido. V2 añade detección del habla y devuelve unknown cuando no detecta voz, en vez de adivinar. También usa ECAPA-TDNN, que modela las características de la voz a lo largo del tiempo; en las comparaciones de voces de prueba del backend resultó más preciso que el modelo V1. V2 combina las voces del clip, así que elige V3 para grabaciones con varias personas.
Endpoint
POST /v1/voice-gender-recognition/api/v2Las respuestas correctas devuelven gender como male, female o unknown, confidence como porcentaje y remainingRequests. Si gender es unknown, la respuesta también incluye un mensaje explicativo.
El resultado es unknown cuando no se detecta voz humana. Es una respuesta correcta, no un error de la API.
Solicitud cURL
curl -X POST 'https://api.genderrecognition.com/v1/voice-gender-recognition/api/v2' \ -H 'apiKey: YOUR_API_KEY' \ -F 'file=@/path/to/recording.wav'
Ejemplo de respuesta con género detectado
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}Ejemplo de respuesta cuando el género es desconocido
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "No clear speech was detected in the audio, so the gender could not be determined.",
"remainingRequests": 119
}