API de détection du genre par la voix
Détectez le genre probable d’une personne à partir d’un fichier audio envoyé ou d’une URL audio.
URL de base
https://api.genderrecognition.com
Choisir un point de terminaison
| Option | Méthode et chemin | Utilisation recommandée |
|---|---|---|
| Analyse standard par fichier | POST /v1/voice-gender-recognition/api | Analyse simple d’un fichier avec le comportement standard. |
| Analyse standard par URL | POST /v1/voice-gender-recognition/api/url | Fichier audio accessible à une URL publique. |
| V2 : analyse de tout l’enregistrement | POST /v1/voice-gender-recognition/api/v2 | Analyse avec détection de la parole pour un enregistrement à un seul locuteur. |
| V3 : analyse par locuteur | POST /v1/voice-gender-recognition/api/v3 | Appels, entretiens et autres enregistrements à plusieurs locuteurs. |
Le point de terminaison standard par URL accepte une URL audio au format JSON. V2 et V3 acceptent uniquement des fichiers téléversés, pas des URL audio.
Point de terminaison pour fichier
POST /v1/voice-gender-recognition/api
En-têtes
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
file | file | Oui | Fichier audio à analyser. |
Exemple
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
Points de terminaison de fichiers avec versions
Le point de terminaison standard par fichier ci-dessus reste disponible pour les intégrations existantes. V2 et V3 offrent d’autres options d’analyse de fichiers. Elles acceptent un fichier audio dans le champ multipart file, détectent la parole et peuvent renvoyer unknown lorsqu’il n’y a pas assez de parole exploitable, au lieu de toujours deviner homme ou femme.
V2 : analyse de tout l’enregistrement
POST /v1/voice-gender-recognition/api/v2
V2 détecte la présence de parole humaine, puis classe l’enregistrement complet avec le modèle vocal ECAPA-TDNN. Cette version convient aux enregistrements avec un seul locuteur. Si plusieurs personnes parlent, leurs voix sont analysées ensemble ; choisissez V3 pour obtenir un résultat ciblé sur un locuteur.
Chaque appel V2 réussi consomme 1 requête API.
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/v2" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
Exemple de réponse lorsqu’un genre est détecté :
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}
Sans parole humaine détectée, V2 renvoie tout de même une réponse réussie avec gender défini sur unknown :
{
"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 : analyse par locuteur
POST /v1/voice-gender-recognition/api/v3
V3 détecte la parole et utilise la diarisation pour classer un locuteur sélectionné. Elle convient aux appels, entretiens et autres enregistrements à plusieurs locuteurs. Le premier locuteur est sélectionné, sauf s’il parle moins de 2 secondes ; dans ce cas, le locuteur ayant parlé le plus longtemps est choisi. Si le locuteur sélectionné a moins d’une seconde de parole, le résultat est unknown. V3 est plus lente que V2 et effectue un appel Deepgram payant lorsque de la parole est détectée.
Chaque appel V3 réussi consomme 2 requêtes API.
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/v3" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
Exemple de réponse lorsqu’un genre est détecté :
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 118
}
Si la parole est absente ou trop courte pour le locuteur sélectionné, V3 renvoie une réponse réussie avec gender défini sur unknown :
{
"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
}
Pour les deux versions, confidence est un pourcentage entier de 0 à 100 et remainingRequests indique le solde après déduction. Un résultat unknown est une prédiction réussie, pas une erreur API. Les deux versions utilisent la même clé API, le même champ multipart, la même limite de taille et les mêmes erreurs d’authentification et de validation de fichier que le point de terminaison standard.
Point de terminaison pour URL
POST /v1/voice-gender-recognition/api/url
En-têtes
apiKey: YOUR_API_KEY
Content-Type: application/json
Corps de la requête
{
"url": "https://example.com/audio.wav"
}
Réponse
Les requêtes avec fichier renvoient la prédiction, le niveau de confiance en pourcentage et les informations actualisées sur le quota.
{
"success": true,
"gender": "male",
"confidence": 97,
"remainingRequests": 2999
}
Les requêtes avec URL renvoient la prédiction et les informations sur le quota.
Les premières requêtes lentes peuvent également inclure un message info.
{
"success": true,
"gender": "male",
"remainingRequests": 2999
}
Erreurs possibles
Clé API manquante
{
"error": "API key is required"
}
Clé API invalide
{
"error": "Invalid API key"
}
Fichier manquant
{
"error": "No file uploaded"
}
Type de fichier invalide
{
"error": "Invalid file type. Only audio formats are allowed"
}
Requête URL invalide
{
"error": "A valid http or https URL is required"
}
En-tête de type de contenu JSON manquant
{
"error": "Content-Type header is required. Please set Content-Type: application/json"
}
Type de contenu JSON non pris en charge
{
"error": "Content-Type must be application/json"
}
Quota dépassé
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "You have exceeded your free tier limit of 50 requests.",
"detailedMessage": "Insufficient remaining requests. Required: 1, Available: 0",
"details": {
"limit": 50,
"used": 50,
"reset_date": "2026-07-01T00:00:00.000Z"
},
"suggested_action": "Please upgrade to a premium plan to continue using the API."
}
}
Remarques
- Les requêtes avec fichier utilisent le format multipart.
- Les requêtes avec URL utilisent JSON.
- Les fichiers audio doivent être envoyés dans le champ
fileet ne pas dépasser 10 Mo.