V2 · Analyse de l’enregistrement entier
1 requête API par appelV2 vérifie d’abord la présence de parole humaine, puis utilise le modèle vocal ECAPA-TDNN pour analyser l’enregistrement entier. À privilégier pour les enregistrements avec une seule personne. Envoyez un fichier audio dans le champ file d’une requête multipart/form-data.
Pourquoi choisir V2 plutôt que V1 ? L’ancien modèle de V1 renvoie toujours male ou female, même pour du silence, de la musique ou du bruit. V2 détecte la parole et renvoie unknown lorsqu’il n’en trouve pas, au lieu de deviner. Il utilise aussi ECAPA-TDNN, qui modélise les caractéristiques vocales dans le temps ; les comparaisons de voix effectuées côté backend l’ont montré plus précis que le modèle V1. V2 combine les voix d’un même enregistrement : choisissez V3 pour les enregistrements à plusieurs interlocuteurs.
Point de terminaison
POST /v1/voice-gender-recognition/api/v2Les réponses réussies renvoient gender sous la forme male, female ou unknown, confidence en pourcentage et remainingRequests. Si gender vaut unknown, la réponse inclut aussi un message explicatif.
Le résultat est unknown lorsqu’aucune parole humaine n’est détectée. Il s’agit d’une réponse réussie, et non d’une erreur API.
Requête 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'
Exemple de réponse avec un genre détecté
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}Exemple de réponse lorsque le genre est inconnu
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "No clear speech was detected in the audio, so the gender could not be determined.",
"remainingRequests": 119
}