স্কিপ করে মূল কন্টেন্ট এ যান

কথার আবেগ শনাক্তকরণ 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 কী নেই​

{
  "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-এর মতো প্রচলিত অডিও ফরম্যাট গ্রহণ করে এবং বিশ্লেষণের আগে non-WAV ফাইল রূপান্তর করে।
  • অডিও আপলোডে file ক্ষেত্র ব্যবহার করুন এবং ফাইলের আকার 10 MB বা কম রাখুন।
  • পূর্বাভাস সেবা সফল উত্তর দেওয়ার পরই একটি অনুরোধের কোটা কাটা হয়।