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

वक्ता सत्यापन API

रेफ़रेंस और उम्मीदवार ऑडियो क्लिप की तुलना करके जानें कि वे एक ही वक्ता के हैं या नहीं। दोनों फ़ाइलों का समानता स्कोर और ऑडियो मेटाडेटा भी पाएँ।

बेस URL​

https://api.genderrecognition.com

एंडपॉइंट​

POST /v1/speaker-verification/api

हेडर​

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

अनुरोध बॉडी​

फ़ील्डप्रकारज़रूरीविवरण
referenceफ़ाइलहाँसत्यापन के लिए ज्ञात वक्ता की आवाज़।
candidateफ़ाइलहाँवह आवाज़ जिसकी रेफ़रेंस से तुलना करनी है।

उदाहरण​

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

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

{
  "success": true,
  "same_speaker": true,
  "similarity": 87,
  "threshold": 70,
  "reference_audio": {
    "duration": 4.8,
    "sample_rate": 16000
  },
  "candidate_audio": {
    "duration": 5.1,
    "sample_rate": 16000
  },
  "remainingRequests": 119
}

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

फ़ील्डप्रकारविवरण
successबूलियनदोनों क्लिप सफलतापूर्वक प्रोसेस होने पर true।
same_speakerबूलियनsimilarity, threshold के बराबर या अधिक होने पर true; दोनों क्लिप एक ही वक्ता की मानी जाती हैं।
similarityपूर्णांकदोनों आवाज़ों के मेल का स्तर, 0-100। अधिक मान का अर्थ अधिक समानता है।
thresholdपूर्णांकsame_speaker तय करने की सीमा, 0-100। इसके बराबर या अधिक similarity को मेल माना जाता है।
reference_audio.durationसंख्यातुलना के लिए डिकोड की गई रेफ़रेंस क्लिप की अवधि, सेकंड में।
reference_audio.sample_rateसंख्यातुलना से पहले रेफ़रेंस क्लिप को जिस सैंपल रेट (Hz) में डिकोड किया गया।
candidate_audio.durationसंख्यातुलना के लिए डिकोड की गई उम्मीदवार क्लिप की अवधि, सेकंड में।
candidate_audio.sample_rateसंख्यातुलना से पहले उम्मीदवार क्लिप को जिस सैंपल रेट (Hz) में डिकोड किया गया।
remainingRequestsपूर्णांकइस सफल अनुरोध के बाद शेष API अनुरोध।

similarity और threshold पूर्णांक प्रतिशत हैं, कच्चे स्कोर नहीं।

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

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

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

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

{ "error": "Invalid API key" }

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

{ "error": "Both reference and candidate files are required" }

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

{ "error": "File too large" }

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

यह तब लौटाया जाता है जब फ़ाइल reference या candidate के बजाय किसी अन्य फ़ील्ड से अपलोड हो (उदाहरण के लिए 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": "Speaker verification failed" }

नोट्स​

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