V2 · Анализ всей записи
1 запрос API на вызовСначала V2 проверяет наличие человеческой речи, затем модель ECAPA-TDNN классифицирует всю запись. Версия подходит для записей с одним человеком. Отправьте аудиофайл в поле file запроса multipart/form-data.
Почему стоит выбрать V2 вместо V1? Старая модель V1 всегда предсказывает male или female, даже для тишины, музыки или шума. V2 проверяет наличие речи и возвращает unknown, если речи нет, вместо догадки. Также используется ECAPA-TDNN, которая анализирует характеристики голоса во времени; в тестовых сравнениях голосов на backend она показала большую точность, чем модель V1. V2 объединяет голоса в одной записи, поэтому для нескольких говорящих выбирайте V3.
Эндпоинт
POST /v1/voice-gender-recognition/api/v2Успешный ответ содержит gender со значением male, female или unknown, confidence в процентах и remainingRequests. Если gender равен unknown, ответ также содержит поясняющее сообщение.
Результат unknown возвращается, если человеческая речь не обнаружена. Это успешный ответ, а не ошибка API.
Запрос 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'
Пример ответа с определённым полом
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}Пример ответа, если пол определить не удалось
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "No clear speech was detected in the audio, so the gender could not be determined.",
"remainingRequests": 119
}