V2 · Análise do clipe inteiro
1 solicitação de API por chamadaA V2 verifica primeiro se há fala humana e, em seguida, usa o modelo de voz ECAPA-TDNN para classificar a gravação inteira. É indicada para gravações com uma pessoa. Envie um arquivo de áudio no campo file usando multipart/form-data.
Por que escolher V2 em vez de V1? O modelo antigo da V1 sempre prevê male ou female, mesmo para silêncio, música ou ruído. A V2 adiciona detecção de fala e retorna unknown quando não detecta voz, em vez de adivinhar. Ela também usa ECAPA-TDNN, que modela características vocais ao longo do tempo; nas comparações de vozes de teste do backend, mostrou mais precisão que o modelo V1. A V2 combina as vozes no clipe, então escolha V3 para gravações com várias pessoas.
Endpoint
POST /v1/voice-gender-recognition/api/v2As respostas bem-sucedidas retornam gender como male, female ou unknown, confidence em porcentagem e remainingRequests. Quando gender é unknown, a resposta também inclui uma mensagem explicativa.
O resultado é unknown quando nenhuma fala humana é detectada. É uma resposta bem-sucedida, não um erro da API.
Solicitação 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'
Exemplo de resposta com gênero detectado
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}Exemplo de resposta quando o gênero é desconhecido
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "No clear speech was detected in the audio, so the gender could not be determined.",
"remainingRequests": 119
}