API de Reconhecimento de Gênero por Voz

Transforme clipes de voz em insights de gênero com uma única API.

Envie uma URL de áudio ou um arquivo de áudio no corpo para obter gênero, confiança e informações de uso. Criado para IVR, centros de contato e aplicativos baseados em voz.

VUpload de arquivo ou URL de áudio
VPontuações de confiança retornadas
VClipes curtos frequentemente <2s
VSeguro via HTTPS

Início Rápido (JSON body)

POST JSON
/v1/voice-gender-recognition/apiPOST

// Headers

apiKey:

YOUR_API_KEY

// JSON Body

{
  "url": "https://example.com/audio.wav" 
OR
"file": "audio_file"
}

// Sample Response

{
  "gender": "female",
  "confidence": 95,
  "remainingRequests": 120,
  "success": true
}

Envie url ou file (base64) no corpo JSON—não ambos. Para uploads grandes, use multipart/form-data para POST /v1/voice-gender-recognition/api com um campo "file".

Escolha uma versão da API

Compare V2 e V3

O endpoint V1 existente continua disponível para solicitações por URL ou arquivo. V2 e V3 exigem o envio de um arquivo multipart/form-data e detectam fala para retornar “unknown” quando o áudio não contém fala útil suficiente.

V2 · Análise do clipe inteiro

1 solicitação de API por chamada

A 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/v2

As 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
}

V3 · Análise por locutor

2 solicitações de API por chamada

A V3 detecta fala, identifica os locutores e classifica uma pessoa selecionada. É indicada para chamadas, entrevistas e outras gravações com várias pessoas. O primeiro locutor é selecionado, a menos que fale por menos de 2 segundos; nesse caso, é escolhido quem falou por mais tempo. Se não houver fala ou a pessoa selecionada falar por menos de 1 segundo, o gênero retornado será “unknown”. Envie um arquivo de áudio no campo file usando multipart/form-data.

Por que escolher V3 em vez de V1 e V2? Assim como a V2, ela evita suposições quando não há fala e usa ECAPA-TDNN no lugar do modelo antigo da V1. Diferentemente da V2, que combina todas as vozes em uma previsão, a V3 usa diarização para isolar uma pessoa antes da classificação e reduzir a interferência de outras vozes. A V3 demora mais e faz uma chamada paga ao Deepgram quando a gravação contém fala.

Endpoint

POST /v1/voice-gender-recognition/api/v3

As 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 não há fala ou quando a pessoa selecionada tem menos de 1 segundo de fala. É 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/v3' \
  -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": 118
}

Exemplo de resposta quando o gênero é desconhecido

{
  "success": true,
  "gender": "unknown",
  "confidence": 0,
  "message": "Not enough clear speech from a single speaker was detected in the audio, so the gender could not be determined.",
  "remainingRequests": 118
}

Enriquecimento nativo de voz

Insira clipes de voz e enriqueça registros com sinais de gênero, confiança e uso restante.

Ingestão flexível

Envie URLs ou arquivos inline no corpo e faça upload com multipart/form-data quando preferir.

Moderação e confiança

Sinalize anomalias ou incompatibilidades entre gênero declarado e detectado em filas automatizadas.

Construído para escala

Lide com picos graciosamente com processamento elástico e limites de uso transparentes.

Respostas JSON limpas

Campos simples: gender, confidence, remainingRequests, success.

Cobertura de formatos

Suporta codecs e contêineres comuns, de wav e mp3 a ogg, m4a e mais.

Como funciona

Gênero de voz em três etapas.

1

Fornecer áudio

POST para /api com um campo url ou um campo file (base64); multipart/form-data também é suportado para uploads de arquivos.

2

Obter resposta JSON

Receba gender, confidence e remainingRequests em segundos.

3

Escalar quando pronto

Automatize a ingestão para trabalhos em lote ou fluxos IVR inline com as mesmas respostas.

cURL

URL ou file no body
curl -X POST 'https://api.genderrecognition.com/v1/voice-gender-recognition/api' \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{"url": "https://example.com/audio.wav" 
OR
"file": "audio_file"}'

Prefere enviar um arquivo inline? Substitua url por "file":"BASE64_AUDIO_BYTES".

JavaScript

JSON body
const apiKey = "YOUR_API_KEY";
const payload = {
  "url": "https://example.com/audio.wav" 
OR
"file": "audio_file"
};

const response = await fetch(
  "https://api.genderrecognition.com/v1/voice-gender-recognition/api",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      apiKey,
    },
    body: JSON.stringify(payload),
  }
);
const result = await response.json();

Centros de contato

Analise chamadas recebidas ou prompts IVR para enriquecer o roteamento e análises.

Onboarding baseado em voz

Detecte o gênero de prompts gravados para personalizar experiências em tempo real.

Moderação

Automatize verificações em áudio enviado por usuários para fluxos de trabalho de confiança e segurança.

Pronto para começar?

Oferecemos os melhores serviços de reconhecimento de gênero usando tecnologia de IA avançada para garantir precisão e privacidade para todos os usuários

Crie uma conta em minutos para obter sua chave API e acessar sem restrições

Criar uma conta

Uso diário gratuito

Aproveite um nível gratuito generoso todos os dias para testar e explorar nossas APIs

Experimentar API

Preços

Preços simples e transparentes. As primeiras 300 solicitações são gratuitas, depois pague conforme o uso. Consulte nossa página de preços para mais detalhes

Ver preços

Perguntas Frequentes

Inscrever-se

Inscreva-se em nossa newsletter para ficar atualizado sobre as últimas funcionalidades

Ao se inscrever, você aceita nossa política de privacidade e consente em receber as últimas funcionalidades