مین مواد پر جائیں

تقریر کے جذبات کی شناخت کی 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

درخواست کا مواد​

فیلڈقسملازمیوضاحت
filefileہاںتجزیے کے لیے آڈیو فائل۔

مثال​

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
}

جوابی فیلڈز​

فیلڈقسموضاحت
successbooleanآڈیو کامیابی سے پراسیس ہونے پر true۔
predicted_emotionstringآڈیو میں شناخت ہونے والا سب سے ممکنہ جذبہ۔
confidenceintegerpredicted_emotion کے اعتماد کا فیصد، 0 سے 100 تک۔
expressionsobjectہر معاون جذبے کا فیصدی اسکور۔
remainingRequestsintegerاس کامیاب درخواست کی کٹوتی کے بعد باقی API درخواستیں۔

قدریں مکمل عددی فیصد ہیں، 0 اور 1 کے درمیان اعشاری اعداد نہیں۔

خرابی کی صورتیں​

API key موجود نہیں​

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

غلط API key​

{
  "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 یا اس سے کم ہونی چاہیے۔
  • درخواست صرف پیش گوئی کی سروس کے کامیاب جواب کے بعد منہا ہوتی ہے۔