ভয়েস থেকে লিঙ্গ API
আপলোড করা অডিও অথবা অডিও URL থেকে বক্তার সম্ভাব্য লিঙ্গ শনাক্ত করুন।
মূল URL
https://api.genderrecognition.com
এন্ডপয়েন্ট বেছে নিন
| বিকল্প | পদ্ধতি ও পথ | যে কাজে উপযুক্ত |
|---|---|---|
| মানক ফাইল বিশ্লেষণ | POST /v1/voice-gender-recognition/api | মানক বিশ্লেষণ পদ্ধতিতে ফাইল আপলোড। |
| মানক URL বিশ্লেষণ | POST /v1/voice-gender-recognition/api/url | সর্বজনীন URL-এ থাকা অডিও ফাইল। |
| V2: পুরো রেকর্ডিং বিশ্লেষণ | POST /v1/voice-gender-recognition/api/v2 | এক বক্তার রেকর্ডিংয়ে কথা শনাক্তকরণসহ বিশ্লেষণ। |
| V3: বক্তা-ভিত্তিক বিশ্লেষণ | POST /v1/voice-gender-recognition/api/v3 | কল, সাক্ষাৎকার এবং একাধিক বক্তার রেকর্ডিং। |
মানক URL এন্ডপয়েন্ট JSON-এ অডিও URL গ্রহণ করে। V2 ও V3 শুধু আপলোড করা ফাইল গ্রহণ করে; অডিও URL নয়।
ফাইল এন্ডপয়েন্ট
POST /v1/voice-gender-recognition/api
হেডারসমূহ
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
বডি
| ক্ষেত্র | ধরন | আবশ্যক | বিবরণ |
|---|---|---|---|
file | file | হ্যাঁ | বিশ্লেষণের জন্য অডিও ফাইল। |
উদাহরণ
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
সংস্করণযুক্ত ফাইল এন্ডপয়েন্ট
উপরের মানক ফাইল এন্ডপয়েন্টটি বিদ্যমান ইন্টিগ্রেশনের জন্য চালু থাকবে। V2 ও V3 ফাইল বিশ্লেষণের অতিরিক্ত বিকল্প। উভয়ই multipart file ফিল্ডে একটি অডিও ফাইল গ্রহণ করে, কথা শনাক্ত করে এবং ব্যবহারযোগ্য কথা যথেষ্ট না থাকলে সবসময় পুরুষ বা নারী অনুমান না করে unknown ফেরত দিতে পারে।
V2: পুরো রেকর্ডিং বিশ্লেষণ
POST /v1/voice-gender-recognition/api/v2
V2 প্রথমে মানুষের কথা আছে কি না যাচাই করে, তারপর ECAPA-TDNN ভয়েস মডেল দিয়ে পুরো রেকর্ডিং শ্রেণিবদ্ধ করে। একজন বক্তার রেকর্ডিংয়ের জন্য এটি উপযুক্ত। একাধিক বক্তা থাকলে তাদের কণ্ঠ একসঙ্গে বিশ্লেষণ হয়; নির্দিষ্ট একজন বক্তার ফলের জন্য V3 বেছে নিন।
প্রতি সফল V2 কলে ১টি API অনুরোধ খরচ হয়।
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/v2" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
লিঙ্গ শনাক্ত হলে প্রতিক্রিয়ার উদাহরণ:
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 119
}
মানুষের কথা শনাক্ত না হলেও V2 সফল প্রতিক্রিয়া দেয় এবং gender-এর মান unknown রাখে:
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "No clear speech was detected in the audio, so the gender could not be determined.",
"remainingRequests": 119
}
V3: বক্তা-ভিত্তিক বিশ্লেষণ
POST /v1/voice-gender-recognition/api/v3
V3 কথা শনাক্ত করে এবং নির্বাচিত একজন বক্তাকে শ্রেণিবদ্ধ করতে স্পিকার ডায়ারাইজেশন ব্যবহার করে। এটি কল, সাক্ষাৎকার ও একাধিক বক্তার রেকর্ডিংয়ের জন্য তৈরি। প্রথম বক্তাকে বেছে নেওয়া হয়; তিনি ২ সেকেন্ডের কম কথা বললে সবচেয়ে বেশি সময় কথা বলা বক্তাকে নেওয়া হয়। নির্বাচিত বক্তার কথা ১ সেকেন্ডের কম হলে ফল unknown হয়। V3, V2-এর চেয়ে ধীর এবং কথা শনাক্ত হলে Deepgram-এর পেইড কল করে।
প্রতি সফল V3 কলে ২টি API অনুরোধ খরচ হয়।
curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/v3" \
-H "apiKey: YOUR_API_KEY" \
-F "file=@audio.wav"
লিঙ্গ শনাক্ত হলে প্রতিক্রিয়ার উদাহরণ:
{
"success": true,
"gender": "female",
"confidence": 92,
"remainingRequests": 118
}
কথা না থাকলে বা নির্বাচিত বক্তার কথা খুব কম হলে V3 সফল প্রতিক্রিয়া দেয় এবং gender-এর মান unknown রাখে:
{
"success": true,
"gender": "unknown",
"confidence": 0,
"message": "Not enough clear speech from a single speaker was detected in the audio, so the gender could not be determined.",
"remainingRequests": 118
}
উভয় সংস্করণে confidence হলো ০ থেকে ১০০ পর্যন্ত পূর্ণসংখ্যার শতাংশ, আর remainingRequests হলো খরচ কাটার পরের অবশিষ্ট কোটা। unknown একটি সফল ফল, API ত্রুটি নয়। উভয় সংস্করণে মানক এন্ডপয়েন্টের একই API key, multipart ফিল্ড, ফাইলের আকারসীমা এবং সাধারণ প্রমাণীকরণ ও ফাইল যাচাইয়ের ত্রুটি প্রযোজ্য।
URL এন্ডপয়েন্ট
POST /v1/voice-gender-recognition/api/url
হেডারসমূহ
apiKey: YOUR_API_KEY
Content-Type: application/json
বডি
{
"url": "https://example.com/audio.wav"
}
প্রতিক্রিয়া
ফাইল অনুরোধে পূর্বাভাস, আত্মবিশ্বাসের শতাংশ এবং হালনাগাদ কোটা-তথ্য ফেরত আসে।
{
"success": true,
"gender": "male",
"confidence": 97,
"remainingRequests": 2999
}
URL অনুরোধে পূর্বাভাস ও কোটা-তথ্য ফেরত আসে। প্রথম অনুরোধ ধীর হলে info বার্তাও থাকতে পারে।
{
"success": true,
"gender": "male",
"remainingRequests": 2999
}
ত্রুটির পরিস্থিতি
API কী নেই
{
"error": "API key is required"
}
অবৈধ API কী
{
"error": "Invalid API key"
}
ফাইল নেই
{
"error": "No file uploaded"
}
ফাইলের ধরন অবৈধ
{
"error": "Invalid file type. Only audio formats are allowed"
}
URL অনুরোধ অবৈধ
{
"error": "A valid http or https URL is required"
}
JSON content type নেই
{
"error": "Content-Type header is required. Please set Content-Type: application/json"
}
অসমর্থিত JSON content type
{
"error": "Content-Type must be application/json"
}
কোটা শেষ
{
"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."
}
}
নোট
- ফাইল অনুরোধে multipart form data ব্যবহার হয়।
- URL অনুরোধে JSON ব্যবহার হয়।
- অডিও আপলোডে
fileক্ষেত্র ব্যবহার করুন এবং ফাইলের আকার 10 MB বা কম রাখুন।