ऑडियो गुणवत्ता जाँच API

अपलोड की गई ऑडियो फ़ाइल की सुनने योग्य गुणवत्ता जाँचें। प्रतिक्रिया में कुल गुणवत्ता स्कोर, भाषण की पहचान, पृष्ठभूमि शोर, आवाज़ का स्तर और क्लिपिंग या विकृति के संकेत होते हैं।

बेस URL

https://api.genderrecognition.com

एंडपॉइंट

POST /v1/audio/quality/api

हेडर

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

अनुरोध बॉडी

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

उदाहरण

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

प्रतिक्रिया

{
  "success": true,
  "quality_score": 82,
  "quality_label": "good",
  "mos_score": 4.1,
  "speech": {
    "detected": true,
    "duration": 4.8,
    "ratio": 92
  },
  "noise": {
    "level": "low",
    "snr_db": 28.4
  },
  "volume": {
    "too_quiet": false,
    "rms_dbfs": -18.2
  },
  "clipping": {
    "detected": false,
    "ratio": 0
  },
  "audio": {
    "duration": 5.2,
    "sample_rate": 44100,
    "channels": 1
  },
  "remainingRequests": 119
}

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

फ़ील्ड	प्रकार	विवरण
success	बूलियन	ऑडियो सफलतापूर्वक प्रोसेस होने पर true।
quality_score	पूर्णांक या null	सुनने योग्य कुल गुणवत्ता, 0-100। भाषण न मिलने पर null।
quality_label	टेक्स्ट या null	quality_score की श्रेणी: excellent, good, fair या poor। quality_score null होने पर null।
mos_score	संख्या या null	अनुमानित Mean Opinion Score, 1-5 (अधिक स्कोर बेहतर)। भाषण न मिलने पर null।
speech.detected	बूलियन	क्या फ़ाइल में कोई भाषण मिला।
speech.duration	संख्या	भाषण के रूप में वर्गीकृत ऑडियो की अवधि, सेकंड में।
speech.ratio	पूर्णांक	फ़ाइल में भाषण का प्रतिशत, 0-100।
noise.level	टेक्स्ट या null	पृष्ठभूमि शोर की श्रेणी: low, medium या high। मापा न जा सके तो null (जैसे तुलना के लिए बिना भाषण वाला ऑडियो न हो)।
noise.snr_db	संख्या या null	भाषण और पृष्ठभूमि शोर के बीच सिग्नल-टू-नॉइज़ अनुपात, dB में। noise.level वाली स्थितियों में null।
volume.too_quiet	बूलियन	ऑडियो भरोसेमंद उपयोग के लिए बहुत धीमा हो तो true।
volume.rms_dbfs	संख्या	dBFS में आवाज़ का स्तर। 0 सबसे तेज़ स्तर है; अधिक ऋणात्मक मान धीमी आवाज़ दर्शाते हैं।
clipping.detected	बूलियन	क्लिपिंग या विकृति मिलने पर true।
clipping.ratio	पूर्णांक	क्लिपिंग से प्रभावित ऑडियो नमूनों का प्रतिशत, 0-100।
audio.duration	संख्या	अपलोड की गई फ़ाइल की अवधि, सेकंड में।
audio.sample_rate	संख्या	अपलोड किए गए ऑडियो का सैंपल रेट, Hz में।
audio.channels	संख्या	ऑडियो चैनलों की संख्या (1 = मोनो, 2 = स्टीरियो)।
remainingRequests	पूर्णांक	इस सफल अनुरोध के बाद शेष API अनुरोध।

quality_score, speech.ratio और clipping.ratio पूर्णांक प्रतिशत हैं। noise.snr_db और volume.rms_dbfs डेसिबल में मान हैं, प्रतिशत नहीं।

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

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

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

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

{ "error": "Invalid API key" }

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

{ "error": "No file uploaded" }

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

{ "error": "File too large" }

अप्रत्याशित फ़ील्ड

यह तब लौटाया जाता है जब फ़ाइल file के बजाय किसी अन्य फ़ील्ड नाम से अपलोड हो (उदाहरण के लिए, अतिरिक्त फ़ाइल भेजने पर):

{ "error": "Unexpected field" }

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

{
  "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": "Audio quality assessment failed" }

नोट्स

• बैकएंड WAV, MP3, M4A सहित कई सामान्य ऑडियो फ़ॉर्मैट स्वीकार करता है, FLAC, OGG, WebM, AAC, Opus, WMA, AMR, 3GP, AIFF, AU और अन्य फ़ॉर्मैट; विश्लेषण से पहले वह गैर-WAV फ़ाइलों को बदल देता है।
• ऑडियो अपलोड के लिए file फ़ील्ड का उपयोग करें; फ़ाइल 10 MB या उससे छोटी होनी चाहिए।
• गुणवत्ता जाँच सफलतापूर्वक पूरी होने के बाद ही अनुरोध घटाया जाता है।