Aller au contenu principal

API de reconnaissance des émotions dans la parole

Détectez l’émotion exprimée dans un fichier audio envoyé. La réponse comprend un score de confiance et le détail de toutes les émotions prises en charge.

URL de base​

https://api.genderrecognition.com

Émotions prises en charge​

  • angry
  • disgusted
  • fearful
  • happy
  • neutral
  • other
  • sad
  • surprised

Point de terminaison​

POST /v1/speech-emotion/api

En-têtes​

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

Corps de la requête​

ChampTypeObligatoireDescription
filefileOuiFichier audio à analyser.

Exemple​

curl -X POST "https://api.genderrecognition.com/v1/speech-emotion/api" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@audio.wav"

Réponse​

{
  "success": true,
  "predicted_emotion": "happy",
  "confidence": 87,
  "expressions": {
    "angry": 2,
    "disgusted": 1,
    "fearful": 1,
    "happy": 87,
    "neutral": 6,
    "other": 0,
    "sad": 2,
    "surprised": 1
  },
  "remainingRequests": 2999
}

Champs de la réponse​

ChampTypeDescription
successbooleantrue si le fichier audio a été traité avec succès.
predicted_emotionstringÉmotion la plus probable détectée dans le fichier audio.
confidenceintegerPourcentage de confiance associé à predicted_emotion, de 0 à 100.
expressionsobjectScore en pourcentage pour chaque émotion prise en charge.
remainingRequestsintegerNombre de requêtes API restantes après déduction de cette requête réussie.

Les valeurs sont des pourcentages entiers, et non des nombres décimaux compris entre 0 et 1.

Erreurs possibles​

Clé API manquante​

{
  "error": "API key is required"
}

Clé API invalide​

{
  "error": "Invalid API key"
}

Fichier manquant​

{
  "error": "No file uploaded"
}

Fichier trop volumineux​

{
  "error": "File too large"
}

Type de fichier invalide​

{
  "error": "Invalid file type. Allowed formats: WAV, MP3, FLAC, MP4, OGG, AIFF"
}

Échec de la conversion audio​

Cette erreur est renvoyée lorsque l’extension du fichier est autorisée, mais que ffmpeg ne parvient pas à le convertir (par exemple, s’il est endommagé ou illisible).

{
  "error": "Audio conversion failed: <details>"
}

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."
  }
}

Échec du traitement​

{
  "error": "Speech emotion detection failed"
}

Remarques​

  • Le serveur accepte les formats audio courants tels que WAV, MP3, FLAC, MP4, OGG et AIFF. Les fichiers autres que WAV sont convertis avant l’analyse.
  • Les fichiers audio doivent être envoyés dans le champ file et ne pas dépasser 10 Mo.
  • Une requête n’est déduite qu’après le succès du service de prédiction.