मुख्य कंटेंट तक स्किप करें

भाषण में भावना पहचान API

अपलोड किए गए ऑडियो में व्यक्त भावना पहचानें। प्रतिक्रिया में विश्वास स्कोर और सभी समर्थित भावनाओं का पूरा विवरण शामिल होता है।

बेस URL​

https://api.genderrecognition.com

समर्थित भावनाएँ​

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

एंडपॉइंट​

POST /v1/speech-emotion/api

हेडर​

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

अनुरोध बॉडी​

फ़ील्डप्रकारज़रूरीविवरण
fileफ़ाइलहाँविश्लेषण के लिए ऑडियो फ़ाइल।

उदाहरण​

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

प्रतिक्रिया​

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

प्रतिक्रिया फ़ील्ड​

फ़ील्डप्रकारविवरण
successबूलियनऑडियो सफलतापूर्वक प्रोसेस होने पर true।
predicted_emotionटेक्स्टऑडियो में पहचानी गई सबसे संभावित भावना।
confidenceपूर्णांकpredicted_emotion का विश्वास प्रतिशत, 0 से 100।
expressionsऑब्जेक्टहर समर्थित भावना का प्रतिशत स्कोर।
remainingRequestsपूर्णांकइस सफल अनुरोध के बाद शेष API अनुरोध।

मान पूर्णांक प्रतिशत हैं, 0 और 1 के बीच दशमलव नहीं।

त्रुटि स्थितियाँ​

API कुंजी मौजूद नहीं है​

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

अमान्य API कुंजी​

{
  "error": "Invalid API key"
}

फ़ाइल मौजूद नहीं है​

{
  "error": "No file uploaded"
}

फ़ाइल बहुत बड़ी है​

{
  "error": "File too large"
}

अमान्य फ़ाइल प्रकार​

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

ऑडियो रूपांतरण विफल हुआ​

यह तब लौटाया जाता है जब फ़ाइल का एक्सटेंशन स्वीकार्य हो, लेकिन ffmpeg उसे बदल न सके (उदाहरण के लिए, फ़ाइल खराब हो या पढ़ी न जा सके):

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

कोटा समाप्त हो गया​

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

प्रोसेसिंग विफल हुई​

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

नोट्स​

  • बैकएंड WAV, MP3, FLAC, MP4, OGG जैसे सामान्य ऑडियो फ़ॉर्मैट स्वीकार करता है, और AIFF स्वीकार करता है तथा विश्लेषण से पहले गैर-WAV फ़ाइलों को बदल देता है।
  • ऑडियो अपलोड के लिए file फ़ील्ड का उपयोग करें; फ़ाइल 10 MB या उससे छोटी होनी चाहिए।
  • प्रेडिक्शन सेवा से सफल प्रतिक्रिया मिलने के बाद ही अनुरोध घटाया जाता है।